Singular

Singular — одна из ведущих платформ Mobile Measurement Partner (MMP), которая собирает и представляет данные из маркетинговых кампаний. Это помогает компаниям отслеживать эффективность своих кампаний.

Adapty предоставляет полный набор данных, позволяющий отслеживать события подписок из сторов в одном месте. С помощью Adapty вы можете легко анализировать поведение подписчиков, понимать их предпочтения и использовать эту информацию для точечной и эффективной коммуникации. Данная интеграция позволяет отслеживать события подписок в Singular и точно анализировать, какой доход приносят ваши кампании.

Adapty может отправлять все события подписок, настроенные в вашей интеграции, в Singular. В результате вы сможете отслеживать эти события в дашборде Singular. Интеграция полезна для оценки эффективности рекламных кампаний.

Настройка интеграции

Подключение Adapty к Singular

Чтобы настроить интеграцию с Singular, перейдите в раздел Integrations > Singular в дашборде Adapty, включите переключатель и заполните поля.

Доступны следующие учётные данные:

Singular SDK Key: Обязательное поле. Производственный SDK-ключ для вашего приложения в Singular.
Singular SDK Key (Sandbox): Необязательное поле. SDK-ключ для вашего приложения в песочнице Singular. Если не задан, события песочницы не будут отправляться в Singular.

Оба ключа можно найти в дашборде Singular в разделе Developer tools -> SDK Keys -> SDK Key (не SDK Secret):

Ниже учётных данных расположены три группы событий, которые можно отправлять в Singular из Adapty. Полный список событий, доступных в Adapty, смотрите здесь.

Рекомендуем использовать названия событий по умолчанию, предоставляемые Adapty. При необходимости вы можете изменить их под свои нужды.

Adapty будет отправлять события подписок в Singular через интеграцию сервер-к-серверу, что позволит просматривать все события подписок в дашборде Singular и связывать их с вашими рекламными кампаниями.

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

Подключение приложения к Singular

Интеграция между Adapty и Singular осуществляется по схеме сервер-к-серверу. Поэтому добавлять дополнительный код в приложение не нужно.

Структура события

Adapty отправляет события в Singular через GET-запрос с использованием параметров запроса. Каждое событие имеет следующую структуру:

{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}

Где:

Параметр	Тип	Описание
`n`	String	Название события (сопоставленное с событием Adapty).
`a`	String	Ваш Singular SDK Key.
`p`	String	Платформа (“iOS” или “Android”).
`i`	String	Store App ID (Bundle ID).
`ip`	String	IP-адрес пользователя.
`idfa`	String	Только iOS. ID для рекламодателей (в верхнем регистре).
`idfv`	String	Только iOS. ID для вендоров (в верхнем регистре).
`aifa`	String	Только Android. Google Advertising ID (в нижнем регистре).
`andi`	String	Только Android. Android ID (в нижнем регистре).
`asid`	String	Только Android. App Set ID (в нижнем регистре).
`ve`	String	Версия ОС.
`att_authorization_status`	Integer	Только iOS. Статус ATT (например, `3` — авторизован).
`custom_user_id`	String	Customer User ID пользователя.
`utime`	Long	UNIX-временная метка события в секундах.
`amt`	Float	Сумма дохода.
`cur`	String	Код валюты (например, “USD”).
`purchase_product_id`	String	ID продукта в сторе.
`purchase_transaction_id`	String	Оригинальный ID транзакции.
`e`	String	JSON-строка с деталями события (см. ниже).

Параметр e (данные пользовательского события) — это JSON-строка, содержащая:

Параметр	Тип	Описание
`is_revenue_event`	Boolean	`true`, если событие содержит данные о доходе.
`amt`	Float	Сумма дохода.
`cur`	String	Код валюты.
`purchase_product_id`	String	ID продукта в сторе.
`purchase_transaction_id`	String	Оригинальный ID транзакции.