Настройка OneLink Smart Script V2

Краткий обзор. Настройте OneLink Smart Script, чтобы конвертировать и атрибутировать посетителей мобильной версии сайта, приходящих из любых источников, в пользователей мобильного приложения.

7901_Smart_Script_flow_1920x1080_2__1_.png

 Материалы по теме

Чтобы получить полное представление о работе со Смарт-баннерами, ознакомьтесь со следующими статьями:

Настройки

Существует две версии OneLink Smart Script:

OneLink Smart Script V2 (рекомендуется). Если вы настраиваете OneLink Smart Script впервые, предпочтительно использовать эту версию. Скрипт можно сгенерировать в пользовательском интерфейсе AppsFlyer без помощи разработчика. Если по какой-то причине требуется разработчик, его задача стала проще. Кроме того, скрипт можно настроить с помощью Google Tag Manager. См. инструкции для разработчика

OneLink Smart Script V1 (устаревшая). Если Onelink Smart Script у вас уже настроен, сведения по поддержке и редактированию скрипта см. в документации к этой версии.  Примечание. Хотя это не обязательно, рассмотрите миграцию на версию V2. 

 Примечание

Нажмите кнопку Подписаться в заголовке статьи, чтобы получать информацию об обновлении статьи или скрипта.

Настройка OneLink Smart Script

Чтобы настроить Smart Script, вы можете:

  • Встроить скрипт на свой сайт.
  • Или использовать Google Tag Manager.

Кто задействован

  • Рекламодатель:
    • Решает, что должен содержать исходящий URL, на основе аргументов в скрипте, обрабатывающих входящий URL. Это определяет данные атрибуции и диплинкинга, которые добавляются к исходящему URL, либо путем изменения входящего URL, либо путем принудительного ввода определенных значений.

    • Генерирует Smart Script в пользовательском интерфейсе AppsFlyer. 

    • Проверяет, что все кампании, ведущие на мобильный сайт, имеют входящие URL с параметрами, на которые работает скрипт.
    • Тестирует Smart Script
  • Веб-разработчик:
    • Проверяет, что скрипт работает на мобильном сайте/страницах, на которых он должен работать.
    • Использует значение результата по мере необходимости, например, чтобы разместить его в качестве ссылки на кнопке CTA на вашем сайте.
    • Может потребоваться для создания QR-кодов с помощью скрипта.
    • Может потребоваться, чтобы вручную добавить дополнительные аргументы в скрипт.

Необходимые условия

Объем работ

