[GA4] Как настроить передачу возвращаемых данных SKAdNetwork в Google Аналитику

В этой статье рассказывается, как настроить передачу возвращаемых данных SKAdNetwork в Google Аналитику с помощью Measurement Protocol.

Шаг 1. Настройте регистрацию возвращаемых данных SKAdNetwork для нужных версий iOS

Подробные сведения приведены в документации Apple. Если вы используете SDK Google Аналитики для Firebase, то ничего делать не нужно, поскольку этот SDK будет автоматически регистрировать в приложении возвращаемые данные SKAdNetwork.

Шаг 2. Убедитесь, что возвращаемые данные SKAdNetwork передаются и декодируются

Подробные сведения приведены в документации Apple. Если вы ещё не настроили конечную точку SKAdNetwork, сделайте это. Инструкции можно найти в документации Apple.

Примечание. В настоящее время Google Аналитику 4 нельзя использовать в качестве конечной точки.

Если вы уже настроили конечную точку с помощью одобренного Google партнера по атрибуции конверсий в приложениях или собственного решения, можете пропустить третий шаг, на котором настраивается передача данных в Google Аналитику с помощью Measurement Protocol.

Шаг 3. Настройте передачу возвращаемых данных в Google Аналитику с помощью Measurement Protocol

Это делается через отправку в Google Аналитику специального события campaign_details с помощью Measurement Protocol и приведенной ниже схемы (см. пример в практической работе).

Настройки Measurement Protocol для передачи данных SKAdNetwork в Google Аналитику 4

Необходимо настроить все параметры, кроме тех, которые помечены как необязательные.

Параметры на уровне запроса

Параметр	Дополнительная информация
firebase_app_id: {gmp_app_id}	В Google Аналитике 4 выберите Администратор > Потоки данных > [нужный поток] > Идентификатор приложения в Firebase. Не относится к полезной нагрузке.
api_secret: {api_secret}	Чтобы создать секрет, в Google Аналитике 4 выберите Администратор > Потоки данных > [нужный поток] > Measurement Protocol > Создать. Не относится к полезной нагрузке.
timestamp_micros: {timestamp of received SKAN postback}	Необязательный параметр, но если он указан, значение должно входить в диапазон последних 72 часов. Если не указан, используется временная метка сбора данных. В окне Google Аналитики 4 Ключевые события представлены данные за 30 дней. Чтобы повысить точность отчетов, передавайте возвращаемые данные как можно скорее.
app_instance_id: {...}	Обязательный параметр. Создает уникальную строку случайных чисел. После использования данных для моделирования конверсий этот идентификатор, заменяющий собой реальный идентификатор экземпляра приложения, удаляется.

Событие GA4

Событие	Дополнительная информация
campaign_details	Специальное событие.

Параметры Google Аналитики (существующие)

Параметр	Дополнительная информация
source: {source}	Это параметры, которые используются при пометке вручную. Отчеты Google Аналитики 4 структурируются на основе групп каналов по умолчанию – мы рекомендуем руководствоваться ими при категоризации параметров. Отправляйте эти параметры со всеми сторонними возвращаемыми данными. Посмотрите пример ниже. Передача возвращаемых данных Facebook: source: facebook; medium: cpc|cpm; content: ad_version_name; campaign: кампания на Facebook "Весна-22"; campaign id: значение из возвращаемых данных SKAN. При возврате данных 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 Аналитику в течение четырех дней с момента их получения. Только в этом случае они будут использованы для моделирования конверсий и отчетов.

Ознакомьтесь с общими инструкциями по проверке реализации.