Часто бывает, что для хранения данных о событиях (регистрация, покупка, депозит и т. д.), происходящих в приложении, используется сторонняя система. Эти события не отслеживаются MMP автоматически, поскольку он отслеживает канал, из которого приходят пользователи. Все события, которые совершают пользователи, отслеживаются в вашей системе.
Чтобы отправить события в Affise MMP и в сервисы, с которыми интегрирован MMP (например, Facebook для оптимизации рекламных кампаний), воспользуйтесь приведенным ниже руководством.
Логика отправки событий
События должны быть отправлены с идентификатором события в Affise MMP для дальнейшей регистрации в системе.
Метод отправки событий
Для отправки запроса, приведенного ниже, вам понадобится API-ключ из раздела " Доступ к API ":
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": {
"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
}
}
}'
где:
affise_device_id & random_user_id - идентификаторы устройств.
affise_event_id - uuid, новый для каждого события.
affise_event_name - см. допустимые значения в другой документации, например AddToCart Purchase.
affise_event_timestamp - временная метка отправки события (миллисекунды или секунды).
affise_event_first_for_user - по умолчанию false.
affise_event_user_data - любые данные пользователя в виде строки.
affise_event_data - опционально и зависит от affise_event_name.
Минимальный вариант:
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>'
🔎 Если пользователь отказывается от передачи GAID в соответствии с политикой Google, или вы не можете передать affse_device_id или affise_random_id, вы можете передать gaid_adid или adid в качестве уникальных идентификаторов пользователя.
Например:
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".
}
}
}'
или
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
}
}'
Примеры событий
Событие покупки
🔎 adid и gaid_adid должны быть определены ранее в установке для корректной доставки событий в Facebook (Meta), Google Ads (UAC), TikTok
Максимальное событие
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": "Покупка",
"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
}
}
}'
Минимальное событие
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": "Покупка",
"affise_parameters": {
"affise_p_currency": "USD",
"affise_p_quantity": 6,
"affise_p_price": 0.05,
"affise_p_revenue": 0.3
}
}
}'
Событие с идентификатором преобразования
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": "Кредит",
"affise_parameters": {
"affise_p_conversion_id": "123",
"affise_p_customer_type": ---,
"affise_p_customer_user_id": ---.
}
}
}'
🔎 Используйте соответствующие макросы в партнерском постбеке:
{p_conversion_id}
{p_customer_type}
{p_customer_user_id}
По всем возникающим вопросам обращайтесь в службу поддержки клиентов Affise по электронной почте: [email protected].