Чем мы можем помочь?

Поиск

[Устаревшая версия] Настройка OneLink Smart Script V1

  • Обновлено

Вкратце: Используйте OneLink Smart Script для конверсии посетителей мобильной версии сайта, приходящих из любых источников, в пользователей мобильного приложения, и их атрибуции. Примечание: Хотя это и не обязательно, рекомендуем перейти на OneLink Smart Script V2. 

7901_Smart_Script_flow_1920x1080_2__1_.png

Настройка

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

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

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

Зоны ответственности

Кто участвует

  • Рекламодатель: 

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

    • Проверяет, что все кампании, ведущие на мобильный сайт, имеют входящие URL с параметрами, на которые работает скрипт. 
  • Веб-разработчик:
    • Настраивает данные для инициализации скрипта. 
    • Вводит сеттеры, необходимые для создания исходящих URL-адресов OneLink на основе параметров входящего URL-адреса, предоставленных маркетологом. Сюда входят обязательные и необязательные параметры.  
    • Встраивает скрипт на сайт или определенные страницы. 

Требования

Чтобы реализовать скрипт на веб-странице:

  1. Решите, какие параметры/значения должен содержать автоматически генерируемый исходящий URL-адрес OneLink. См. список параметров, которые можно использовать. 
    • Убедитесь, что у всех кампаний с входящими URL-адресами есть параметры, с которыми работает скрипт (и которые можно подставить как параметры pid и c). 
  2. Предоставьте список параметров веб-разработчику.
  3. Попросите разработчика выполнить инструкции для разработчиков и внедрить скрипт, чтобы создавалась правильная исходящая ссылка.

Параметры

Параметры/значения, предоставляемые веб-разработчику для внедрения Smart Script

Параметр/значение Специфика Запишите свои значения (для разработчика)
oneLinkURL (обязательно)
  • Укажите домен шаблона OneLink + идентификатор шаблона. Примечание. Не пользовательский URL-адрес ссылки OneLink!
  • Пример: yourbrand.onelink.me/A1b2
  • Пример брендированного домена: click.yourbrand.com/A1b2
 
pidKeysList (медиаисточники)
  • Перечислите все параметры медиаисточника во входящем URL-адресе, которые будут подставлены как параметр медиаисточника (pid) в исходящий URL-адрес.
  • Пример: ['af_pid', 'utm_source']
  

pidOverrideList
  • Для медиаисточников, которые вы хотите изменить в исходящей ссылке, перечислите значения медиаисточника во входящем URL-адресе и укажите, на что их нужно заменить.
  • Пример: {
    'twitter': 'twitter_int',
    'snapchat': 'snapchat_int',
    'some_social_net': 'some_social_net_int'
    }

 

pidStaticValue
  • Укажите, каким должен быть ваш резервный медиаисточник "fallback".
  • Если параметр медиаисточника не найден в вашем pidKeysList, в исходящем URL-адресе в качестве медиаисточника (pid) используется pidStaticValue.
  • Пример: 'website' или 'landing_page'

 
campaignKeysList (кампании)
  • Перечислите все параметры кампании во входящем URL-адресе, которые будут переданы как параметр кампании (c) в исходящем URL-адресе.
  • Пример: ['af_campaign', 'utm_campaign']

 
campaignStaticValue
  • Укажите, какой должна быть ваша резервная кампания.
  • Если параметр кампании не найден в вашем campaignKeysList, в исходящем URL-адресе в качестве кампании (c) используется campaignStaticValue.
  • Пример: 'website' или 'landing_page'

 
gclIdParam
  • Укажите, как назвать параметр, который содержит GCLID.
    Важно! Для отображения в отчетах AppsFlyer по сырым данным параметр должен быть одним из af_sub[1-5].
 
skipList
  • Перечислите строки в HTTP-реферере, которые отключают Smart Script для определенного клика (например, Twitter или Facebook). Если строки найдены, Smart Script не запускается. Это может быть полезно для таких SRN, как X Ads и Meta Ads, по которым уже зарегистрированы клики.
  • Если вы хотите, чтобы Smart Script всегда запускался, даже для SRN, попросите разработчика передать пустой список исключений.
  
