Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Настройка умных скриптов

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

Перед началом работы

Что нужно знать, чтобы начать работу.

Требования

  • Права администрирования и редактирования.
  • (Необязательно) Настройка диплинков в Adjust SDK: iOS | Android.

Доступность

Решение для роста:

Решение «Умные скрипты» предоставляется в качестве дополнения. Для получения доступа к нему свяжитесь с представителем Adjust или напишите по электронной почте sales@adjust.com.

Создание умного скрипта

  1. В разделе Campaign Lab выберите Умные скрипты .
  2. Выберите Новый умный скрипт .

Выберите базовую ссылку

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

  1. Выберите приложение в раскрывающемся меню.
  2. Выберите базовую ссылку
  3. Выбранную ссылку для одной платформы (например, Android) можно объединить со ссылкой для другой платформы (например, iOS). Благодаря этому у вас будет один интеллектуальный скрипт, работающий на обеих платформах для вашего приложения.
Base link combined

Настройка резервной логики атрибуции

Выберите способ атрибуции пользователей, которые взаимодействуют с вашей ссылкой после предшествующего этому взаимодействию клика. Можно выбрать один из двух вариантов:

  • К предыдущему объявлению
  • К смарт-баннеру

При выборе атрибутирования пользователей к предыдущему объявлению в ссылку добавляется параметр fallback_click. Adjust учитывает для атрибуции ссылки с параметром fallback_click только в том случае, если нет других доступных ссылок. Это означает, что к ссылкам с параметром fallback_click атрибутируются только те пользователи, которые в другом случае были бы органическими. Для получения дополнительной информации о том, как это работает, см. как работает резервная атрибуция.

Fallback attribution logic

Сопоставление параметров

Параметры из входящего URL-адреса должны быть сопоставлены параметрам исходящего URL-адреса, то есть ссылке Adjust. Например, ЕСЛИ присутствует параметр utm_campaign , его значение будет сопоставлено параметру campaign в Adjust. Если такого параметра не существует, будет использовано фолбэк-значение по умолчанию, определенное вами.

Есть 3 типа параметров, которые можно сопоставлять:

  1. Параметры кампании : такие, которые относятся к настройке структуры кампании, например channel, campaign, adgroup, creative.
SS Campaign params
  1. Параметры мест назначения пользователя / диплинков : вы можете либо передавать пути диплинков, либо использовать маршрутизацию на основе URL-адресов.
SS Deep linking params
  1. Дополнительные параметры : вы можете добавить дополнительные данные, передавая пользовательские пары «ключ-значение» либо используя параметр лейбла Adjust.
SS Additional data

Сопоставление партнеров

  • Партнеры и соответствующие токены ссылок, которым следует присвоить атрибуции, если они являются источником трафика, сопоставляются. Например, если источником трафика являются веб-кампании Facebook (Meta) (что определяется исходя из доступности параметра fbclid или fbpid во входящем URL-адресе), то соответствующий токен сетевой ссылки получает атрибуцию.
  • Вы можете выбрать один из следующих вариантов:
  1. Выбрать партнера из списка готовых партнеров. В этом случае нужно просто выбрать токен ссылки, поскольку условия трафика предварительно настроены (например, ЕСЛИ ttclid существует -> Партнер = TikTok).
  2. Выбрать настройку параметров предпочитаемого партнера/канала. В этом случае вам необходимо указать условия трафика (например, utm_source содержит информацию о социальных сетях и соответствующий токен ссылки). Это особенно полезно для настройки собственных/заработанных медиаканалов, где уникальные идентификаторы кликов недоступны во входящем URL-адресе.

Примечание . Если вы используете интеллектуальные скрипты для отслеживания трафика из веб-сайта в приложение для партнера, не нужно настраивать трекинговую ссылку Adjust в панели управления партнера (в полях итогового URL-адреса или шаблона отслеживания). Вам нужно всего лишь настроить кампанию таким образом, чтобы она перенаправляла пользователя на URL целевой страницы с добавлением правильных параметров (например, UTM-меток). Это связано с тем, что теперь скрипт генерирует ссылку Adjust с правильным токеном ссылки и размещает ее за кнопкой призыва к действию на целевой странице. Использование двух методов отслеживания одновременно может привести к дублированию кликов и несоответствиям в отчетах.

