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

Для реализации API требуются следующие учётные данные, доступные на дэшборде:

• Идентификатор пакета (он же идентификатор пакета бренда)
• Веб-ключ разработчика 

Чтобы получить учётные данные: 

1. В AppsFlyer в верхнем меню выберите Мои приложения > Просмотр пакетов брендов.
   Отобразится список пакетов.
2. Скопируйте и запишите:
   • Идентификатор пакета бренда
   • Веб-ключ разработчика 

Основы API веб-S2S

 Пример Curl setCuId

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/setcuid' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
        "webDevKey" : "99999999-9999-9999-9999-999999999999"}

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

• Идентификатор пользователя: Вы должны отправить хотя бы один параметр идентификатора пользователя.
• Событие: Отправьте обязательные параметры и необязательные по мере необходимости.

Параметры идентификатора пользователя (отправьте хотя бы один параметр)

Параметры события

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/event' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey" : "99999999-9999-9999-9999-999999999999",
    "ip" : "192.0.2.1",
	"eventType":"EVENT",
	"timestamp" : 1234567890123,
	"eventName":"my_web_event",
	"eventRevenueCurrency" : "EUR",
	"eventRevenue" : 1234.56,
	
		"eventValue": {
		"purchase":{
		 "shoes": "color",
		 "quantity" : "3",
		 "Revenue" : "1234.56",
		 "Currency" : "ZAR"
		}
	}

}'

''' using the requests python package, install using pip install requests  '''
import requests
url = "https://webs2s.appsflyer.com/v1/bundleId/event"
payload = {
    "customerUserId": "1234567890abcdef",
    "afUserId": "9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey": "99999999-9999-9999-9999-999999999999",
    "ip": "192.0.2.1",
    "eventType": "EVENT",
    "timestamp": 1234567890123,
    "eventName": "my_web_event",
    "eventRevenenuCurrency": "EUR",
    "eventRevenue": 1234.56,
    "eventValue":
        {
            "purchase":
            {
                "shoes": "color",
                "quantity": "3",
                "Revenue": "1234.56",
                "Currency": "ZAR"
            }
        }
    }
headers = {
    'Accept-Encoding': 'application/json',
    'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text.encode('utf8'))

Для тестирования отправьте несколько событий следующим образом:

1. Отправьте событие.
2. Убедитесь, что вы получили код возврата 200 OK. Если нет, примите меры по исправлению ситуации, используя коды возврата и сообщения об ошибках.
3. Подождите несколько часов после полуночи UTC, чтобы увидеть зарегистрированное событие в сырых данных PBA. Вы должны подождать, потому что данные PBA обрабатываются один раз в день. 

 Чтобы получить веб-ключ разработчика:

1. В AppsFlyer перейдите на вкладку Мои приложения.
2. Нажмите Просмотреть пакет бренда.

   

3. Скопируйте необходимый  веб-ключ разработчика. 

• afUserId — это уникальный идентификатор, устанавливаемый в веб-SDK при первом посещении пользователем вашего сайта.
• Если вам нужен afUserId, воспользуйтесь одним из следующих способов.

Получение afUserId из заголовка HTTP cookie

• Значение afUserId отправляется браузером посетителя при обращении к вашему сайту.
•  При необходимости извлеките его из заголовка HTTP cookie.

Просмотр afUserId в браузере посетителя

•  Просмотрите afUserId в браузере посетителя в целях устранения неполадок и отладки.
• Чтобы параметр стал доступен, посетитель должен хотя бы один раз зайти на страницу с веб-SDK. 
• Файл cookie, содержащий afUserId, является файлом cookie первой стороны по отношению к вашему домену.
• Следующая процедура была подготовлена с использованием Chrome 81. В разных браузерах и операционных системах могут быть некоторые различия.

Чтобы получить afUserId из браузера посетителя:

1. В своём браузере перейдите на свой сайт.
2. Нажмите правой кнопкой мыши, выберите Inspect.
   Откроется окно браузера для проверки элементов.

   

3. Перейти на вкладку (A) Application.
4. В боковом меню (B) раскройте Cookies.
5. Выберите свой сайт. Если он не отображается, обновите браузер.
6. В поле (C) фильтр введите afUserId
   Отобразится значение afUserID. 

• Признак ошибки:  Коды возврата HTTP не возвращаются
  Решение: Внесите серверы AppsFlyer в список разрешённых