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

• В параметры полезных данных входят один или несколько идентификаторов устройств (в зависимости от ОС).
• Что делать, если я не могу отправить идентификатор устройства?
  • Иногда нельзя отправить идентификатор по не зависящим от вас обстоятельствам. Например, потому что пользователь ограничил отслеживание рекламы (LAT) или использует iOS 14 и не дал согласие на ATT (не предоставляет данные IDFA).
  • В таком случае вам нужно учесть, что если не  отправлять идентификатор рекламы/устройства, то может возникнуть ошибка атрибуции, то есть AppsFlyer не сможет атрибутировать событие медиа-источнику. При этом события регистрируются и отображаются в отчетах и на дэшбордах. 

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. Подготовьте настраиваемую ссылку атрибуции для тестирования сообщений S2S. Установите для параметра медиа-источника в ссылке значение s2s_test. Например: &pid=s2s_test 
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, не заполняются.

• Рекламный идентификатор / идентификатор устройства является обязательным для отправки постбэков в сети 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.
• Имя приложения