Es un caso común que utilices un sistema de terceros para almacenar datos sobre el evento (registro, compra, depósito, etc.) que ocurre dentro de la aplicación. Estos eventos no son rastreados automáticamente por el MMP, ya que éste rastrea el canal de donde provienen los usuarios. Todos los eventos que realizan los usuarios se rastrean en su sistema.
Para enviar los eventos al MMP de Affise y a los servicios con los que el MMP está integrado (Facebook, por ejemplo, para optimizar las campañas publicitarias), utilice la siguiente guía.
Lógica deenvío de eventos
Los eventos deben enviarse con el ID del evento a Affise MMP para su posterior registro en el sistema.
Método de envío de eventos
Necesita una clave API de la sección de acceso a la API para enviar la siguiente solicitud:
curl --request POST \
--header 'Autorización: 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": {
"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
}
}
}'
donde:
affise_device_id & random_user_id - identificadores de dispositivo.
affise_event_id - uuid nuevo para cada evento.
affise_event_name - ver valores válidos en otra documentación, por ejemplo AddToCart Purchase.
affise_event_timestamp - marca de tiempo de envío del evento (milisegundos o segundos).
affise_event_first_for_user - por defecto false.
affise_event_user_data - cualquier dato del usuario como cadena.
affise_event_data - opcional y depende de affise_event_name.
funciona mínimamente:
curl --request POST \
--header 'Autorización: Bearer <API-KEY>' \
--data '{
"affise_device_id": "3d973489-e784-4f5d-8e51-9bee0ac16b00",
"evento": {
"affise_event_name": "CustomId03"
}
}'
curl --request GET \
--header 'Autorización: Portador <API-KEY>'
🔎 Si un usuario opta por no compartir GAID según la política de Google, o no puedes pasar affse_device_id
o affise_random_id
, puedes pasar gaid_adid
o adid
como identificadores únicos de usuario.
Por ejemplo
curl --request POST \
--header 'Autorización: Bearer <API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"gaid_adid": "39ae1572-055b-41c9-ba50-87d9e45f47d9",
"evento": {
"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"
}
}
}'
o
curl --request POST \
--header 'Autorización: Bearer <API-KEY>' --header
--header 'Content-Type: application/json' \
--data '{
"adid": "D8CA4CF9-B475-4FA1-ADEB-8921D2431756",
"evento": {
"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",
"affise_event_name": "StartTrial",
"affise_event_timestamp": 1688046085325,
"affise_event_first_for_user": true
}
}'
Ejemplos de eventos
Evento de compra
🔎 adid y gaid_adid deben definirse antes en la instalación para enviar correctamente los eventos a Facebook (Meta), Google Ads (UAC), TikTok
Evento Max
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": {
"affise_event_name": "Purchase",
"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": [{"clave": "nombre"}, {"valor": "valor"}],
"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 'Autorización: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": "eb4cfa97-5266-4dea-b807-6a345c3ab900",
"evento": {
"affise_event_name": "Purchase",
"affise_parameters": {
"affise_p_currency": "USD",
"affise_p_quantity": 6,
"affise_p_price": 0.05,
"affise_p_revenue": 0.3
}
}
}'
Evento con ID de conversión
curl --request POST \
--header 'Autorización: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"affise_device_id": “eb4cfa97-5266-4dea-b807-6a345c3ab900",
"evento": {
"affise_event_name": "Préstamo",
"affise_parameters": {
"affise_p_conversion_id": "123",
"affise_p_customer_type": ---,
"affise_p_customer_user_id": ---
}
}
}'
🔎 Utiliza las macros correspondientes en el postback del socio:
{p_conversion_id}
{p_customer_type}
{p_customer_user_id}
Por favor, póngase en contacto con el equipo de Atención al Cliente de Affise en relación con todas las preguntas planteadas a través del correo electrónico: [email protected].