API межсерверных событий для мобильных устройств (мобильный S2S)

• В параметры полезных данных входят один или несколько идентификаторов устройств (в зависимости от ОС).
• Что делать, если я не могу отправить идентификатор устройства?
  • You may be unable to send the identifier for a reason out of your control, for example, because the user has limited ad tracking (LAT) or uses iOS 14, and did not give ATT consent. If IDFV is available send it. 
  • Not sending an advertising ID/device identifier can cause:
    • Postback issues: The media source will receive the postback but without a device identifier; consequently the media source can't associate it with a user. 
    • Ошибка сегментации аудиторий и применения правил. Для корректной работы наборов правил необходимы идентификаторы. Отправьте идентификатор устройства или идентификатор клиента, в зависимости от типа идентификатора, который используется в вашем наборе правил.

"custom_data" : {"name_a" : { 
"name_a1" : "value a1", 
"name_a2" : "value a2" 
},
"name_b" : "value b"
}

curl --location --request POST 'https://api2.appsflyer.com/inappevent/<app_id_placeholder>' \
--header 'authentication: <dev_key_placeholder>
' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appsflyer_id": "9999999999999-9999999999999999999",
	"advertising_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
	"customer_user_id" : "example_customer_id_123",
	"ip": "199.0.2.1",
	"app_version_name" : "example_version_name",
	"eventTime" : "2020-02-25 12:00.000",
	"eventName": "af_purchase",
	"eventCurrency": "ZAR",
	"eventValue": 
	"{
		\"af_revenue\": \"1006\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }"
}
'

Рассмотрим:

• Для тестирования используйте идентификатор AppsFlyer для неорганической установки, чтобы тестировать атрибуты событий в реальном времени. Органические события атрибутируются с задержкой в несколько часов.
• Некоторые поля события заполняются с использованием события атрибуции установки пользователем. Например, время установки и медиа-источник. 

Чтобы атрибутировать тестовое устройство как неорганическую установку:

1. Prepare a custom attribution link for testing S2S messages. Set the media source parameter on the link as to s2s_test and set advertising id (GAID, IDFA, etc) on the link as illustrated in the example attribution link snippets. 
2. Регистрация тестового устройства
3. Удалите приложение с тестового устройства.
4. Отправьте ссылку на тестовое устройство.
5. Щелкните ссылку.
6. Установите и запустите приложение.
7. На дэшборде проверьте, что установка атрибутирована.
8. Получите AppsFlyer ID для использования в вашем сообщении S2S.

Чтобы отправить тестовое сообщение S2S:

1. Подготовьте сообщение S2S, используя назначенный идентификатор AppsFlyer. См. ниже примеры кода.
2. Отправьте сообщение.
3. Выполните одно из следующих действий, чтобы увидеть, как сообщение записывается в AppsFlyer:
   • Загрузите отчетсырых данных о внутренних событиях приложения. После отправки события, данные о нем появятся в отчете сырых данных через 15 минут. 
   • Push API (рассмотрите возможность использования таких инструментов, как Postman и Webhook).
4. Проверьте и просмотрите, что:
   • Значения, отправленные в сообщении S2S, правильно заполняют отчет. Обратите особое внимание на поля «Дата события», «Валюта события», «Доход от события» и «Значение события».
   • Источник атрибуции и время установки заполняются AppsFlyer.
   • Значения, предоставляемые самим SDK, такие как версия SDK, не заполняются.

Android;

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&advertising_id=<GAID>

iOS.

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&idfa=<IDFA>

• Рекламный идентификатор / идентификатор устройства является обязательным для отправки постбэков в сети SRN, такие как Facebook и Google Ads. Если вы не можете отправить идентификатор, примите во внимание, что нельзя отправлять постбэки.
• Если вы отправите только идентификатор AppsFlyer, внутренние события приложения будут записываться и атрибутироваться правильно.

Когда AppsFlyer обрабатывает события S2S в приложении, поля атрибуции заполняются с помощью идентификатора AppsFlyer, чтобы определить соответствующее событие установки, которое предшествовало событиям в приложении.

Это означает, что некоторые данные, которые AppsFlyer связывает с неорганическими S2S-событиями, не будут связаны с органическими S2S-событиями в приложении.

Логическая схема на стороне сервера необходима для того, чтобы получить определенные значения для указанного параметра. Ниже описано, как вы можете получить идентификатор AppsFlyer:

• Идентификатор AppsFlyer является обязательным и используется для атрибуции событий.
• Он генерируется, когда пользователь впервые устанавливает мобильное приложение.
• Чтобы вы могли сопоставить свой CUID с идентификатором AppsFlyer, вам нужно установить CUID в приложении. 

