Passar para o conteúdo principal
Todas as coleções
Envio de eventos para o Affise MMP (S2S)
Envio de eventos para o Affise MMP (S2S)
Natalya Yefimenko avatar
Escrito por Natalya Yefimenko
Atualizado há mais de 7 meses

É 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].

Respondeu à sua pergunta?