Ir al contenido principal
Todas las colecciones
Envío de eventos a Affise MMP (S2S)
Envío de eventos a Affise MMP (S2S)
Natalya Yefimenko avatar
Escrito por Natalya Yefimenko
Actualizado hace más de 7 meses

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

¿Ha quedado contestada tu pregunta?