Развертывание скрипта

1. Копирование скрипта

После создания скрипта вы будете перенаправлены на страницу «Просмотр скрипта», где сможете нажать кнопку Скопировать скрипт .

2. Развертывание скрипта

1. Встройте скрипт на свой веб-сайт

  1. Отправьте скрипт своему веб-разработчику для реализации.
  2. Обратите внимание, что для создания ссылки Adjust (исходящего URL-адреса) Smart Script предоставляет две функции. waitForEnrichedLink — асинхронная функция, возвращающая значение типа Promise. Она возвращает ссылку Adjust, дополненную идентификатором пикселя Facebook, если он доступен.createLink возвращает ссылку Adjust без промежуточных шагов, но в большинстве случаев не может считать идентификатор пикселя Facebook.

Если идентификатор пикселя Facebook важен для вашего сценария применения, рекомендуем использовать waitForEnrichedLink.

Если вы хотите, чтобы ссылка Adjust была доступна без каких-либо задержек, можете использовать createLink или даже обе функции вместе. Например, сначала покажите кнопку / призыв к действию «Скачать приложение» со ссылкой, возвращенной функцией createLink, а позже замените ее расширенной ссылкой, как только будет получен результат функции waitForEnrichedLink.

  1. Сообщите ему, что делать со ссылкой Adjust (исходящим URL-адресом), сгенерированной умными скриптами. Например, попросите разместить их за кнопкой «Загрузить приложение» / призывом к действию ИЛИ добавьте QR-код на свой сайт для ПК.

2. Разверните скрипт через Менеджер тегов Google

  1. Откройте Менеджер тегов Google.
  2. Выберите «Теги» -> «Создать».
  3. Выберите «Конфигурация тега», затем выберите «Настраиваемая HTML-разметка» и добавьте в нее <script>. Вставьте код, скопированный из Suite, в скрипт, не забудьте закрывающий тег /script.
    <script>
      // Paste Smart Script configuration you’ve copied from the Suite
      // The code contains the smart script, mapping and call for link creation
    </script>
  1. Скрипт вернет исходящий URL /ссылку Adjust, и вы сможете встроить эту ссылку под кнопку загрузки. При необходимости обратитесь к своей команде разработчиков, чтобы узнать, как связать сгенерированную ссылку Adjust с кнопкой / призывом к действию «Скачать приложение».

В приведенном ниже примере предполагается наличие на странице кнопки «Скачать» с идентификатором download_button, и добавляется действие, открывающее ссылку при нажатии на эту кнопку. После того как функция waitForEnrichedLink возвращает ссылку Adjust с идентификатором пикселя Facebook, обработчик кнопки обновляется и предоставляет возможность открыть расширенную ссылку. Если идентификатор пикселя Facebook не важен для вашего сценария применения, можете безопасно удалить вызов waitForEnrichedLink и весь связанный с ним код, вплоть до закрывающего тега </script>.

example script deploy

Пример кода интеграции

// Создание ссылки
var link = AdjustSmartScript.createLink(mapping);

var downloadButton = document.getElementById('download_button');
var openLinkFn = function () { window.open(link) };

// Открытие ссылки при нажатии кнопки «Скачать»
downloadButton.addEventListener('click', openLinkFn);
  
// Асинхронное создание ссылки
// Ожидание возвращения идентификатора пикселя Facebook. Эту часть можно удалить, если идентификатор пикселя Facebook
// не важен для вашего сценария применения
AdjustSmartScript.waitForEnrichedLink(mapping)
  .then(function (enrichedLink) {
    // Создается расширенная ссылка
    // При нажатии кнопки скачивания открывается расширенная ссылка
    downloadButton.addEventListener('click', function () { window.open(enrichedLink) });

    downloadButton.removeEventListener('click', openLinkFn);
  })
  .catch(function (error) {
    // Произошла ошибка и расширенная ссылка не была создана
    console.log(error);
  });

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

  2. Результат полной реализации будет следующим: когда пользователь нажимает кнопку «Загрузить» на целевой странице веб-сайта, ссылка Adjust перенаправляет пользователя по указанному пути и атрибутирует все конверсии приложения обратно к исходному источнику веб-трафика.

