Атрибуция приглашений пользователей

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

Invite_Attribution_new.png

 Обновление до iOS 14

Для атрибуции приглашений пользователя не используется IDFA, поэтому iOS 14 никак на это не влияет.

Атрибуция приглашений пользователя бесплатна на всех тарифных планах.

Обзор атрибуции приглашений пользователя

Почему полезно использовать атрибуцию приглашений пользователей?

  • Получайте информацию о самых активных пользователях: пользователи, которые приглашают друзей в ваше приложение, — это ценные заинтересованные пользователи, которых вы, возможно, захотите сохранить, поощрить или включить в кампанию ретаргетинга.
  • Используйте информацию о приглашающем пользователе, чтобы персонализировать первый опыт для нового пользователя: вместо стандартного приветственного сообщения у вас может быть персонализированное сообщение, которое гораздо больше привлечет нового пользователя. Например: «Добро пожаловать, Алексей! Пройдите туториал и присоединяйтесь к вашему другу Марии в эпической битве».
  • Знание затрат и ROI на приглашения пользователей позволяют получить более качественные результаты:
    Приглашения пользователей бесплатны? Не совсем. Они расходуют рекламную «недвижимость» вашего приложения, что может принести вам доход от рекламы. Обеспечивают ли приглашения пользователей положительный ROI по сравнению с другими инструментами? В некоторых случаях да, а в некоторых нет.

Вы можете использовать параметры стоимости AppsFlyer, чтобы назначить стоимость установкам по приглашению от пользователя на основе альтернатив.

 Пример

Баннер приносит вам 5 долларов за тысячу просмотров рекламы (вот отличный способ это измерить). В среднем, при коэффициенте конверсии просмотров в приглашения 2% и коэффициенте конверсии приглашений в установки 10% вы получаете 2 новых пользователя на каждые 1000 просмотров. Таким образом, использование этого баннера для рекламы приглашений стоит 5 долларов / 2 = 2,5 доллара за установку. Добавьте значение af_cost_value=2.5, чтобы отразить эту стоимость на дэшборде.

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

Как работает атрибуция приглашений пользователей?

Установки, атрибутированные по ссылке приглашения, отображаются на дэшборде под медиа-источником af_app_invites.

Каналы, используемые для отправки приглашений по эл. почте, СМС, в Facebook и т. д., отображаются в группе Channel под медиа-источником af_app_invites.

Invite_Attribution_2.png

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

Руководство для разработчика

Настройка OneLink

Для атрибуции приглашения используется ссылка OneLink, по которой приглашенный пользователь перенаправляется в соответствующий магазин приложений. С помощью OneLink также можно использовать отложенный диплинкинг. Отложенный диплинкинг открывает определенную активность, когда пользователь запускает приложение. Он также задает настраиваемый контент, чтобы пользователь оставался в контексте установки после приглашения.

Важно корректно настроить OneLink для приложения:

  • Настройте перенаправления с помощью ссылок OneLink.
  • Следуйте инструкциям по настройке отложенного диплинкинга, который предоставляет данные, необходимые для программной отправки пользователей к определенным активностям или для вознаграждения как приглашающего, так и приглашенного.
  • (Необязательно) Настройте диплинкинг с помощью OneLink. Это не обязательно, но может быть полезно в определенных сценариях. Например:
    • Вы создаете кампанию, в которой пользователи приглашают друзей установить приложение. Они оба получают бонусные баллы для использования в приложении. Если приглашенный пользователь установит приложение, то пригласивший пользователь получит 50 баллов, а приглашенный 100 баллов. Если у приглашенного пользователя уже есть приложение, то пригласивший пользователь получит 25 баллов, а приглашенный 50 баллов. Чтобы различать эти два случая, используйте отложенный диплинкинг для первого случая и диплинкинг для второго.

После завершения настройки OneLink возьмите соответствующий идентификатор шаблона OneLink.

Перед вызовом start в своем приложении задайте ссылку OneLink, которая вызывается в соответствии с идентификатором шаблона OneLink (в данном примере OPSz):

