É comum que você use um sistema de terceiros para armazenar dados sobre o evento (registro, compra, depósito etc.) que ocorre no aplicativo. Esses eventos não são rastreados automaticamente pelo MMP, pois ele rastreia o canal de onde os usuários vêm. Todos os eventos que os usuários fazem são rastreados no seu sistema.
Para enviar os eventos para o Affise MMP e para os serviços com os quais o MMP se integrou (Facebook, por exemplo, para otimizar campanhas publicitárias), use o guia abaixo.
Lógica de envio de eventos
Os eventos devem ser enviados com o ID do evento para o Affise MMP para registrá-los posteriormente no sistema.
Método de envio de eventos
Você precisa de uma chave de API da seção de acesso à API para enviar a solicitação abaixo:
curl --request POST \
--header 'Authorization: Bearer <API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": "3d973489-e784-4f5d-8e51-9bee0ac16b00",
"random_user_id": "7ea344d0-643d-4670-8e57-e3b9ecb53a00",
"event" (evento): {
"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",
"affise_event_name": "CustomId03",
"affise_event_timestamp": 1688046085325,
"affise_event_first_for_user": true,
"affise_event_user_data": "any_string",
"affise_event_data": {
"affise_event_custom_id_03": "any_name",
"affise_event_custom_id_{03}_timestamp": 1688046085325
}
}
}'
where:
affise_device_id & random_user_id - identificadores de dispositivos.
affise_event_id - novo uuid para cada evento.
affise_event_name - veja os valores válidos em outra documentação, por exemplo, AddToCart Purchase.
affise_event_timestamp - registro de data e hora do evento de envio (milissegundos ou segundos).
affise_event_first_for_user - padrão false.
affise_event_user_data - qualquer dado do usuário como string.
affise_event_data - opcional e depende de affise_event_name.
Funciona minimamente:
curl --request POST \
--header 'Authorization: Bearer <API-KEY>' \
--data '{
"affise_device_id": "3d973489-e784-4f5d-8e51-9bee0ac16b00",
"event": {
"affise_event_name": "CustomId03"
}
}'
curl --request GET \
--header 'Authorization: Bearer <API-KEY>'
Se um usuário optar por não compartilhar GAID com base na política do Google, ou se você não puder passar affse_device_id
ou affise_random_id
, poderá passar gaid_adid
ou adid
como identificadores de usuário exclusivos.
Por exemplo:
curl --request POST \
--header 'Authorization: Bearer <API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"gaid_adid": "39ae1572-055b-41c9-ba50-87d9e45f47d9",
"event": {
"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",
"affise_event_name": "CustomId07",
"affise_event_timestamp": 1688046085325,
"affise_event_first_for_user": true,
"affise_event_user_data": "any_string",
"affise_event_data": {
"affise_event_custom_id_07": "any_name"
}
}
}'
ou
curl --request POST \
--header 'Authorization: Bearer <API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"adid": "D8CA4CF9-B475-4FA1-ADEB-8921D2431756",
"event": {
"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",
"affise_event_name": "StartTrial",
"affise_event_timestamp": 1688046085325,
"affise_event_first_for_user": true
}
}'
Exemplos de eventos
Evento de compra
adid e gaid_adid devem ser definidos anteriormente na instalação para entregar eventos corretamente ao Facebook (Meta), Google Ads (UAC), TikTok
Evento máximo
curl --request POST \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": "eb4cfa97-5266-4dea-b807-6a345c3ab900",
"random_user_id": "bd1f6259-3521-45dc-ac48-651b649c1598",
"gaid_adid": "GAID",
"adid": "IDFA",
"event" (evento): {
"affise_event_name": "Purchase" (Compra),
"affise_event_timestamp": 1688046085325,
"affise_parameters": {
"affise_p_content_ids": [123, 789],
"affise_p_content_id": "name",
"affise_p_content_type": "type",
"affise_p_content_list": [{"key": "name"}, {"value": "value"}],
"affise_p_currency": "USD",
"affise_p_quantity": 6,
"affise_p_price": 0.05,
"affise_p_revenue": 0.3
}
}
}'
Evento mínimo
curl --request POST \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": "eb4cfa97-5266-4dea-b807-6a345c3ab900",
"event": {
"affise_event_name": "Purchase" (Compra),
"affise_parameters": {
"affise_p_currency": "USD",
"affise_p_quantity": 6,
"affise_p_price": 0.05,
"affise_p_revenue": 0.3
}
}
}'
Evento com ID de conversão
curl --request POST \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": “eb4cfa97-5266-4dea-b807-6a345c3ab900",
"event": {
"affise_event_name": "Loan" (Empréstimo),
"affise_parameters": {
"affise_p_conversion_id": "123",
"affise_p_customer_type": ---,
"affise_p_customer_user_id": ---
}
}
}'
Use as macros correspondentes no postback do parceiro:
{p_conversion_id}
{p_customer_type}
{p_customer_user_id}
Entre em contato com a equipe de Suporte ao Cliente da Affise sobre todas as questões levantadas por meio do e-mail: [email protected].