Необязательно — обновление скрипта

Если вы решите отредактировать умный скрипт после его развертывания на своем веб-сайте, ваш разработчик должен будет вручную повторно развернуть/обновить скрипт, чтобы изменения вступили в силу. Эта операция не выполняется автоматически.

Тестирование умных скриптов

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

  1. В браузере перейдите в консоль инструментов разработчика.
  2. Перейдите на веб-страницу, где вы реализовали умные скрипты.
  3. Если логи с префиксом [adjust-smart-script] отсутствуют, обновите страницу. Если вы по-прежнему не видите логов, убедитесь, что:
    • ваш код не подавляет ведение лога, вызывая AdjustSmartScript.setLogLevel('error') или AdjustSmartScript.setLogLevel('none');
    • ваш код вызывает функцию AdjustSmartScript.createLink(params).

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

Пример лога:

[adjust-smart-script]: нет сконфигурированных сетей
[adjust-smart-script]: используйте defaultLinkToken для создания ссылки adjust
[adjust-smart-script]: найденное значение для кампании — new_campaign
[adjust-smart-script]: найденное значение для рекламной группы — some_adset
[adjust-smart-script]: найденное значение для креатива — logo_image
[adjust-smart-script]: преобразованное значение для ref_code — id+my_product
[adjust-smart-script]: неправильно сконфигурированный диплинк: не задан параметр androidAppSchema

Инструмент тестирования смарт-скриптов

Инструмент тестирования смарт-скриптов — это тестовая платформа, которая моделирует обработку скриптом входящего URL целевой страницы и генерирует исходящий URL (ссылку Adjust). Следуя указаниям этого руководства, вы сможете использовать инструмент тестирования смарт-скриптов для проверки правильности работы логики взаимодействия с партнерами, обработки параметров и логики маркеров ссылок до или во время запуска веб-сайта.

Что эта функция делает?

Инструмент тестирования смарт-скриптов имитирует выполнение скрипта для заданного URL целевой страницы и отображает результирующий исходящий URL (ссылку Adjust), сгенерированный настроенной конфигурацией скриптов.

Инструмент тестирования смарт-скриптов поддерживает два варианта ввода данных:

  • Ручной ввод тестового URL.
  • Выбор одного из предварительно заполненных примеров URL-адресов (например, URL-адреса, содержащие UTM и идентификаторы кликов из распространенных источников, таких как Meta, Google и TikTok).

Инструмент тестирования смарт-скриптов помогает проверить поведение настроенной конфигурации скриптов, включая следующие аспекты:

  • Логика взаимодействия с партнерами (например, выбор партнера на основе настроек скриптов).
  • Обработка параметров (например, какие входящие параметры переносятся в исходящую ссылку Adjust).
  • Поведение обработки условий трафика (например, применимо ли данное условие к входному URL-адресу).
  • Логика токена ссылки, используемая в исходящей ссылке Adjust.

Примеры типичных сценариев применения:

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

Как это работает?

Инструмент тестирования смарт-скриптов моделирует обработку скриптом URL целевой страницы.

  1. Нужно предоставить URL целевой страницы (либо настраиваемый URL, либо предварительно заполненный пример URL-адреса).

  2. Инструмент тестирования смарт-скриптов моделирует выполнение скрипта с использованием настроенной конфигурации.

  3. Инструмент тестирования смарт-скриптов генерирует исходящий URL-адрес (ссылку Adjust) на основе конфигурации скриптов, используя, в частности:

    • логику взаимодействия с партнерами;
    • обработку параметров;
    • условия трафика;
    • логику токена ссылки.

  4. Полученная исходящая ссылка Adjust покажет, соответствуют ли выходные данные ожидаемому поведению конфигурации.

smart script test tool