OL_template_id_en-us.jpg

 Примечание

Убедитесь, что используется корректный идентификатор шаблона OneLink. Иначе созданная ссылка атрибуции не будет работать.

Android iOS Unity V4
AppsFlyerLib.getInstance().setAppInviteOneLink("ymod");

Создание ссылки

На Android обязательно импортируйте следующие библиотеки:

import com.appsflyer.share.ShareInviteHelper;
import com.appsflyer.share.LinkGenerator;

Класс LinkGenerator создает URL-адрес приглашения в соответствии с различными методами настройки, которые позволяют передавать дополнительную информацию о клике. Эта информация доступна через onConversionDataSuccess, когда новый пользователь принимает приглашение и устанавливает приложение. Кроме того, параметры кампании и канала отображаются на дэшборде AppsFlyer.

Ссылки с приглашениями, сгенерированные SDK, имеют срок действия 180 дней.

Если по какой-то причине API недоступен, LinkGenerator возвращает длинную ссылку.

Android iOS Objective-C iOS Swift Unity V4
LinkGenerator linkGenerator = ShareInviteHelper.generateInviteUrl(MainActivity.this);
linkGenerator.setChannel("Gmail");
linkGenerator.addParameter("af_cost_value","2.5");
linkGenerator.addParameter("af_cost_currency","USD");
// optional - set a brand domain to the user invite link
linkGenerator.setBrandDomain("brand.domain.com");
CreateOneLinkHttpTask.ResponseListener listener = new CreateOneLinkHttpTask.ResponseListener() {
	@Override
	public void onResponse(String s) {
		Log.d("Invite Link", s);
    // write logic to let user share the invite link
	}

	@Override
	public void onResponseError(String s) {
		// handle response error
	}
};
linkGenerator.generateLink(MainActivity.this, listener);

 Примечания.

  • onResponse и onResponseError — это методы обратного вызова для генерирования ссылок OneLink. Они являются частью интерфейса CreateOneLinkHttpTask.ResponseListener и должны быть реализованы. Они используются для создания ссылок приглашений, которые можно размещать в различных представлениях в приложении.
  • К сгенерированной ссылке можно добавить любой из этих параметров ссылки атрибуции.
  • Специальные символы в значениях параметров необходимо закодировать при передаче в функцию LinkGenerator.
     

Параметры генератора для всех ссылок

Android iOS
Имя API Описание Использование

setChannel(String channel)

Канал отправки приглашения (напр., Facebook, Gmail и др.)

Рекомендованный

setCampaign(String campaign)

Название кампании

НЕОБЯЗАТЕЛЬНОЕ

setReferrerName(String referrerName)

Имя приглашающего пользователя

НЕОБЯЗАТЕЛЬНОЕ

setReferrerImageURL(String referrerImageURL)

URL-адрес аватара приглашающего пользователя

НЕОБЯЗАТЕЛЬНОЕ

setReferrerCustomerId(String referrerCustomerID)

Задайте customer_user_id приглашающего пользователя

НЕОБЯЗАТЕЛЬНОЕ

addParameter(String key, String value)

Один настраиваемый параметр с парой ключ-значение

НЕОБЯЗАТЕЛЬНОЕ

addParameters(Map<String, String> parameters)

Несколько настраиваемых параметров с парами ключ-значение

НЕОБЯЗАТЕЛЬНОЕ

setBrandDomain(String domain)

Имя домена бренда

НЕОБЯЗАТЕЛЬНОЕ

Требуется создание брендированных ссылок

Регистрация приглашений отправителя

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

Вы можете отправить обычное внутреннее событие или вместо этого использовать метод logInvite. logInvite — это готовое внутреннее событие приложения, инкапсулированное в API для простоты использования.

Android iOS
ShareInviteHelper.logInvite(context, channel, additionalParametersForTheEvent_optional);

Извлечение данных атрибуции после установки приложения приглашенным пользователем

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