Другие параметры запроса
  • Перечислите любые другие параметры, которые вы хотите включить в исходящий URL-адрес OneLink для атрибуции или диплинкинга.
  • Добавьте deep_link_value для диплинкинга.
    • Помимо добавления параметра, вам и вашему разработчику нужно внедрить логику диплинкинга. Подробнее.
  • Вы можете либо использовать параметры из входящего URL-адреса, либо принудительно задать статическое значение. 
 

Использование когорты

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

Meta ads—кроссплатформенная атрибуция

Meta ads — это SRN, которая не использует внешние ссылки для атрибуции.

При первом запуске приложения AppsFlyer запрашивает у Meta, взаимодействовал ли пользователь ранее (в течение последних 7 дней) с рекламным объявлением приложения. Если пользователь взаимодействовал с рекламным объявлением рекламодателя в Facebook, Meta выполняет самоатрибуцию. Meta ads также подразумевает кроссплатформенность, а это означает, что пользователь может взаимодействовать с кампаниями любого типа, мобильными и другими, на любой платформе, и при этом Meta ads выполняет атрибуцию самостоятельно.

Действие: Попросите разработчика использовать метод skipList, чтобы отключить Smart Script для Meta ads (или любых других строк по вашему выбору). Если Meta или любая из строк в списке исключений присутствуют в HTTP-реферере клика, Smart Script возвращает null.

Примечание: на кроссплатформенную атрибуцию Meta может повлиять отказ пользователей предоставлять идентификатор устройства, как и ожидается у пользователей iOS 14 в 2021 году.

Google Ads—параметры GCLID и UTM

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

Так как в данном случае вы перенаправляете лиды из Google Ads на веб-/лендинг-страницу, скрипт берет параметр GCLID из URL-адреса кампании установки Google Ads и добавляет его в исходящий URL-адрес в выбранный вами выходной параметр af_sub[1-5]. Внимание! Это относится к кампаниям установки. Для поисковых кампаний, не относящихся к ACI, то есть кампаний повторного вовлечения пользователей, Google может быть атрибутирован в качестве медиа-источника, несмотря на выходные данные Smart Script. 

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

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

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

Результат:

  • Значения параметров медиаисточника и кампании (utm_source и utm_campaign) во входящей ссылке используются для заполнения значений параметров pid и c в исходящей ссылке. 
  • В исходящем URL-адресе значением параметра af_sub[1-5] является GCLID.

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

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

 Примечание:

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

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

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

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

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

  1. Составьте список названий параметров для медиа-источников и кампаний, которые содержатся во входящих ссылках.
  2. Предоставьте их в списке параметров веб-разработчику.
    T    ип SRN/медиаисточника должен быть значением медиаисточника во входящем URL-адресе; скрипт находит его и использует как значение pid в исходящем URL-адресе OneLink за кнопкой загрузки на веб-странице/лендинге. Если вы хотите изменить исходящий pid, укажите в списке переопределения pid значение входящего источника медиатрафика и новое значение pid. 

Результат: для этих SRN/медиаисточников значения параметров медиаисточника и кампании во входящей ссылке используются для заполнения значений параметров pid и c в исходящей ссылке. 

 Пример

Входящий URL: https://hotel.me/af_pid=twitter&af_c=big_social

Исходящий URL: Нет исходящего URL.

Ссылки атрибуции AppsFlyer

Ссылки атрибуции AppsFlyer можно использовать, когда медиа-источник является рекламной сетью, из которой пришел клик. При настройке такой ссылки в AppsFlyer вы можете добавить параметр пути URL-адреса перенаправления (af_r) с нужным URL-путём на ваш мобильный сайт для атрибуции переходов из веб-кампании в приложение.  

Результат: если во входящей ссылке есть параметры af_r и af_redirect=true, скрипт целевой страницы не вносит никаких изменений. Он оставляет прямые ссылки с веб-/целевой страницы на магазины приложений без изменений. 

 Пример

Входящий URL-адрес: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_redirect=true&af_r=hotel.me

Исходящий URL-адрес: тот же

Десктоп

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

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

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

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

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

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

Характеристики и ограничения

Ограничение Специфика
Менеджер тегов

Smart Script нельзя реализовать через менеджер тегов. См. OneLink Smart Script V2 или Smart Banners в качестве альтернативного решения для атрибуции Web-to-app.

Tags