Шаг 1. Настройте регистрацию возвращаемых данных SKAdNetwork для нужных версий iOS
Подробные сведения приведены в документации Apple. Если вы используете SDK Google Аналитики для Firebase, то ничего делать не нужно, поскольку этот SDK будет автоматически регистрировать в приложении возвращаемые данные SKAdNetwork.
Шаг 2. Убедитесь, что возвращаемые данные SKAdNetwork передаются и декодируются
Подробные сведения приведены в документации Apple. Если вы ещё не настроили конечную точку SKAdNetwork, сделайте это. Инструкции можно найти в документации Apple.
Если вы уже настроили конечную точку с помощью одобренного Google партнера по атрибуции конверсий в приложениях или собственного решения, можете пропустить третий шаг, на котором настраивается передача данных в Google Аналитику с помощью Measurement Protocol.
Шаг 3. Настройте передачу возвращаемых данных в Google Аналитику с помощью Measurement Protocol
Это делается через отправку в Google Аналитику специального события campaign_details с помощью Measurement Protocol и приведенной ниже схемы (см. пример в практической работе).
Настройки Measurement Protocol для передачи данных SKAdNetwork в Google Аналитику 4
Параметры на уровне запроса
| Параметр | Дополнительная информация |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
|
| app_instance_id: {...} |
Обязательный параметр. Создает уникальную строку случайных чисел. После использования данных для моделирования конверсий этот идентификатор, заменяющий собой реальный идентификатор экземпляра приложения, удаляется. |
Событие GA4
| Событие | Дополнительная информация |
| campaign_details | Специальное событие. |
Параметры Google Аналитики (существующие)
| Параметр | Дополнительная информация |
| source: {source} |
Это параметры, которые используются при пометке вручную. Отчеты Google Аналитики 4 структурируются на основе групп каналов по умолчанию – мы рекомендуем руководствоваться ими при категоризации параметров. Отправляйте эти параметры со всеми сторонними возвращаемыми данными. Посмотрите пример ниже. Передача возвращаемых данных Facebook:
При возврате данных Google мы декодируем идентификатор кампании на основе интеграции ресурса с Google Рекламой, так что в этом случае указанные здесь параметры необязательны. Убедитесь, что ресурс Google Аналитики 4 связан с нужными аккаунтами Google Рекламы. Примечание. Важно, чтобы вы передавали в Google Аналитику 4 все возвращаемые данные SKAdNetwork, а не только те, которые не относятся к Google. |
| medium: {medium} | |
| term: {term} Необязательный параметр | |
| content: {content} Необязательный параметр | |
| campaign_id: {campaign_id} | Значение из возвращаемых данных SKAdNetwork. |
| campaign: {campaign} Этот параметр необязателен, но без него данные отображаются с пометкой "(не указано)" |
Для кампаний Google Рекламы мы декодируем идентификатор, предоставляем название кампании на основе интеграции Google Аналитики с Google Рекламой и обновляем параметры source и medium. Если аккаунты не связаны, мы не декодируем идентификатор кампании Google и используем указанные значения параметров source и medium. Для сторонних кампаний вы можете самостоятельно декодировать идентификаторы и предоставлять названия кампаний. Если у вас нет этой информации, можно копировать значение campaign_id из данных SKAdNetwork. Примечание. Если этот параметр отсутствует, данные отображаются с пометкой (не указано). |
| source_platform: "apple_skan" | Важно! Это значение должно быть указано точно, с учетом использования заглавных букв и символа подчеркивания (_). |
| app_id: {app_id} |
Значение из возвращаемых данных SKAdNetwork. Это идентификатор пакета приложения. |
| transaction_id: {transaction_id} | Значение из возвращаемых данных SKAdNetwork. |
Новые обязательные параметры
Примечание. Вы можете настроить эти параметры в интерфейсе Google Аналитики 4 (необязательно). Они необходимы, если вы хотите создавать отчеты с соответствующими специальными параметрами.
| Параметр | Дополнительная информация |
| version: {version} | Значение из возвращаемых данных SKAdNetwork. |
| conversion_value: {conversion_value} | Значение из возвращаемых данных SKAdNetwork. |
| fidelity_type: {fidelity_type} | Значение из возвращаемых данных SKAdNetwork. |
| attribution_signature: {attribution_signature} |
Значение из возвращаемых данных SKAdNetwork. Примечание. Это функция защиты. Возвращаемые данные SKAdNetwork криптографически подписываются. |
| redownload: {redownload} | Значение из возвращаемых данных SKAdNetwork. |
| source_app_id: {source_app_id} |
Значение из возвращаемых данных SKAdNetwork. Примечание. Это идентификатор приложения, где был выполнен клик по объявлению, который привел к установке. |
| did_win: {did_win} |
Значение из возвращаемых данных SKAdNetwork. Примечание. Рекламодатели получают возвращаемые данные только о выигравших кампаниях. Рекламные технологии позволяют получать возвращаемые данные о выигравших и вспомогательных кампаниях.
|
|
ad_network_id: {ad_network_id} {ad_network_id} – значение из возвращаемых данных |
Значение из возвращаемых данных SKAdNetwork. Обозначает рекламную сеть, в которой было показано ваше объявление. Эта информация также полезна для параметра трафика source. |
Шаг 4. Убедитесь, что вы получаете обращения Платформы для маркетинга
События campaign_details не отображаются в Google Аналитике напрямую. Вместо этого возвращаемые данные SKAdNetwork преобразуются в события и включаются в отчеты как событияfirst_open. Вы можете выделить эти данные с помощью сегментирования, добавив параметр source_platform (source_platform = SKAN).
Чтобы проверить, передаются ли обращения, мы рекомендуем настроить регистрацию тестовых событий через копирование событий campaign_details с назначением им другого названия, например campaign_details_skan_test. Тестовые события должны появиться в отчете в реальном времени Google Аналитики 4. Если вы настроили регистрацию тестовых событий и параметров, эти данные появятся также в специальных отчетах.
- Если вы хотите, чтобы в отчетах показывались все возвращаемые данные SKAdNetwork, то помимо отправки событий
campaign.detailsнастройте регистрацию копий событий и параметров, как описано выше. Но даже если вы это сделаете, возвращаемые данные SKAdNetwork все равно должны передаваться с помощью событияcampaign.details. В противном случае Google Аналитика не сможет распознать их и использовать при моделировании конверсий, чтобы улучшить отчеты о событияхfirst_openдля iOS. - Возвращаемые данные SKAdNetwork должны быть переданы в Google Аналитику в течение четырех дней с момента их получения. Только в этом случае они будут использованы для моделирования конверсий и отчетов.
Ознакомьтесь с общими инструкциями по проверке реализации.