{
	"attribute": "is_first_launch" = "true"
	"attribute": "click_time" = "2019-04-04 08:33:05.668"
	"attribute": "af_referrer_customer_id" = "CUSTOMER_USER_ID"
	"attribute": "shortlink" = "12a3b456"
	"attribute": "af_referrer_uid" = "1234567890123-4567890123456789012"
	"attribute": "af_siteid" = "com.company.app"
	"attribute": "install_time" = "2019-04-04 08:33:45.286"
	"attribute": "cost_cents_USD" = "0"
	"attribute": "campaign" = "None"
	"attribute": "af_click_lookback" = "7d"
	"attribute": "orig_cost" = "0.0"
	"attribute": "af_status" = "Non-organic"
	"attribute": "iscache" = "true"
	"attribute": "media_source" = "af_app_invites"
}

Подробнее об использовании данных о конверсиях: iOS и Android.

Использование ссылок для приглашения пользователей в кампаниях повторного вовлечения

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

Чтобы использовать ссылки для приглашения пользователей в целях повторного вовлечения, добавьте параметр is_retargeting и задайте для него значение true с помощью метода addParameter:

Android iOS Unity V4
linkGenerator.addParameter("is_retargeting", "true");

Вознаграждения за приглашение пользователей

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

Когда награждать

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

Вознаграждение пользователей за установку

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

  • af_referrer_uid — идентификатор AppsFlyer для пользователя, отправившего приглашение.
  • af_referrer_customer_id — это идентификатор клиента для пользователя, отправляющего приглашение. Отображается в данных о конверсиях только в том случае, если для этого пользователя установлен идентификатор клиента.

Используйте идентификатор приглашающего пользователя для вознаграждения за установку.

Дженни предлагает Нику установить ваше приложение.

  1. Когда Ник запускает приложение, приложение извлекает идентификатор приглашающего, т. е. Дженни.
  2. Приложение отправляет этот идентификатор на ваш сервер.
  3. На сервере добавьте идентификатор Дженни в список пользователей, которые получат вознаграждение.
  4. Когда Дженни запустит приложение, проверьте, что ее идентификатор включен в список пользователей, которых нужно наградить.
  5. Если идентификатор в списке, наградите ее.

Вознаграждение пользователей за событие в приложении

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

Процесс вознаграждения за внутренние события

Дженни предлагает Нику установить ваше приложение.

В ссылке приглашения задайте af_sub1

  1. Когда Дженни приглашает Ника, создайте ссылку для приглашения.
  2. Включите в ссылку параметр af_sub1=<JENNY_USER_ID>.

Ник устанавливает приложение и совершает покупку. После покупки в AppsFlyer отправляется внутреннее событие приложения. С этим событием связан параметр sub1=<JENNY_USER_ID>.

Используйте af_sub1, чтобы обновить список пользователей, которых нужно наградить

  1. Извлеките данные о событиях в приложении с помощью Pull API или получите их с помощью Push API.
  2. В этих данных найдите события, для которых в качестве медиа-источника указан af_app_invites.
  3. С такими событиями связан параметр af_sub1, в котором содержится идентификатор приглашающего.
  4. Сохраните идентификаторы приглашающих в списке пользователей, которых нужно наградить.

Наградите Дженни

  1. Когда Дженни запустит приложение, проверьте, что ее идентификатор включен в список пользователей, которых нужно наградить.
  2. Если идентификатор в списке, наградите ее.

Отображение на настраиваемом дэшборде

Ниже приведены примеры того, как данные о приглашении пользователей отображаются на настраиваемом дэшборде:

Invite_Attribution_3.png

Invite_Attribution_4.png

Ограничения

Ограничения Описание
Версия SDK Требуется SDK AppsFlyer версии 4.8.0+ и SDK Unity версии 4.17.0+.
Лэндинг приложений для социальных сетей Ссылка, созданная из приглашений пользователей, не может вести на лэндинг приложений социальных сетей.

 

Была ли эта статья полезной?