At a glance: Apple Search Ads (ASA), an AppsFlyer SRN integrated partner, assists users visiting the App Store to find your app using keywords. ASA attributed installs aren't reported by SKAdNetwork.
Обновление до iOS 14: изменения в интеграции Apple Search Ads
Changes to the Apple Search ads integration starting February 15, 2021.
Apple Search Ads functions independently of SKAdNetwork and deterministically attributes users. This means that for users attributed to ASA you have the full range of features and measurement provided by our LTV attribution model.
Релевантность вашего приложения поисковому запросу в AppStore определяет, будет ли показана ваша реклама. Отклик пользователя на рекламу — важный показатель ее релевантности. Если никто не нажимает на объявление, Apple Search Ads перестает его показывать.
ASA offers click-based mobile attribution, user retargeting, and cost data via API (with an Xpend subscription).
Apple Search Ads functions independently of SKAdNetwork and deterministically attributes users. This means that for users attributed to ASA you have the full range of features and measurement provided by our LTV attribution model.
Настройка Apple Search Ads
Необходимые условия- For iOS V14.3+ you must adopt AppsFlyer SDK V6.1.3+
- If you use an SDK version prior to V6.1.3: ensure that native ad frameworks are included in your app.
Настройка Apple Search Ads в AppsFlyer:
- В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
- Выберите Apple Search Ads.
- Перейдите на вкладку Интеграция.
- Установите переключатель Активировать партнера в положение «Включено».
- Click Save.
- Configure the integration, cost, and partner permissions as needed.
Материал по теме: Заголовок окна настройки параметров партнера
Settings tabs
Для ASA актуальны следующие вкладки настроек: Integration (Интеграция), Cost (Затраты) и Permissions (Разрешения).
Интеграция
Как сеть с самостоятельной атрибуцией (SRN) Apple Search Ads интегрируется с AppsFlyer через API. Поэтому настройки постбэков отсутствуют. Заполните следующие разделы в соответствии со своими целями атрибуции.
Раздел | Детали |
---|---|
Активация интеграции |
Активация партнера Чтобы начать атрибуцию этого партнера:
|
Атрибуция установок |
Окно атрибуции установки по клику Задайте максимальное время от клика до установки. После этого AppsFlyer сможет атрибутировать ASA установки (первые запуски), которые происходят в пределах окна ретроспективного обзора. Диапазон: от 1 до 30 дней Материал по теме: Окно ретроспективного обзора по кликам |
Повторные установки |
Атрибуция повторных установок Если этот параметр включен, AppsFlyer атрибутирует повторные установки ASA по указанным здесь правилам. Настройки окна атрибуции повторных установок задаются согласно настройкам атрибуции установок. По каждой новой установке ASA отправляет AppsFlyer флаг re-download (повторная загрузка). Если значение true, установка считается повторной загрузкой. Если выполняются все следующие условия, установка атрибутируется ASA как повторная установка:
В настоящее время ретаргетинг ASA не поддерживает повторные вовлечения. |
Период бездействия Задайте порог неактивности пользователя (в днях), чтобы контролировать влияние ретаргетинговых кампаний. |
затраты
Включение интеграции затрат Apple Search Ads
If you enable cost API, AppsFlyer receives cost, clicks, and impression data from ASA via API. Note: Cost data requires an Xpend subscription. Without Xpend, only click and impression data is received.
Поддерживается использование нескольких аккаунтов ASA. Иными словами, если вы запускаете кампании для одного и того же приложения, используя разные аккаунты Search Ads, AppsFlyer может получать данные из всех аккаунтов.
- Загрузите сертификаты аутентификации, т. е. файлы PEM и KEY, из аккаунта Apple Search Ads.
- Загружать файлы следует отдельно из каждого аккаунта.
Чтобы загрузить файл PEM и KEY из вашего аккаунта Apple Search Ads:
- Войдите в Apple Search Ads, щелкните в правом верхнем углу, выберите настройки.
- Перейдите на вкладку API и нажмите Create API Certificate (Создать сертификат API).
- Назовите сертификат API и выберите тип разрешений в Account Read-only (Только для чтения) или Account admin (Администратор аккаунта), нажмите Create (Создать) .
- Выберите Action (Действие), затем Download (Загрузить).
Подготовка файлов сертификатов
Сертификаты скачиваются как архив ZIP с двумя файлами. Извлеките их и загрузите в AppsFlyer, как описано в следующей процедуре.
Если сертификат содержит разрешения на просмотр данных нескольких приложений, вы можете использовать его для получения данных о затратах по этим приложениям.
Повторите следующую процедуру для каждого приложения, упомянутого в сертификате.
Чтобы включить подключение API к Apple Search Ads:
- В AppsFlyer перейдите на вкладку Apple Search Ads > Cost (Затраты).
- При необходимости установите флажок Get cost, clicks, and impressions data (Получать данные по расходам, кликам и показам).
- Щелкните Добавить сертификат.
- Введите Имя сертификата. Оно должно совпадать с именем аккаунта Apple Search Ads.
- Если вы этого еще не сделали, разархивируйте файл, который вы скачали с Apple Search Ads.
- Загрузите файлы PEM и KEY , которые вы скачали из Apple Search Ads.
- Через несколько секунд индикатор статуса изменится на ОК. Если это не так, появится сообщение об ошибке. Таблица сообщений об ошибках.
- Нажмите Сохранить расходы.
- Если у вас больше одного аккаунта Apple Search Ads, повторите необходимые шаги для каждого из них.
AppsFlyer получает данные о затратах за последние 7 дней. Данные о предшествующих затратах недоступны.
Примечание
Данные о затратах для базовых кампаний не поддерживаются в API отчетов ASA, поэтому данные о базовых кампаниях недоступны в AppsFlyer.
Состояние синхронизации данных о расходах
На вкладке затрат отображается статус интеграции затрат.
Additional integration information
Сопоставление полей кампании Apple Search Ads
Поле отчета AppsFlyer по сырым данным | Примечания |
---|---|
Deprecated in AdServcies API | |
ID кампании | |
Deprecated in AdServcies API | |
ID блока рекламы | |
Deprecated in AdServcies API | |
ID рекламы. | Необязательно в ASA. Если значение не задано, поле в AppsFlyer будет пустым. |
Deprecated in AdServcies API | |
ID ключевого слова |
The field is available via raw data reports. However, it must be explicitly selected in Data Locker, Push API, and Export data. In the case of Pull API, add keyword_id to the &additional_fields parameter of the Pull API call. |
Apple Search Ads: маркетинговый партнер vs. агентство
Advertisers and agencies can elect to work with ASA Marketing Partners to report and optimize campaigns on ASA.
Различия между агентствами и маркетинговыми партнерами приведены в следующей таблице.
Агентство | Маркетинговый партнер | |
---|---|---|
AppsFlyer отправляет постбэки | Нет | Да |
технология | Запуск кампаний от вашего имени | Имеют полезные технологические решения для оптимизации кампаний |
Настройка агентств и маркетинговых партнеров
Use the checklist that follows to ensure that you complete all steps in the configuration process. Detailed instructions are contained per partner type in the sections that follow.
Кем настраивается | Integration with an agency | Integration with a marketing partner |
---|---|---|
Рекламодатель |
|
|
Агентство |
На вкладке интеграции ASA задайте группу рекламных кампаний Apple Search Ads. |
— |
Настройка маркетингового партнера
To set up a marketing partner:
- If required, activate Apple Search Ads integration:
- В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры) > Apple Search Ads.
- Установите переключатель Активировать партнера в положение «Включено».
- Нажмите кнопку Save (Сохранить).
-
In your Apple Search Ads dashboard: Get the Apple Search Ads Campaign Group ID parameter related to the marketing partner. Use the screenshot that follows as a guide to locating the ID.
-
В AppsFlyer настройте маркетингового партнера ASA:
- В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
- Search for the Apple Search Ads marketing partner.
The list of marketing partners displays. - Выберите маркетингового партнера.
- Установите переключатель Активировать партнера в положение «Включено».
- Enter the partner's Apple Search Ads Campaign ID that you retrieved in the earlier step. Enter the digits (numbers) only.
- Нажмите кнопку Save (Сохранить).
-
[Optional] Configure in-app events postback:
-
Активируйте постбэки внутренних событий приложений.
- Click Add event to add an SDK event to the list.
-
Введите следующие параметры:
- SDK event name: The name of the event, as received by AppsFlyer either from the SDK integrated in your app, or from server to server events. Tip: If you don't see the event you want in the list, make sure to activate the event on a device with a non-organic installation and recheck.
- Send revenue: Select one of the following: No values and no revenue, Values & no revenue, or Values & revenue.
-
- Click Save integration.
Настройка агентства
Рекламодатели могут разрешить агентствам запускать кампании от своего имени с помощью Apple Search Ads. И рекламодатели, и агентства выполняют действия по настройке в AppsFlyer, описанные в данном разделе.
Группа рекламных кампаний Apple Search Ads
- Agency campaigns and advertiser campaigns must be separate Apple Search Ads ID campaign groups.
- В имени группы нельзя использовать специальные символы и пробелы.
Действия рекламодателя
Необходимые условия:
Предоставить доступ агентству.
To enable attribution of Apple Search Ads the advertiser:
- В AppsFlyer перейти в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
- Выбрать Apple Search Ads.
- Перейти на вкладку Integration (Интеграция) и установить флажок Activate partner (Активировать партнера).
- [Необязательно] Чтобы атрибутировать пользователей, которые повторно устанавливают приложение во время окна реатрибуции, включите Reinstall attribution (Атрибуция повторных установок).
- Нажмите кнопку Save (Сохранить).
Действия агентства
-
In your Apple Search Ads dashboard: Get your Campaign Group ID. Use the screenshot that follows as a guide to locating the ID. Get only the digits.
- Выберите приложение в AppsFlyer.
- Перейдите в раздел Конфигурация > Интегрированные партнеры.
- Выбрать Apple Search Ads.
- Enter the Apple Search Ads Campaign ID parameter. Note! Enter digits (numbers only)
- Нажмите кнопку Сохранить.
Примечание
When an agency works with an Apple Search Ads Marketing Partner, the agency must configure the same campaign group ID in both the Apple Search Ads configuration page and the Marketing Partner configuration page.
Данные о затратах, кликах и показах
- In the Cost tab, turn on Get [Cost], Clicks, and Impressions Data.
- Загрузите действительный файл PEM и KEY.
- Нажмите кнопку Save (Сохранить).
Примечание
Агентства должны включить затраты на своем дэшборде и загрузить сертификаты на своей стороне, чтобы синхронизировать затраты с AppsFlyer.
Disable agencies and marketing partners
To stop recording attribution of Apple Search Ads installs generated by agencies or marketing partners:
- In AppsFlyer, go to Integrations > Integrated partners.
- Select the agency or marketing partner as the case may be.
- Delete the content of the Apple Search Ads Campaign Group ID field.
- Click Save integration.
AppsFlyer и Apple Search Ads используют разную логику атрибуции, что приводит к расхождениям между этими платформами. Apple Search Ads, сеть с самостоятельной атрибуцией (SRN), передает данные о новых установках через API.
Передача данных из Apple Search Ads в AppsFlyer через API
- Кампании агрегируются по географии.
- Следующие данные не передаются: показы, клики и затраты по регионам, где менее 100 показов в рамках данной кампании.
- При группировке по Geo в AppsFlyer географические регионы с недоступными данными не отображаются, а общее количество недоступных данных отображается в разделе N/A.
Расхождения, связанные с ретаргетингом
Механизм атрибуции ретаргетинга AppsFlyer позволяет рекламодателям измерять и анализировать не только кампании по привлечению пользователей, но и ретаргетинговые кампании.
На следующих скриншотах показано, какие расхождения могут быть связаны с ретаргетинговыми кампаниями, выполняемыми в Apple Search Ads (независимо от настроек элементов управления ретаргетингом).
Ретаргетинг включен
Ретаргетинг отключен
Дополнительные поводы для расхождений
В таблице перечислены основные причины появления расхождений.
Расхождение | ![]() |
![]() |
---|---|---|
Начальные данные атрибуции Apple Search Ads могут отобразиться с задержкой в несколько секунд. |
Возможна задержка в несколько секунд |
Чтобы атрибуция AppsFlyer работала корректно, данные должны поступать в реальном времени |
Расхождения, связанные с используемой версией SDK AppsFlyer |
Считает конверсии независимо от версии SDK AppsFlyer |
Для корректной работы атрибуции требуется SDK версии 5.0 и выше |
Ограничение отслеживания рекламы (LAT) и ATT: |
Всегда считает конверсию. Если кампания имеет ограничения по возрасту или полу, из нее исключаются пользователи с LAT. В отношении пользователей Apple, не достигших 18 лет, всегда действует LAT. |
LAT-конверсии атрибутируются как органические. |
Подсчет пользователей |
Считает количество пользователей по скачиваниям. |
Считает количество пользователей по первому открытию приложения. |
Повторная установка: пользователь удаляет ранее установленное приложение, после чего кликает объявление контекстной рекламы и устанавливает приложение повторно. |
Учитывается как конверсия (установка). |
Определяет повторную установку и не учитывает в контексте привлечения пользователей. Совет. Включите ретаргетинг, чтобы повторные установки регистрировались как установки после ретаргетинга (или реатрибуция). |
Click lookback window |
Фиксированный период: 30 дней |
Настраивается |
Победный клик |
Всегда атрибутирует себе, если пользователь взаимодействовал с объявлением и загрузил приложение. |
Видит несколько сетей и выполняет атрибуцию по последнему клику. |
Install Time (Время установки) |
Время загрузки приложения |
Первое открытие приложения |
Time Zone (Часовой пояс) |
Часовой пояс магазина приложений |
Часовой пояс UTC |
Данные о конверсиях |
Поступление в AppsFlyer данных о том, что сеть Apple Search Ads принесла установку, может занимать более 5 секунд. |
Атрибуция происходит в течение 5 секунд, когда отвечает API данных конверсии. Если за это время данные еще не поступили, пользователь считается органическим. |
Данные о затратах |
Предоставляет данные о затратах по всем ключевым словам. |
Не предоставляет данные по ключевым словам, содержащим заглавные буквы, в когортном отчете или когортном API. |
Гео |
Apple Search Ads позволяет рекламодателям настраивать таргетинг на пользователей в соответствии с их страной и регионом. Apple Search Ads поддерживает ограниченное количество стран . |
AppsFlyer распознает точное географическое местоположение пользователя по IP-адресу, поэтому отчеты о географии недоступны в Apple Search Ads. Совет. Пользователи, которые устанавливают приложение, находясь в фактической стране магазина приложений, имеют те же географические данные в AppsFlyer и Apple Search Ads. |
Работа с Apple Search Ads позволяет вам собирать ценные данные о маркетинге, которые могут оказать влияние на привлечение пользователей через все медиа-источники для ваших приложений iOS.
Рекомендации по максимизации эффекта от использования Apple Search Ads:
Совет | Детали |
---|---|
Получайте данные по ключевым словам |
Apple Search Ads делится данными о ключевых словах с AppsFlyer. Сведения о ключевых словах можно просматривать в отчетах по сырым данным и средствах аналитики, таких как Pivot, Retention или Cohort. Отсутствие в AppsFlyer сведений о ключевых словах может быть вызвано следующими причинами:
Используйте только точные или широкие поисковые кампании для получения полных данных о ключевых словах. |
Сравните качество пользователей на основе данных о ключевых словах |
Не все ключевые слова равны. Это означает, что в то время как разные ключевые слова могут стоить одинаково, качество привлеченных пользователей может быть разным. Используйте отчеты Удержание или Сводный отчет, чтобы определить ключевые слова, обеспечивающие максимальную рентабельность инвестиций. |
Анализ стоимости ключевых слов |
Платформа содержит агрегированные данные о стоимости ключевых слов, когда кампании ASA с ключевыми словами настроены как точное или широкое соответствие. Данные о стоимости ключевых слов имеют следующие характеристики:
Ограничения
ПримерыПример когортыВ следующем примере показано, как настроить когорту для просмотра информации о затратах и ROI (окупаемость инвестиций). Настройка когорты Когортный отчет (таблица) В следующей таблице показаны общие затраты и рентабельность инвестиций по когорте. Пример сводной таблицыНастройка сводной таблицы Сводная таблица результатов |
Найдите наиболее эффективный креативный набор |
Рекомендуется проверить, как лиды реагируют на различные креативные наборы, которые вы используете. Самые эффективные креативные наборы имеют самые высокие показатели конверсии. Кроме того, лучшие креативные наборы конвертируют пользователей с более высоким уровнем вовлеченности. Это влияет на все ваши лиды на iOS, а не только на ASA, поскольку все они попадают на страницу вашего приложения в магазине приложений. Однако при установке ASA, AppsFlyer указывает идентификатор креативного набора в параметре сырых данных Ad ID,позволяя вам сравнивать эффективность различных креативных наборов. |
Нацеливайтесь на повторное скачивание |
Ваши прошлые пользователи, возможно, лучшая аудитория для вас, чтобы использовать таргетинг на ASA. Пользователь, который удалил ваше приложение и в результате вашей ретаргетинговой кампании ASA повторно его установил, называется в ASA Re-Downloader. Если повторная установка выполняется в течение окна реатрибуции, AppsFlyer называет это реатрибуцией. Во всех остальных случаях это рассматривается как новая установка. |