Il est fréquent que vous utilisiez un système tiers pour stocker les données relatives à l'événement (inscription, achat, dépôt, etc.) qui se produit dans l'application. Ces événements ne sont pas automatiquement suivis par le MMP, puisqu'il suit le canal d'où proviennent les utilisateurs. Tous les événements réalisés par les utilisateurs sont suivis dans votre système.
Pour envoyer les événements à Affise MMP et aux services que la MMP a intégrés (Facebook, par exemple, pour optimiser les campagnes publicitaires), utilisez le guide ci-dessous.
Logique d'envoi des événements
Les événements doivent être envoyés avec l'ID de l'événement à Affise MMP pour être enregistrés dans le système.
Méthode d'envoi des événements
Vous avez besoin d'une clé API à partir de la section d'accès à l'API pour envoyer la requête ci-dessous :
curl --request POST \N
--header 'Authorization : Bearer <API-KEY>' \N-header 'Content-Type : application/world'.
--header 'Content-Type : application/json' \N--Content-Type : application/json' \N--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
}
}
}'
où :
affise_device_id & random_user_id - identifiants de l'appareil.
affise_event_id - uuid nouveau pour chaque événement.
affise_event_name - voir les valeurs valides dans d'autres documents, par exemple AddToCart Purchase.
affise_event_timestamp - horodatage de l'événement envoyé (millisec ou sec).
affise_event_first_for_user - valeur par défaut : false.
affise_event_user_data - toutes les données de l'utilisateur sous forme de chaîne.
affise_event_data - optionnel et dépend de affise_event_name.
Fonctionnement minimal :
curl --request POST \N
--header 'Autorisation : Bearer <API-KEY>' \N- -data '{compatible}'.
--data '{
"affise_device_id" : "3d973489-e784-4f5d-8e51-9bee0ac16b00",
"event" : {
"affise_event_name" : "CustomId03"
}
}'
curl --request GET \N
--header 'Authorization : Bearer <API-KEY>'
🔎 Si un utilisateur choisit de ne pas partager le GAID conformément aux règles de Google, ou si vous ne pouvez pas passer affse_device_id
ou affise_random_id
, vous pouvez passer gaid_adid
ou adid
en tant qu'identifiants uniques de l'utilisateur.
Par exemple, vous pouvez passer gaid_adid ou adid comme identifiants uniques de l'utilisateur :
curl --request POST \N-URL
--header 'Authorization : Bearer <API-KEY>' \N-header 'Content-Type : \N
--header 'Content-Type : application/json' \N--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 \N ---url \N
--header 'Authorization : Bearer <API-KEY>' \N-header 'Content-Type : application/json' \N
--header 'Content-Type : application/json' \N--Content-Type : application/json' \N--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
}
}'
Exemples d'événements
Événement d'achat
🔎 adid et gaid_adid doivent être définis plus tôt dans l'installation pour que les événements soient transmis correctement à Facebook (Meta), Google Ads (UAC), TikTok.
Événement Max
curl --request POST \N
--header 'Authorization : Bearer <api-key>' \N-header 'Content-Type : application/json' \N
--header 'Content-Type : application/json' \N--Content-Type : application/json' \N--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" : "Achat",
"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
}
}
}'
Événement Min
curl --request POST \N-url
--header 'Authorization : Bearer <api-key>' \N-header 'Content-Type : application/json' \N
--header 'Content-Type : application/json' \N--Content-Type : application/json' \N--Content-Type : application/json
--data '{
"affise_device_id" : "eb4cfa97-5266-4dea-b807-6a345c3ab900",
"event" : {
"affise_event_name" : "Achat",
"affise_parameters" : {
"affise_p_currency" : "USD",
"affise_p_quantity" : 6,
"affise_p_price" : 0.05,
"affise_p_revenue" : 0.3
}
}
}'
Événement avec ID de conversion
curl --request POST \N
--header 'Authorization : Bearer <api-key>' \N-header 'Content-Type : application/json' \N
--header 'Content-Type : application/json' \N--Content-Type : application/json' \N--Content-Type : application/json
--data '{
"affise_device_id" : “eb4cfa97-5266-4dea-b807-6a345c3ab900",
"event" : {
"affise_event_name" : "Prêt",
"affise_parameters" : {
"affise_p_conversion_id" : "123",
"affise_p_customer_type" : ---,
"affise_p_customer_user_id" : ---
}
}
}'
🔎 Utiliser les macros correspondantes dans le postback du partenaire :
{p_conversion_id}
{p_customer_type}
{p_customer_user_id}
Veuillez contacter l'équipe de support client d'Affise pour toutes les questions soulevées via l'e-mail : [email protected].