Apple Ads
Интеграция Apple Ads в App settings используется только для базовой аналитики и для интеграций SplitMetrics Acquire и Asapty.
Apple Ads Manager использует отдельное подключение. Подключите аккаунт Apple Ads в настройках Apple Ads Manager.
Adapty помогает получать данные атрибуции из Apple Ads и анализировать метрики с сегментацией по кампаниям и ключевым словам. Данные атрибуции для Apple Ads Adapty собирает автоматически через SDK и AdServices Framework.
После настройки интеграции Apple Ads Adapty начнёт получать данные атрибуции из Apple Ads. Просматривать эти данные можно на странице профилей.
Настройка интеграции
Подключение Adapty к фреймворку AdServices
Apple Ads через AdServices требует определённой настройки в дашборде Adapty, а также включения на стороне приложения. Чтобы настроить Apple Ads с использованием фреймворка AdServices через Adapty, выполните следующие шаги:
Шаг 1: Настройте Info.plist
Добавьте AdaptyAppleSearchAdsAttributionCollectionEnabled в файл Info.plist приложения и установите значение YES (булево значение).
Шаг 2: Получите публичный ключ
В дашборде Adapty перейдите в Settings -> Apple Ads.
Найдите заранее сгенерированный публичный ключ (Adapty предоставляет пару ключей) и скопируйте его.
Если вы используете сторонний сервис или собственное решение для атрибуции Apple Ads, вы можете загрузить свой приватный ключ.
Шаг 3: Настройте управление пользователями в Apple Ads
В вашем аккаунте Apple Ads перейдите на страницу Settings > User Management. Чтобы Adapty мог получать данные атрибуции, нужно пригласить другой аккаунт Apple ID и предоставить ему доступ API Account Manager. Можно использовать любой доступный аккаунт или создать новый специально для этой цели. Главное условие: вы должны иметь возможность войти в Apple Ads под этим Apple ID.
Шаг 4: Сгенерируйте API-учётные данные
Затем войдите в только что добавленный аккаунт в Apple Ads. Перейдите в Settings -> API в интерфейсе Apple Ads. Вставьте скопированный ранее публичный ключ в соответствующее поле. Сгенерируйте новые API-учётные данные.
Шаг 5: Настройте Adapty с учётными данными Apple Ads
Скопируйте поля Client ID, Team ID и Key ID из настроек Apple Ads. В дашборде Adapty вставьте эти данные в соответствующие поля.
Подключение приложения к сети AdServices
После завершения настройки фреймворка AdServices Adapty автоматически начинает собирать данные атрибуции Apple Search Ads. Добавлять какой-либо код в SDK не нужно.
Для iOS-приложений эти данные атрибуции всегда будут иметь приоритет над данными из других источников. Если такое поведение нежелательно, отключите атрибуцию ASA, следуя инструкциям ниже.
Отключение интеграции
Чтобы отключить атрибуцию Apple Search Ads, откройте вкладку App Settings -> Apple Search Ads и переключите тумблер Receive Apple Search Ads attribution.
Обратите внимание: отключение этой функции полностью прекратит получение аналитики ASA. В результате ASA больше не будет использоваться в аналитике и не будет передаваться в интеграции. Кроме того, SplitMetrics Acquire и Asapty перестанут работать, так как они зависят от атрибуции ASA.
Атрибуция, полученная до этого изменения, затронута не будет.
Загрузка собственных ключей
Необязательно
Эти шаги не требуются для атрибуции Apple Ads — только для работы с другими сервисами, например Asapty, или с собственным решением.
Вы можете использовать собственную пару публичного и приватного ключей, если применяете сторонние сервисы или собственное решение для атрибуции ASA.
Шаг 1
Сгенерируйте приватный ключ в терминале:
openssl ecparam -genkey -name prime256v1 -noout -out private-key.pemЗагрузите его в Adapty Settings -> Apple Ads (кнопка Upload private key).
Шаг 2
Сгенерируйте публичный ключ в терминале:
openssl ec -in private-key.pem -pubout -out public-key.pemЭтот публичный ключ можно использовать в настройках Apple Ads аккаунта с ролью API Account Manager. Таким образом, сгенерированные значения Client ID, Team ID и Key ID можно применять как в Adapty, так и в других сервисах.