Чтобы настроить OneLink Smart Script:

  1. В AppsFlyer перейдите в раздел Интерфейсы и диплинкинг > Web-to-app > Smart Script.
  2. Выберите шаблон OneLink, на котором будет основан скрипт. В шаблоне содержатся базовые настройки перенаправления.
  3. Сопоставьте параметры, которые должен содержать исходящий URL. Эти параметры основаны на параметрах входящего URL. Примечание. Параметр медиа-источника (pid) является обязательным.
    1. Выберите исходящий параметр / измерение для сопоставления.
      Часто это имя параметра AppsFlyer, которое нельзя изменить, но в некоторых случаях необходимо ввести свое имя параметра.
    2. Настройте значение исходящего параметра на основе одного из следующего:
      • Параметры входящего URL: укажите один или несколько возможных параметров входящего URL, которые вы хотите заменить параметром исходящего URL. Значения параметров входящего URL будут значениями параметра исходящего URL.
        • Пример: any_param_name, utm_param_name. Если во входящем URL-адресе найден параметр utm_param_name, его значение будет использоваться в качестве значения выбранного параметра исходящего URL.
        • Smart Script проводит поиск в списке параметров слева направо и сопоставляет первое совпадение с URL исходящего параметра.
        • Разработчики называют этот список параметров ключами.
      • Значение по умолчанию: введите желаемое значение по умолчанию для исходящего параметра, если параметр входящего URL не найден или если в списке нет параметров входящего URL.
        • Пример: если во параметре входящего URL перечислены any_paramname, utm_paramname и если ни один из параметров в списке не найден, то в качестве значения исходящего параметра будет использовано значение по умолчанию.
      • Значения для переопределения: настройте одно или несколько значений из входящего URL вместе со значениями исходящего URL, на которые вы хотите их заменить.
        • Пример: Для параметра кампании, если значение во входящем URL — campaign_name, значение в исходящем URL может быть изменено на new_campaign_name.
    3. [Необязательно] Нажмите + Новый параметр для сопоставления дополнительных параметров. Посмотрите все дополнительные аргументы (конфигурации параметров), которые вы можете использовать.
  4. Выберите способ внедрения Smart Script на вашем сайте:
    • Встроить скрипт на свой сайт.
    • Или использовать Google Tag Manager.
  5. Нажмите Создать.
  6. Нажмите Скачать скрипт.
  7. Если вы выбрали встраивание скрипта в ваш сайт: отправьте скрипт вашему веб-разработчику для реализации и сообщите ему, что делать со сгенерированным исходящим URL. Например, разместить его за кнопкой CTA на мобильном сайте или представить QR-код в полной версии сайта. Инструкции для разработчика
  8. Если вы выбрали использование Google Tag Manager:
    1. В Google Tag Manager создайте новый тэг, присвойте ему имя, нажмите Tag Configuration (Конфигурация тэга) и выберите Custom HTML (Пользовательский HTML).
    2. В поле HTML вставьте сгенерированный код Smart Script.
    3. Нажмите Triggering (Триггер), создайте новый триггер, дайте ему имя и выберите Trigger Configuration (Конфигурация триггера), например, все просмотры страниц. Дополнительные сведения см. в документации GTM.
    4. Нажмите Сохранить.
    5. Укажите веб-разработчику, что нужно сделать со сгенерированным исходящим URL. Например, разместить его за кнопкой CTA на мобильном сайте или представить QR-код в полной версии сайта. Инструкции для разработчика
  9. Протестируйте сценарий на странице тестирования Smart Script. Убедитесь, что сгенерирован правильный исходящий URL.

Важно! Каждый раз, когда вы обновляете скрипт, его нужно внедрять заново.

Структура аргументов

OneLink Smart Script использует аргументы для генерации исходящего URL на основе параметров входящего URL и аргументов, определенных в скрипте. Аргумент afParameters имеет структуру, состоящую из нескольких других аргументов (параметров), используемых для атрибуции и диплинкинга, каждый из которых содержит структуру (которую разработчики называют объектом конфигурации), содержащую ключи, значения для переопределения и значение по умолчанию, как описано в следующей таблице.

Аргумент Описание Пример
Параметры входящего URL (разработчики называют их ключами)
  • Список строк
  • Список возможных параметров во входящем URL, которые ищет скрипт, значение которых помещается в качестве значения в исходящем URL.
  • Скрипт выполняет поиск слева направо и останавливается на первом совпадении.
  • Пример: ['in_channel', 'utm_channel']
  • Для параметра channel (канал) в скрипте скрипт ищет во входящей ссылке значение in_channel и использует его в качестве значения для channel.
Значение по умолчанию
  • Строка
  • Укажите, каким должно быть значение "fallback".
  • Если параметр не найден в списке ключей, в исходящем URL используется значение по умолчанию defaultValue.
  • Вы можете принудительно установить значение по умолчанию, передав пустой список ключей.

Пример: ['web_video']

Для параметра канала channel в скрипте, если параметр in_channel не найден, в качестве значения channel используется web_video.

Значения для переопределения

  • Словарь {string: string}
  • Перечислите значения во входящем URL, которые вы хотите изменить в исходящей ссылке, а также то, на что вы хотите их заменить.
  • Скрипт заменяет значения param входящего URL на определенные вами значения. 

Пример: {'video': 'video_new'}

Для параметра channel в скрипте, если входящее значение video, скрипт меняет его на video_new в исходящей ссылке.

Объект конфигурации 

Аргументы

OneLink Smart Script использует аргументы для генерации исходящего URL на основе параметров входящего URL и аргументов, определенных в скрипте.

