Вкратце: Используйте OneLink Smart Script, чтобы конвертировать посетителей мобильной версии сайта, приходящих из любых источников, в пользователей мобильного приложения и атрибутировать их.
Настройка
Существует две версии OneLink Smart Script:
OneLink Smart Script V2 (рекомендуется)/span>: Если вы впервые настраиваете OneLink Smart Script, лучше всего использовать эту версию. Его можно создать в пользовательском интерфейсе AppsFlyer без помощи разработчика. Если по каким-то причинам нужен разработчик, то его рабочая часть проще. И его также можно настроить с помощью Google Tag Manager. См. инструкции для разработчика
OneLink Smart Script V1 (устарело): Если у вас уже настроен Onelink Smart Script, используйте документацию к этой версии, чтобы поддерживать и редактировать этот скрипт. Примечание: Примечание. Хотя это необязательно, рассмотрите переход на версию V2 для правильного получения атрибуций по показам посредством OneLink Smart Script.
Настройка OneLink Smart Script
Чтобы настроить Smart Script, вы можете:
- Встроить скрипт на свой сайт.
- Или использовать Google Tag Manager.
Объем работ
Кто задействован
|
Необходимые условия
|
Как создать OneLink Smart Script
- В AppsFlyer в боковом меню выберите Нанимать > Веб-приложение > Умный скрипт.
-
Для новых пользователей
- Нажмите кнопку Начать.
- Выполните шаги 4 и далее.
- Нажмите кнопку + Новый Smart Script в верхней части страницы.
- Следуйте инструкциям на экране, чтобы дать название Smart Script.
- Выберите шаблон OneLink, на котором будет основан скрипт. В шаблоне содержатся базовые настройки перенаправления.
- Сопоставьте параметры, которые должен содержать исходящий URL. Эти параметры основаны на параметрах входящего URL. Примечание: Параметр медиа-источника (pid) является обязательным.
- Выберите исходящий параметр/измерение для сопоставления.
Часто это имя параметра AppsFlyer, которое нельзя изменить, но в некоторых случаях вам нужно ввести имя параметра. - Настройте значение исходящего параметра на основе одного из следующего:
- Параметры входящего URL: Перечислите один или несколько возможных параметров входящего URL, которые необходимо заменить параметром исходящего URL. Значения параметров входящего URL будут значениями параметра исходящего URL.
- Пример: any_param_name, utm_param_name. Если utm_param_name найден во входящем URL, его значение будет использоваться в качестве значения выбранного вами параметра исходящего URL.
- Smart Script проводит поиск в списке параметров слева направо и сопоставляет первое совпадение с URL исходящего параметра.
- Разработчики называют этот список параметров ключами.
- Значение по умолчанию: Значение по умолчанию: введите желаемое значение по умолчанию для исходящего параметра, если параметр входящего URL не найден или если в списке нет параметров входящего URL.
- Пример: Пример: если во параметре входящего URL перечислены any_paramname, utm_paramname и если ни один из параметров в списке не найден, то в качестве значения исходящего параметра будет использовано значение по умолчанию.
- Значения для переопределения: Значения для переопределения: настройте одно или несколько значений из входящего URL вместе со значениями исходящего URL, на которые вы хотите их заменить.
- Пример: Пример: Для параметра кампании, если значение во входящем URL — campaign_name, значение в исходящем URL может быть изменено на new_campaign_name.
- Параметры входящего URL: Перечислите один или несколько возможных параметров входящего URL, которые необходимо заменить параметром исходящего URL. Значения параметров входящего URL будут значениями параметра исходящего URL.
- [Необязательно] Нажмите + Новый параметр для сопоставления дополнительных параметров. Посмотрите все дополнительные аргументы (конфигурации параметров), которые вы можете использовать.
- Выберите исходящий параметр/измерение для сопоставления.
-
Выберите способ внедрения Smart Script на вашем сайте:
- Встроить скрипт на свой сайт.
- Или использовать Google Tag Manager.
- Нажмите Тестировать, чтобы протестировать скрипт на странице тестирования Smart Script. Убедитесь, что сгенерирован правильный исходящий URL.
- Клик
- Сохранить, чтобы сохранить изменения.
-
Сохранить и сгенерировать, чтобы сохранить настройки и создать скрипт.
- Нажмите Скачать скрипт.
- Если вы решили встроить скрипт на свой сайт: Отправьте скрипт своему веб-разработчику для реализации и скажите ему, что делать с сгенерированным исходящим URL. Например, разместить его за кнопкой CTA на мобильном сайте или представить QR-код в полной версии сайта. Инструкции для разработчика
- Если вы выбрали использование Google Tag Manager:
- В Google Tag Manager создайте новый тэг, присвойте ему имя, нажмите Tag Configuration (Конфигурация тэга) и выберите Custom HTML (Пользовательский HTML).
- В поле HTML вставьте сгенерированный код Smart Script.
- Нажмите Triggering (Триггер), создайте новый триггер, дайте ему имя и выберите Trigger Configuration (Конфигурация триггера), например, все просмотры страниц. Дополнительные сведения см. в документации GTM.
- Нажмите Сохранить.
- Укажите веб-разработчику, что нужно сделать со сгенерированным исходящим URL. Например, разместить его за кнопкой CTA на мобильном сайте или представить QR-код в полной версии сайта. Инструкции для разработчика
- Сохраненные скрипты можно просмотреть в выпадающем меню.
Важно!
Каждый раз, когда вы обновляете скрипт, его нужно внедрять заново.
Как изменить или удалить скрипт
- Нажмите на стрелку раскрывающегося списка рядом с названием Smart Script.
Здесь вы увидите все сохраненные скрипты. - Нажмите на значок карандаша рядом со скриптом, который вы хотите отредактировать.
- Выполните действия, описанные в разделе Как создать OneLink Smart Script.
- Нажмите на значок корзины, чтобы удалить Smart Script.
Важно!
Каждый раз, когда вы обновляете скрипт, его нужно внедрять заново.
Как продублировать скрипт
- Перейдите к Smart Script, который вы хотите продублировать.
- Нажмите на кнопку дубликата на верхнем баннере
- Выполните действия, описанные в разделе Как создать OneLink Smart Script.
Структура аргументов
OneLink Smart Script использует аргументы для генерации исходящего URL на основе параметров входящего URL и аргументов, определенных в скрипте. Аргумент afParameters имеет структуру, состоящую из нескольких других аргументов (параметров), используемых для атрибуции и диплинкинга, каждый из которых содержит структуру (которую разработчики называют объектом конфигурации), содержащую ключи, значения для переопределения и значение по умолчанию, как описано в следующей таблице.
Аргумент | Описание | Пример |
---|---|---|
Параметры входящего URL (разработчики называют их ключами) |
|
|
Значение по умолчанию |
|
Пример: ['web_video'] Для параметра канала channel в скрипте, если параметр in_channel не найден, в качестве значения channel используется web_video. |
Значения для переопределения |
|
Пример: {'video': 'video_new'} Для параметра channel в скрипте, если входящее значение video, скрипт меняет его на video_new в исходящей ссылке. |
Аргументы
OneLink Smart Script использует аргументы для генерации исходящего URL на основе параметров входящего URL и аргументов, определенных в скрипте.
Аргументы (параметры и значения) для реализации Smart Script
Аргумент | Замечания | Запишите свои значения (для себя или для разработчика) | |
---|---|---|---|
oneLinkURL (обязательно) |
|
||
afParameters (обязательно)
|
Медиа-источник (обязательно) |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
campaign |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
|
channel (канал) |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
|
ad |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
|
Группа объявлений |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
|
deepLinkValue |
|
Ключи: Значение по умолчанию: Значения для переопределения: |
|
afSub1-5 |
Объект конфигурации для af_sub[1-5]. |
Ключи: Значение по умолчанию: Значения для переопределения: |
|
Ключ googleClickIdKey |
Укажите, как назвать параметр, который несет в себе GCLID. |
||
Другие (настраиваемые) параметры запроса |
|
ParamKey: Ключи: Значение по умолчанию: Значения для переопределения: |
Расширенные аргументы
В следующей таблице описаны аргументы, которые технически подкованные маркетологи или разработчики могут реализовать в Smart Script.
Расширенные аргументы (параметры и значения) для реализации в Smart Script
Аргумент | Замечания | Запишите свои значения (для себя или для разработчика) | |
---|---|---|---|
referrerSkipList |
|
|
|
urlSkipList |
|
|
Примеры использования
В следующих разделах представлены примеры использования Smart Script для некоторых распространенных сценариев кампаний / медиа-источников.
Параметры UTM
Чтобы настроить скрипт для параметров UTM:
- Создайте список параметров UTM во входящем URL-адресе (например, utm_source и utm_campaign) и сопоставьте их с параметрами исходящего URL (например, media_source и campaign).
-
Предоставьте их разработчику в списке аргументов.
Результат: Результат: значения входящих параметров (utm_source/span> и utm_campaign) используются для заполнения значений параметров (media_source и campaign) в исходящей ссылке.
Google Ads GCLID
В ходе обычного процесса атрибуции установки, которая пришла из кампаний Google Ads (содержащих параметр GCLID), пользователи, нажавшие на вашу рекламу, перенаправляются на URL страницы приложения в магазине приложений.
Поскольку в этом случае вы перенаправляете лидов из Google Ads на веб-страницу/целевую страницу, скрипт берет параметр GCLID из URL кампании установки Google Ads и помещает его в исходящий URL. Начиная со Smart Script версии 2.9.0, параметры GCLID, WBRAID и GBRAID, если они доступны, автоматически пересылаются «как есть» на исходящие URL-адреса, сгенерированные Smart Script.
Вы также можете сопоставить идентификаторы кликов с другими исходящими параметрами (af_sub[1-5]), чтобы они были доступны в отчетах AppsFlyer по сырым данным.
Примечание!
- Это относится к кампаниям установки. Для поисковых кампаний, не относящихся к ACI, то есть кампаний повторного привлечения, Google может быть атрибутирован в качестве медиа-источника, несмотря на выходные данные Smart Script.
- Если GCLID найден, скрипт ищет ключевое слово входящего параметра. Если находит, то помещает значение ключевого слова в исходящий URL в качестве значения af_keywords.
Необходимые условия: На панели управления Google Включите автоматическую пометку.
Если автоматическая пометка включена, URL-адрес целевой/strong> страницы содержит параметр GCLID/span>.
Настройка скрипта для сопоставления Google Ads GCLID с другими параметрами:
- Выберите параметр в исходящем URL, который будет содержать GCLID.
Практические рекомендации: Выбирать af_sub[1-5], чтобы данные отображались в отчетах по сырым данным AppsFlyer. -
Предоставьте их разработчику в списке аргументов. В результате в исходящем URL GCLID будет значением af_sub[1-5] param.
Чтобы уведомить Google Рекламу об этих установках:
- Получите данные GCLID из параметра af_sub[1-5] через CSV или Push API в режиме реального времени для каждой установки.
- Загрузите данные GCLID в Google вручную или через Google Ads API.
Примечание
Это решение GCLID официально не поддерживается и не рекомендуется компанией Google. В случае, если Google прекратит использование параметра GCLID, мы изменим скрипт в соответствии с изменениями. Нажмите кнопку Подписаться в заголовке статьи, чтобы получать информацию об обновлении статьи или скрипта.
Facebook FBCLID
В рекламе Meta есть идентификаторы кликов, которые называются ФБКЛИД. Начиная с версии Smart Script 2.8.1, FBCLID будет автоматически пересылаться "как есть" на исходящие URL-адреса, сгенерированные Smart Script. Вы также можете сопоставить идентификаторы кликов с другими исходящими параметрами, чтобы они были доступны в отчетах AppsFlyer по сырым данным.
Настройка скрипта для сопоставления FBCLID к другим параметрам:
- Выберите параметр в исходящем URL, который будет содержать GCLID.
Практические рекомендации: Выбирать af_sub[1-5], чтобы данные отображались в отчетах по сырым данным AppsFlyer. -
Предоставьте их разработчику в списке аргументов. В результате в исходящем URL FBCLID будет значением af_sub[1-5] param.
Ссылки в SRN, собственных медиа и других медиа-источниках
SRN, такие как Snapchat или Twitter, работают иначе, чем Google Реклама или кросс-платформа типа Meta Ads. Кампании этих SRN приводят ваших пользователей на веб-страницу / лендинг, и в ваш счет включаются клики от всех лидов, независимо от полученных мобильных пользователей.
Для этих SRN настройка скрипта такая же, как и для ссылок из собственных медиа или других медиа-источников, которые вы можете использовать.
Чтобы настроить скрипт:
- Составьте список названий параметров для медиа-источников и кампаний, которые содержатся во входящих ссылках.
-
Предоставьте их разработчику в списке аргументов.
TТип источника SRN/медиа должен быть значением источника медиа во входящем URL, а скрипт находит его и использует в качестве media_source в исходящем URL-адресе OneLink за кнопкой загрузки на веб-странице/лендинге. Если вы хотите изменить исходящий параметр media_source, укажите входящее значение медиа-источника и переопределите значение media_source в списке аргументов, который вы передаете разработчику.
Результат: Результат: Для этих SRN / медиа-источников значения параметров медиа-источника и кампании во входящей ссылке используются для заполнения значений параметров media_source и campaign в исходящей ссылке.
Пример
Входящий URL: https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social
Исходящий URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social
Ссылки атрибуции AppsFlyer
Ссылки атрибуции AppsFlyer можно использовать, когда медиа-источник является рекламной сетью, из которой пришел клик. Когда вы настраиваете такую ссылку в AppsFlyer, у вас есть возможность добавить параметр URL-адрес перенаправления (af_r) с желаемым путем URL на ваш мобильный сайт для атрибуции переходов из веб-кампании в приложение. Возможно, вы не хотите, чтобы скрипт создавал исходящий URL-адрес OneLink, поскольку некоторые данные из исходного клика могут быть потеряны.
Действие Действие: используйте аргумент urlSkipList для составления списка параметров af_r/strong>.
Результат: Результат: если Smart Script находит параметр af_r во входящей ссылке, Smart Script не создает исходящий URL, и разработчик должен решить, какую ссылку поместить в качестве исходящего URL, и реализовать ее.
Пример
Входящий URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_r=hotel.me
Исходящий URL: Нет исходящего URL.
Сопоставление веб-реферов
Сопоставление веб-рефереров позволяет узнать, с какой страницы пользователи попали на ваш сайт (например, из результатов органического поиска), и, следовательно, обогатить имеющиеся в вашем распоряжении данные для анализа установок и повторных вовлечений, происходящих из потока Smart Script web-to-app.
Вы можете настроить Smart Script на сбор этой информации из поля Referer
Referer заголовка HTTP целевой страницы или сайта. Это поле содержит базовый URL страницы, с которой пользователи перешли по ссылке на вашу веб-страницу.
Чтобы настроить скрипт для сбора информации о веб-реферере
- Откройте страницу Smart Script
- В разделе сопоставления веб-реферера выберите ключ параметра исходящего URL для значения веб-реферера:
- af_channel — параметр доступен на дэшбордах и в сырых данных
- af_sub1-5 — параметр доступен в сырых данных в столбцах af_sub1-5 и в столбце исходного URL.
- Настраиваемый параметр — состоит из имени и значения параметра. Параметр показан в сырых данных в столбце исходного URL.
Об атрибуции органического поиска для повторных вовлечений с использованием универсальных ссылок и App Links см. здесь.
Десктоп
Большинство вариантов использования в этой статье пользователей, пришедших с мобильных устройств. Поэтому, когда они перенаправляются с мобильного сайта в магазин приложений, они могут сразу скачать ваше приложение.
Однако пользователи настольных компьютеров не должны сразу же отправляться в магазин приложений, потому что их устройство (настольный компьютер или ноутбук) не совместимо с загрузкой мобильных приложений.
Чтобы настроить скрипт для пользователей настольных компьютеров:
- В шаблоне OneLink задайте URL назначения для опции When link is clicked on desktop (Если ссылку нажимают на настольном ПК). URL должен перенаправлять пользователей на специальную страницу / лендинг. Лендинг может содержать веб-форму, в которой они вводят свои данные, чтобы получить SMS или электронное письмо со ссылкой для загрузки приложения. Вы сами должны создать веб-форму и указать ее URL в скрипте.
Результат: Скрипт определяет устройство или платформу, на которой находится пользователь. Если это десктоп, скрипт создает исходящий URL-адрес OneLink, который перенаправляет пользователя на специальную страницу / лендинг.
См. также Конверсия от ПК до приложения.
QR коды
Вместо кнопки со ссылкой Smart Script отображает на вашей веб-странице QR-код.
Чтобы отобразить QR-код:
- Убедитесь, что при настройке Smart Script вы используете версию Smart Script 2.6+.
- Скажите своему разработчику, чтобы он следовал этим инструкциям для создания QR-кода с помощью Smart Script.
-
[Рекомендуется] Попросите разработчика:
- Настроить QR-код, добавив логотип вашего приложения в центр QR-кода и настроив цвет.
- QR-код надо показывать, когда пользователи просматривают страницу на настольном компьютере, а когда пользователи используют мобильное устройство, надо показать кнопку со ссылкой.
Результат: Скрипт отображает QR-код вместо кнопки с URL-адресом за ней.
Пример
Входящий URL:
https://hotel.me/qr_code.html?incmp=gogo&inmedia=email
Исходящий URL:
https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo
Исходящий QR-код:
Показы
Умный скрипт OneLink можно использовать для подсчета показов на вашем сайте. Для этого разработчику необходимо Вызов функции показа. Затем установки атрибутируются показам с помощью Атрибуция по просмотрам.
Примечание:
- Подсчет показов производится в дополнение к подсчету кликов обычным URL, созданным Smart Script. Smart Script можно использовать для подсчета кликов, показов или и того, и другого.
- Атрибуция по просмотрам с помощью Smart Script работает только на мобильных устройствах, но не на настольных ПК.
Чтобы атрибутировать новые установки этим показам (то есть использовать атрибуцию по просмотрам):
- Убедитесь, что при настройке Smart Script вы используете версию Smart Script 2.3+.
- Скажите своему разработчику, чтобы он вызвал функцию показов в Smart Script.
- Убедитесь, что атрибуция по просмотрам включена.
Важно!
Начиная с 1 февраля 2023 года (стабильный релиз Chrome 110), компания Google внесла некоторые изменения, чтобы уменьшить количество данных User Agent. Чтобы правильно получать атрибуции по показам посредством OneLink Smart Script, необходимо использовать OneLink Smart Script версии 2.3 и выше.
Дополнительные сведения
Вопросы и ответы
Будет ли работать входящий URL для генерации ссылок OneLink, если пользователь перейдет на другую страницу сайта?
Да. Да. Параметры входящего URL сохраняются в течение всего сеанса просмотра и применяются к параметрам исходящей ссылки OneLink, созданной Smart Script. Для получения дополнительной информации о реализации см. наш хаб разработчиков.
Почему я получаю ошибку при внедрении Smart Script через Google Tag Manager?
Иногда, когда вы создаете Smart Script в AppsFlyer и пытаетесь вставить его в Google Tag Manager (GTM), появляется ошибка «JavaScript too long» (Слишком длинный JavaScript). Если это произошло, удалите тег GTM и создайте новый.
Можно добавить параметры, которых нет в списке?
Да. На странице OneLink Smart Script нажмите на + Новый параметр для сопоставления дополнительных параметров.
- Новые параметры могут быть пользовательскими или зарезервированными AppsFlyer параметрами, которые не перечислены в выпадающем списке.
- Посмотрите все дополнительные аргументы (конфигурации параметров), которые вы можете использовать.
- Используйте опцию Custom (Пользовательский) из выпадающего списка и ваш параметр в поле Параметры исходящего URL.
Например, чтобы добавить is_retargeting в качестве параметра, в сопоставлении для поля будет выбрано Custom, а затем наш параметр is_retargeting в поле Параметры исходящего URL.
Группа объявлений и другие параметры не отображаются в выпадающем списке
При создании или добавлении новых параметров мы рекомендуем отключить все блокировщики рекламы, установленные в вашем браузере. Иногда блокировщики рекламы удаляют опцию, если в ней есть слово «Ad» (реклама).
В каких браузерах работает Smart Script?
Smart Script использует Javascript и должен работать во всех браузерах.
Спецификации и ограничения
Спецификация |
Примечания |
---|---|
Схема URI |
Даже если в шаблоне OneLink задана схема URI для открытия приложения для имеющихся пользователей, для ссылок, созданных с помощью Smart Script, параметр af_dp со схемой URI должен быть добавлен в URL-адреса разработчиком как настраиваемый параметр. |
# во входящем URL |
Smart Script сталкивается с проблемами при обработке входящих URL-адресов, содержащих символ хэша (#) перед параметрами запроса (обозначаются знаком ?). В таких случаях Smart Script возвращается к значениям по умолчанию. |