Простой способ сопоставления пользователей с выполненными ими событиями приведен ниже.

• Задайте идентификатор клиента при установке приложения пользователем.
• Отчеты по сырым данным AppsFlyer содержат CUID и идентификатор AppsFlyer. Используйте один из инструментов доставки данных или AppsFlyer Push API. 
• Используйте отчеты о сырых данных, чтобы сопоставить CUID с идентификатором AppsFlyer. 
• Идентификаторы AppsFlyer можно получить с помощью SDK AppsFlyer, интегрированных в ваши приложения (Android / IOS).
• Сопоставьте идентификатор AppsFlyer с идентификатором клиента во внутренних системах (важно для использования в будущем).

Сопоставив идентификатор AppsFlyer с CUID, вы можете определить пользователя, выполнившего события. Затем вы сможете получить другие значения (значение события, валюту события, время события и т.д.) и отправить внутреннее событие приложения от сервера к серверу.

{
  "appsflyer_id": "1415211453000-6513894",
	"advertising_id": "38412345-8cf0-aa78-b23e-10b96e40000d",
	"eventName": "af_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	"ip": "1.2.3.4",
	"eventTime": "2014-05-15 12:17:00.000"
}

В сообщениях межсерверных событий параметр appsflyer_id является обязательным. AppsFlyer использует данный параметр для атрибуции события исходному устройству и атрибутированному медиа-источнику.  Вы можете получить ID одним из следующих способов:

• С мобильного устройства с помощью вызова AppsFlyer SDK API: Android, iOS
• От платформы AppsFlyer с использованием одного из следующих способов: Pull API, Push API, Экспорт отчета по сырым данным об установках  

События с отрицательным значением дохода могут быть отправлены. Например, если покупка была отменена. Параметр af_revenue может иметь отрицательные значения для записи этого события.

Если вы заполняете af_quantity, возможно, вы захотите заполнить его отрицательным значением в зависимости от логики вашей системы. AppsFlyer не использует af_quantity.

Примеры данных об отрицательной выручке

{
	"eventName": "cancel_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"-6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	
}

Если нужно отправить событие без значения события, просто передайте в качестве значения события пустую строку: "event_value":""

Теперь AppsFlyer может отправлять подобные rich in-app события медиа источникам для улучшения таргетинга, оптимизации и создания аудитории соответственно настройкам рекламодателя.

• Конечная точка: убедитесь, что используемая конечная точка верна.
• Убедитесь, что полезные данные содержат обязательные параметры. См. здесь.
• Убедитесь, что AppsFlyer ID, используемый для запуска события, является действительным идентификатором appsflyer_id, который установлен в конкретном приложении. Что это не тестовый идентификатор, представленный в документации. См. здесь.
• Для S2S-событий групповая отправка событий в одном запросе S2S не поддерживается. Каждое событие необходимо отправлять отдельно. 
• На обзорном дэшборде диапазон дат относится к дате установки приложения (LTV), а не к дате события.
  • Убедитесь, что вы ввели правильный диапазон дат.
  • Убедитесь, что диапазон дат на дэшборде соответствует дате установки устройства (appsflyer_id), а не дате события.
• Отчет по сырым данным о событиях: диапазон дат относится к дате события, а не дате установки. 

Если после отправки S2S-событий окажется, что данные о доходе не записаны, убедитесь, что отправленные данные в формате JSON преобразованы в строки. Самое важное — это значение параметра события в формате JSON. Он должен быть преобразован в строку, как показано на следующем примере.

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

Если значение события не преобразовано в строку, оно обрабатывается неправильно и величина дохода не записывается.

Значения дохода не должны быть отформатированы каким-либо образом. Они могут содержать десятичный разделитель, но это не обязательно. Не используйте знаки/коды валют или разделители ,. Доход может иметь префикс -

• Пример допустимых значений: 123 , -123.45 , 123.456 
• Примеры недопустимых значений: 1,234.56, 1,234

Поля сырых данных заполняются с использованием значения, отправленного в вызове S2S, а некоторые поля заполняются с помощью события установки.  Аналогичное поведение, но не идентичное, наблюдается для событий в приложении, сообщаемых с помощью AppsFlyer SDK. Существуют некоторые различия, в частности, следующие поля не заполняются для событий S2S:

• wifi
• operator
• language
• Тип устройства
• Категория устройства
• Версия приложения: используйте app_version_name.
• Имя приложения