Аргумент Примечания Запишите свои значения (для себя или для разработчика)
oneLinkURL (обязательно)
  • Укажите домен шаблона OneLink + идентификатор шаблона. Примечание: это не URL настраиваемой ссылки OneLink!
  • Пример: yourbrand.onelink.me/A1b2
  • Пример брендированного домена: click.yourbrand.com/A1b2
 

afParameters

(обязательно)

 

 

 


mediaSource

(обязательно)

  • Объект конфигурации для медиа-источника.
  • Пример:
    • Ключи: ['incoming_mediasource’' 'utm_source']
    • Значение по умолчанию: ['any_source']
    • Значения для переопределения: {twitter: 'twitter_int', orig_src: 'new_src'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

campaign

  • Объект конфигурации для кампании.
  • Пример:
    • Ключи: ['incoming_campaign', 'utm_campaign']
    • Значение по умолчанию: ['any_campaign_name']
    • Значения для переопределения: {campaign_name: 'new_campaign_name'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

channel

  • Объект конфигурации для канала.
  • Пример:
    • Ключи: ['incoming_channel', 'utm_channel']
    • Значение по умолчанию: ['any_video']
    • Значения для переопределения: {video: 'new_video'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

ad

  • Объект конфигурации для рекламы.
  • Пример:
    • Ключи: ['incoming_ad', 'utm_ad']
    • Значение по умолчанию: ['any_ad_name']
    • Значения для переопределения: {ad_name: 'new_ad_name'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

adSet
  • Объект конфигурации для группы объявлений.
  • Пример:
    • Ключи: ['incoming_adset', 'utm_adset']
    • Значение по умолчанию: ['any_ad_name']
    • Значения для переопределения: {adset_name: 'new_adset_name'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

deepLinkValue
  • Объект конфигурации для deep_link_value.
  • Пример:
    • Ключи: ['product_id', 'page_name']
    • Значение по умолчанию: 'new_offers_page'
    • Значения для переопределения: {twenty_percent_off: 'thirty_percent_off'}

Ключи:

Значение по умолчанию:

Значения для переопределения:

afSub1-5

Объект конфигурации для af_sub[1-5].

Ключи:

Значение по умолчанию:

Значения для переопределения:

googleClickIdKey

Укажите, как назвать параметр, который несет в себе GCLID.
Внимание! Для отображения в отчетах AppsFlyer по сырым данным параметр должен быть одним из af_sub[1-5].

 
Другие (настраиваемые) параметры запроса
  • Перечислите любые другие параметры, которые вы хотите включить в исходящий URL OneLink для атрибуции или диплинкинга, вместе с их объектами конфигурации.
  • Название настраиваемого параметра указывается разработчиком как paramKey в объекте конфигурации.
  • Пример:
    • paramKey: 'deep_link_sub1'
    • Ключи: ['page_id']
    • Значение по умолчанию: 'page1'
    • Значения для переопределения: {page12: 'new_page12'}

ParamKey:

Ключи:

Значение по умолчанию:

Значения для переопределения:

Аргументы (параметры и значения) для реализации Smart Script

Расширенные аргументы

В следующей таблице описаны аргументы, которые технически подкованные маркетологи или разработчики могут реализовать в Smart Script. 

Аргумент Примечания Запишите свои значения (для себя или для разработчика)
 
referrerSkipList
  • Список строк в реферере HTTP для конкретного клика (например, Twitter или Facebook), которые, если будут найдены, заставят Smart Script вернуть значение  null. Это может быть полезно для таких SRN, как Twitter и Facebook, для которых клики уже попали в отчеты.
  • Внедрение этого аргумента приводит к тому, что скрипт НЕ генерирует URL OneLink.

 

urlSkipList
  • Список строк в URL для конкретного клика (например, af_r), которые, если будут найдены, заставят Smart Script вернуть null. Это может быть полезно, если вы используете ссылку атрибуции AppsFlyer с параметром af_r для перенаправления пользователей на ваш мобильный сайт и не хотите, чтобы данные из исходного клика были потеряны.
  • Внедрение этого аргумента приводит к тому, что скрипт НЕ генерирует URL OneLink.

 

Расширенные аргументы (параметры и значения) для реализации Smart Script

ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ

В следующих разделах представлены примеры использования Smart Script для некоторых распространенных сценариев кампаний / медиа-источников.

Параметры UTM

Чтобы настроить скрипт для параметров UTM:

  1. Создайте список параметров UTM во входящем URL-адресе (например, utm_source и utm_campaign) и сопоставьте их с параметрами исходящего URL (например, media_source и campaign). 
  2. Предоставьте их разработчику в списке аргументов.

Результат: значения входящих параметров (utm_source и utm_campaign) используются для заполнения значений параметров (media_source и campaign) в исходящей ссылке. 

Google Ads GCLID

В ходе обычного процесса атрибуции установки, которая пришла из кампаний Google Рекламы (содержащих параметр GCLID), пользователи, нажавшие на вашу рекламу, перенаправляются на URL страницы приложения в магазине приложений.

Так как в данном случае вы перенаправляете потенциальных клиентов из Google Рекламы на веб-страницу / лендинг, скрипт берет параметр GCLID из URL-адреса кампании установки в Google Рекламе и помещает его в исходящий URL в указанном вами выходном параметре af_sub[1-5].

Внимание!

  • Это относится к кампаниям установки. Для поисковых кампаний, не относящихся к ACI, то есть кампаний повторного привлечения, Google может быть атрибутирован в качестве медиа-источника, несмотря на выходные данные Smart Script. 
  • Если GCLID найден, скрипт ищет ключевое слово входящего параметра. Если находит, то помещает значение ключевого слова в исходящий URL в качестве значения af_keywords.

Необходимые условия: На дэшборде Google включите автоматические теги.
Если автоматические теги включены, URL содержит параметр GCLID.

Чтобы настроить скрипт для Google Ads GCLID:

  1. Выберите параметр в исходящем URL, который будет содержать GCLID.
    Рекомендация: выберите af_sub[1-5], чтобы данные отображались в отчетах AppsFlyer по сырым данным.
  2. Предоставьте их разработчику в списке аргументов.

Результат: в исходящем URL значением параметра af_sub[1-5] является GCLID.

Чтобы уведомить Google Рекламу об этих установках:

  1. Получите данные GCLID из параметра af_sub[1-5] через CSV или Push API в режиме реального времени для каждой установки.
  2. Загрузите данные GCLID в Google вручную или через Google Ads API.

 Примечание

Это решение GCLID официально не поддерживается и не рекомендуется компанией Google. В случае, если Google прекратит использование параметра GCLID, мы изменим скрипт в соответствии с изменениями. Нажмите кнопку Подписаться в заголовке статьи, чтобы получать информацию об обновлении статьи или скрипта.

Идентификатор клика Facebook

В Facebook Ads есть идентификаторы кликов. Если вы хотите, чтобы этот идентификатор был доступен в сырых данных AppsFlyer, возьмите ID клика Facebook и поместите его в исходящий URL в выбранный вами выходной параметр af_sub[1-5].

Чтобы настроить скрипт для идентификатора клика Facebook:

  1. Выберите параметр в исходящем URL, который будет содержать идентификатор клика Facebook.
    Рекомендация: выберите af_sub[1-5], чтобы данные отображались в отчетах AppsFlyer по сырым данным.
  2. Предоставьте их разработчику в списке аргументов.

Результат: в исходящем URL значением параметра af_sub[1-5] является идентификатор клика Facebook.

Ссылки в SRN, собственных медиа и других медиа-источниках

SRN, такие как Snapchat или Twitter, работают иначе, чем Google Реклама или кросс-платформа типа Facebook. Кампании этих SRN приводят ваших пользователей на веб-страницу / лендинг, и в ваш счет включаются клики от всех лидов, независимо от полученных мобильных пользователей. 

Для этих SRN настройка скрипта такая же, как и для ссылок из собственных медиа или других медиа-источников, которые вы можете использовать. 

Чтобы настроить скрипт:

  1. Составьте список названий параметров для медиа-источников и кампаний, которые содержатся во входящих ссылках.
  2. Предоставьте их в списке аргументов веб-разработчику.
    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.

Результат: если 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.

Десктоп

В большинстве случаев, описанных в этой статье, пользователи приходят с мобильных устройств. Поэтому при переходе с мобильного сайта в магазин приложений они могут сразу же загрузить ваше приложение.

Однако пользователи настольных компьютеров не должны сразу же отправляться в магазин приложений, потому что их устройство (настольный компьютер или ноутбук) не совместимо с загрузкой мобильных приложений. 

Чтобы настроить скрипт для пользователей настольных компьютеров:

  • В шаблоне OneLink задайте URL назначения для опции When link is clicked on desktop (Если ссылку нажимают на настольном ПК). URL должен перенаправлять пользователей на специальную страницу / лендинг. Лендинг может содержать веб-форму, в которой они вводят свои данные, чтобы получить SMS или электронное письмо со ссылкой для загрузки приложения. Вы сами должны создать веб-форму и указать ее URL в скрипте. 

Результат: скрипт определяет устройство или платформу, на которой находится пользователь. Если это десктоп, скрипт создает исходящий URL-адрес OneLink, который перенаправляет пользователя на специальную страницу / лендинг.

См. также Конверсия от ПК до приложения.

Агентства

Установки атрибутируются агентствам с помощью параметра af_prt.

Чтобы добавить этот параметр атрибуции с помощью OneLink Smart Script, скажите своему разработчику следовать этим инструкциям.  

Результат: скрипт определяет дополнительный параметр в входящем URL-адресе с названием агентства и добавляет параметр af_prt в исходящий URL.

 Пример

Входящий URL: https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency

Исходящий URL: https://hotel.me/pid=email&c=gogo&af_prt=agency

QR коды

Вместо кнопки со ссылкой Smart Script отображает на вашей веб-странице QR-код. 

Чтобы отобразить QR-код:

  1. Убедитесь, что при настройке Smart Script вы используете версию Smart Script 2.1+.
  2. Скажите своему разработчику, чтобы он следовал этим инструкциям для создания QR-кода с помощью Smart Script.
  3. Рекомендация: скажите разработчику, что QR-код надо показывать, когда пользователи просматривают страницу на настольном компьютере, а когда пользователи используют мобильное устройство, надо показать кнопку со ссылкой. 

Результат: скрипт отображает QR-код вместо кнопки с привязанным к ней URL. Примечание: QR-коды, созданные с помощью Smart Script, нельзя настроить.

 Пример

Входящий 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 Smart Script можно использовать для подсчета показов на сайте. Для этого разработчику необходимо вызвать функцию показов. Тогда установки атрибутируются показу по методу атрибуции по просмотрам.

Примечание:

  • Подсчет показов производится в дополнение к подсчету кликов обычным URL, созданным Smart Script. Smart Script можно использовать для подсчета кликов, показов или и того, и другого.
  • Атрибуция по просмотрам с помощью Smart Script работает только на мобильных устройствах, но не на настольных ПК.

Чтобы атрибутировать новые установки этим показам (то есть использовать атрибуцию по просмотрам): 

  1. Убедитесь, что при настройке Smart Script вы используете версию Smart Script 2.2+.
  2. Скажите своему разработчику, чтобы он вызвал функцию показов в Smart Script.
  3. Убедитесь, что атрибуция по просмотрам включена.
  4. [Необязательно] Если вы хотите изменить значение окна атрибуции по просмотрам, по умолчанию составляющее 1 день, то вы или ваш разработчик должны добавить параметр af_viewthrough_lookback с новым значением. Например, af_viewthrough_lookback=1d.

Спецификации и ограничения

Субъект

Примечания

Схема URI

Даже если в шаблоне OneLink задана схема URI для открытия приложения для имеющихся пользователей, для ссылок, созданных с помощью Smart Script, параметр af_dp со схемой URI должен быть добавлен в URL-адреса разработчиком как настраиваемый параметр.