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

Настройка реферальных кампаний для пользователей

Если пользователь приглашает друга загрузить приложение и зарегистрироваться в нем, вы можете отправить ему индивидуальное вознаграждение в приложении.

Настройка пользовательских рефералов происходит следующим образом:

  1. Создайте брендированную ссылку для вашей реферальной программы. Эту ссылку следует разместить за компонентом приглашения в приложении.
  2.  Прикрепите параметр label. Параметр лейбла служит для передачи уникального идентификатора реферала. Вам понадобится настроить приложение так, чтобы параметр лейбла заполнялся идентификатором реферала до отправки URL ссылки приглашенному пользователю.
  3. Настройте передачу идентификаторов рефералов в ваши системы. Настройте колбэк атрибуции или колбэк сервера для получения идентификатора реферала, когда новый пользователь загружает и открывает приложение по реферальной ссылке. Затем ваша система должна будет применить вознаграждение пользователя на основе полученного идентификатора реферала.

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

Перед настройкой рефералов пользователей необходимо сделать следующее:

  • Если приложение предназначено для iOS, проверьте включение функции вероятностного моделирования. Таким образом гарантируется работа рефералов в мобильной веб-среде.
  • Убедитесь, что ваша система настроена на выдачу вознаграждений пользователям путем генерации и применения реферальных кодов. Обязательно проверьте следующие параметры:
    • Ваш сервер может генерировать идентификатор реферала, когда пользователь нажимает кнопку для отправки приглашения.
    • Ваш сервер может заполнить плейсхолдер label идентификатором реферала.
    • Ваш сервер может обработать значение плейсхолдера label из колбэка Adjust, чтобы начислить вознаграждение на реферальный счет, на счет реферала или на оба счета.

1. Создайте брендированную ссылку для вашей реферальной программы

см. также:

Adjust позволяет создавать короткие ссылки с использованием названия вашего бренда. Например: example.go.link. Таким образом устанавливается подлинность ссылок, улучшается идентичность бренда и увеличивается показатель кликабельности. Дополнительные сведения см. в руководстве по настройке брендированного домена.

  1. Следуйте руководству по настройке брендированных ссылок.
  2. Рассмотрите возможность включения вероятностного моделирования в настройках атрибуции, которое обеспечит точность атрибуции при различных размещениях.

2. Добавьте параметр лейбла к ссылке

Adjust использует параметр label, чтобы получать пользовательские данные, не связанные с данными атрибуции. В случае с рефералами пользователей этот параметр позволяет таргетировать пользователей приложения с помощью уникального идентификатора.

Обязательно добавьте параметр label к вашей брендированной ссылке вместе с другими параметрами. Вы можете использовать брендированные ссылки для удобства пользователей.

Брендированные ссылки
Небрендированная ссылка
https://example.go.link?adj_t=abc123&adj_label={user_id}
Примечание:

Значение параметра label недоступно в Datascape, и сети не смогут получать его значение через постбэки. Этот параметр доступен только при экспорте сырых данных или на уровне SDK через колбэки атрибуции.

При использовании колбэка сервера для обмена идентификатором реферала с Adjust вы можете использовать динамический параметр колбэка.

3. Настройте передачу идентификаторов рефералов в ваши системы

Когда приглашенный пользователь загружает и открывает приложение, происходит одно из следующих событий:

  • Колбэк атрибуции: Adjust SDK получает колбэк атрибуции, содержащий параметр label, заполненный идентификатором реферала, который получает ваше приложение.
  • Колбэк установки: ваш сервер получает колбэк установки от Adjust, который содержит идентификатор реферала, используя либо параметр label, либо динамический параметр колбэка.

Затем ваша система должна выдать вознаграждение пользователю на основе полученного идентификатора реферала.

Колбэк атрибуции (рекомендуется)

Важно:

Adjust не может предоставлять информацию о пользователе на iOS, если пользователь не предоставил согласие на платформе App Tracking Transparency (ATT) в соответствии с политикой конфиденциальности Apple. За дополнительной информацией по этой теме обратитесь к своему представителю Adjust или по адресу support@adjust.com.

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

Колбэк установки

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

Чтобы настроить колбэки установки, выполните следующие действия:

  1. Получите доступ к настройке колбэка сервера из карточки приложения или на вкладке Управление данными в настройках приложения.

    • (Только с правами администратора, редактора или с настраиваемым доступом к редактированию.) Чтобы настроить колбэк сервера из карточки приложения, в разделе AppView выберите Все приложения . Найдите свое приложение и выберите раздел Колбэки сервера .
    • Чтобы настроить колбэк сервера на вкладке Управление данными в настройках своего приложения, в разделе AppView выберите Все приложения . Выберите свое приложение, а затем откройте вкладку Управление данными .

  2. В разделе Колбэки сервера выберите Добавить колбэк > Инструкции по настройке .

  3. В списке Триггер колбэка выберите действие “install”.

  4. В поле Конечная точка сервера укажите URL-адрес конечной точки, на который вы хотите получать данные.

  5. (Дополнительно) Выберите Добавить условие , чтобы добавить условие в сочетании с плейсхолдерами и значениями. Колбэк будет запущен только при соблюдении этого условия.

  6. В разделе Плейсхолдеры нажмите Добавить плейсхолдер и выберите {install} из списка, чтобы динамически включать данные реферального кода пользователя в колбэк. Можно добавить несколько плейсхолдеров.

  7. Выберите Создать URL колбэка , чтобы создать закодированный URL колбэка.

Ниже приведен пример URL-адреса колбэка с добавленным параметром лейбла и рекомендуемыми плейсхолдерами:

https://myendpoint.test/?label={label}&adid={adid}&tracker_name={tracker_name}&gps_adid={gps_adid}&idfa={idfa}&idfv={idfv}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}

Отчеты

Adjust Datascape предоставляет агрегированную отчетность по вашей реферальной ссылке. Значение параметра label не отображается непосредственно в Datascape и доступно только через колбэк атрибуции или при экспорте сырых данных.

Руководство по тестированию

Совет:

При проведении тестирования на одном и том же тестовом устройстве обязательно следуйте инструкциям по удалению устройства.

Выполните следующие действия, чтобы проверить настройку рефералов пользователей:

  1. Поместите сгенерированную брендированную ссылку с добавленным параметром label за компонентом приглашения в вашем приложении.
  2. Выберите компонент приглашения и скопируйте ссылку. Проверьте, чтобы в параметре label был указан реферальный код.
  3. Вставьте ссылку в мессенджер или другую среду, которую будет использовать пользователь для обмена ссылкой.
  4. Подготовьте тестовое устройство, следуя разделу «Перед тем как начать» в руководстве Консоль тестирования.
  5. Выберите ссылку.
  6. Проверьте данные устройства в консоли тестирования, следуя следующим инструкциям.
  7. Проверьте, что вы получили параметр label в колбэках атрибуции или через колбэк сервера в вашей BI-системе.
  8. Предоставьте вознаграждение на основе полученного реферального кода.