Настройте атрибуцию для нескольких магазинов Android

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

Атрибуция приложений Android для нескольких магазинов 

AppsFlyer атрибутирует приложения независимо от магазина приложений. Имеются в виду магазин Google Play и сторонние магазины Android, такие как Amazon, Opera, GetJar, Baidu и Huawei (также известные как независимые (out-of-market) или альтернативные магазины приложений Android). Владельцы приложений, которые продвигают их в нескольких магазинах, могут использовать единый дэшборд, содержащий данные всех магазинов, или отдельный дэшборд для каждого магазина.  

Примечание

DashboardType_us-en-new.jpg

Единый дэшборд vs. отдельный дэшборд на магазин

  • Единый дэшборд: Единый дэшборд, объединяющий данные из всех магазинов, включая Google Play Store.
  • Дэшборд для каждого магазина приложений: Несколько дэшбордов — у каждого магазина есть свой дэшборд. Это значит, что число дэшбордов соответствует числу магазинов, которые предоставляют ваше приложение.
  Единый дэшборд
[Рекомендация]
 Дэшборду на каждый магазин
Имя пакета Android Используйте одно и то же (идентичное) название пакета независимо от выбранной опции.  
Название канала Настройка не требуется
  • При добавлении приложения в панели AppsFlyer, выбрав параметр «APK вне магазина Android», укажите канал.
  • Канал идентифицирует магазин.
  • Комбинация названия пакета Android и канала становится уникальным идентификатором каждого дэшборда AppsFlyer. 
  • Пример: Название пакета Android — com.abc.def, а канал — xyzdevicestore. Уникальный идентификатор дэшборда — com.abc.def-xyzdevicestore.
  • Если в APK указан канал, но приложения с таким значением нет, трафик будет приписан приложению по умолчанию — тому, у которого настройки канала пустые (Google Play Store). 
Заполнение поля install_app_store
  • Уникально идентифицирует магазин, предоставляющий приложение путем загрузки.
  • В случае Google Play Store это поле пустое. 
  • Название магазина указывается в манифесте/APK.
Не применимо
Шаблон OneLink Этот метод рекомендуется при работе с OneLink.  Не применимо 
Ссылки измерения/атрибуции  
  • Ссылки те же самые, независимо от магазина.
  • Чтобы перенаправлять пользователей в нужный магазин, задайте URL-адрес перенаправления с помощью параметра af_r
  • Для каждого магазина необходима уникальная ссылка.
  • Создайте их на странице Активные интеграции.
  • Идентификатор приложения — это имя канала, добавленное в конец имени пакета Android. Например: com.abc.def-def_store.
    Поэтому ссылки атрибуции будут различными.
Доступные варианты отчетности при наличии поля install_app_store Отчеты о сырых данных всегда содержат это поле. Для Обзора и Когорт свяжитесь с вашим менеджером, попросив его добавить необходимую функцию.  Не применимо 
Что нужно учитывать
  • Точность атрибуции Повторные установки из разных магазинов не приводят к завышенныму количеству установок.
  • Органические установки будут отражать органические установки APK из всех магазинов, находящихся в одном дэшборде.
  • В настоящий момент разбивка по магазинам доступна только в обзорном и когортном отчетах, а также в отчетах с сырыми данными.
  • Точность атрибуции Повторные установки учитываются, что приводит к менее точной атрибуции.
  • Просматривайте данные об органических и неорганических установках, а также событиях внутри приложения для каждого магазина (канала) на отдельных панелях приложений в AppsFlyer.
  • Чтобы показывать консолидированные отчеты по всем магазинам вместе, нужно использовать когорты.
  • Активируйте партнера (Активировать партнера включено) в каждом приложении стороннего магазина, где партнер проводит активную кампанию. Это помогает предотвратить расхождения в атрибуции, особенно при работе с сетями с собственной отчётностью (SRN).
     

     

     

Настройка

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

Для опции «Дэшборд на каждый магазин» повторите все операции для каждого магазина.  

Прежде чем начать

  • Определите соглашение об именах для канала и параметров install_app_store.
  • Используйте следующую таблицу имен для сопоставления каналов и магазинов.
  • Таблица используется разработчиком для подготовки APK.
Параметр Инструкции Единый дэшборд
[Рекомендация]
Дэшборду на каждый магазин
Имя пакета Android Одно и то же имя пакета для всех вариантов дэшбордов Если приложение уже присутствует в Google Play Store, используйте существующее имя пакета. Пример: comb.abc.def
Название канала Уникальное значение для каждого магазина. Не установлено. Оставьте пустым.  

Уникальное для каждого магазина. Задайте его значение в индивидуальном APK, который вы подготовили для магазина. Его также нужно настроить, когда вы добавляете приложение в AppsFlyer.  

Не указывайте канал для пакета APK магазина Google Play.  

Магазин установки приложения AF_STORE Уникальное значение для идентификации магазина Уникальное для каждого магазина. Задайте в APK через манифест. У каждого магазина свой APK.  Не установлено

Действия

Шаг Ответственность Единый дэшборд Дэшборду на каждый магазин
1 Разработчик Подготовка APK Подготовка APK
Маркетолог действий не требуется. Предполагается, что приложение уже активно в AppsFlyer.   Добавьте приложение в AppsFlyer. 
3 Маркетолог

Подготовьте ссылки атрибуции

 

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

Алгоритм действий

Единый дэшборд — подготовка APK

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

Магазин для загрузки определяется по параметру AF_STORE, который задается в SDK, как описано в этом разделе.   Параметр AF_STORE не чувствителен к регистру. Например: ABC, abc, Abc.    

Чтобы подготовить APK:

  1. Создайте копию сборки приложения. Примечание: Не меняйте название пакета Android. 
  2. Для идентификации конкретного магазина используйте один из следующих методов:
    • Метод манифеста: Чтобы идентифицировать магазин, добавьте следующий фрагмент кода внутрь тега <application> файла AndroidManifest.xml. Установите параметр AF_STORE для имени магазина приложений.

      <application>
         ...
         <meta-data android:name="AF_STORE" android:value="EnterStoreNameHere"/>
         ...
      </application>

      --ИЛИ--

    • Метод API Подготовьте отдельный APK для каждого альтернативного магазина приложений. Чтобы установить значение AF_STORE, вызовите API setOutOfStore. Задайте уникальное значение для каждого магазина.
       

      AppsFlyerLib.getInstance().setOutOfStore("EnterStoreNameHere")

Заданное здесь значение отображается в поле install_app_store сырых данных AppsFlyer. Это поле доступно:

Единый дэшборд — ссылки атрибуции

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

  1. В вашей ссылке атрибуции установите параметр URL-адрес вне магазина. Это подставляет af_rмакрос в атрибуционную ссылку, чтобы перенаправить пользователей на нужный лэндинг приложения в магазине. Например:&af_r=https://www.destinationurl.com 

     Примечание

    URL-адрес перенаправления по умолчанию URL-адрес приложения вне магазина установлен на странице Настройки приложения. Если это было настроено, нет необходимости обновлять ссылку атрибуции, потому что ссылки атрибуции, созданные для приложения, будут автоматически заполнены этим URL-адресом. Подробнее
  2. Добавьте af_r перенаправление в список разрешенных перенаправлений.
  3. Заполните af_rмакрос URL-адресом страницы приложения в магазине.
  4. Настройте дополнительные параметры ссылки атрибуции.
  5. Источники трафика вне магазинов используют сопоставление по ID для атрибуции, а вероятностное моделирование AppsFlyer служит резервным методом.
  6. Добавьте один или несколько заполнителей (placeholders) для идентификатора пользователя в URL-адрес ссылки:
    • android_id
    • advertising_id
    • oaid
  7. Скопируйте ссылку атрибуции и передайте ее партнеру рекламной сети.

По дэшборду на магазин — подготовка APK

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

Чтобы подготовить отдельный APK/манифест для каждого магазина:

  • Чтобы идентифицировать магазин, добавьте следующий фрагмент кода внутрь тега <application> файла AndroidManifest.xml. Установите для параметра Канал название магазина приложений.  

    <application>
         ...
         <meta-data android:name="CHANNEL" android:value="EnterStoreNameHere"/>
         ...
    </application>

    Примечание: Параметры чувствительны к регистру. Для названия канала необходимо использовать буквы только в верхнем или нижнем регистре (a-z или A-Z). Никакие другие символы, такие как дефис (-) или подчеркивание (_), не допускаются.

По дэшборду на магазин — добавление приложения

Добавьте дэшборд (приложение), который идентифицируется сочетанием имени пакета Android и канала, заданного в APK/манифесте. Пример: Если имя пакета Android – com.myapp, а название канала – abcstore, то уникальным именем для дэшборда будет com.myapp—abcstore.  

Чтобы добавить в AppsFlyer "по дэшборду на каждый магазин":

  1. В AppsFlyer в боковом меню выберите Настройки > Мои приложения и нажмите Добавить приложение.
  2. Выберите Android > В стороннем магазине.
  3. Завершите:
    • Название пакета Android Название пакета точно такое же, как оно отображается в пакете приложения.
    • Название канала: Уникальный идентификатор (название магазина), позволяющий различать дэшборды с одинаковым названием пакета. Убедитесь, что в APK используется то же значение, которое было подготовлено для магазина.
      Примечание: Для названия канала необходимо использовать буквы только в верхнем или нижнем регистре (a-z или A-Z). Никакие другие символы, такие как дефис (-) или подчеркивание (_), не допускаются.
    • URL-адрес приложения:
      • Содержит URL-адрес загрузки по умолчанию, который заполняет макрос af_r в ссылках атрибуции. Укажите URL-адрес места размещения APK или его лендинга. 
      • Его можно изменить для конкретной ссылки атрибуции при ее создании. 
  4. Нажмите Далее.
  5. Следуйте инструкциям в интерфейсе, чтобы завершить добавление приложения.  

Тестирование — оба варианта дэшбордов

Неорганические установки

Чтобы протестировать неорганические установки:

  1. Используйте устройство Android, на котором ваше приложение не установлено, или зарегистрируйте устройство.
  2. Создайте тестовую ссылку атрибуции с помощью OneLink. Используйте test в качестве названия медиа-источника ("&pid=test").
  3. Добавьте идентификатор рекламы (GAID, OAID или Android ID) к кликабельному URL-адресу.

    https://app.appsflyer.com/com.greatapp?pid=test
    &af_r=https://www.destinationurl.com&advertising_id=b5a3-78d9b5-0f12345-xxxx

    Отправьте себе ссылку атрибуции по электронной почте и нажмите на нее. После перенаправления не выполняйте установку из магазина. Вместо этого установите обновленную бета-версию приложения со встроенным SDK AppsFlyer, предназначенным для атрибуции, и запустите это приложение.

Единый дэшборд  Дэшборду на каждый магазин
  1. Посмотрите отчет с сырыми данными по установкам приложения на странице «Экспорт данных».
  2. Вы должны увидеть одну конверсию установки с медиа-источником test. В столбце Магазин установки приложения вы должны увидеть название магазина в том виде, в каком оно указано в файле manifest.xml.
  3. Вы также можете увидеть параметр "af_installstore": "STORE_NAME" в журналах установок. 
  1. Перейдите к нужному приложению через магазинный дэшборд.
  2. Посмотрите отчет о сырых данных по установкам для своего приложения на странице "Экспорт данных" или же посмотрите обзорную страницу приложения.
  3. Вы должны увидеть одну конверсию установки для медиа-источника test.

Органические установки

Чтобы протестировать органические установки:

  1. Используйте устройство Android, на котором ваше приложение не установлено, или же зарегистрированное устройство.
  2. Установите обновленную бета-версию приложения со встроенным SDK AppsFlyer, предназначенным для атрибуции, и запустите это приложение.
  3. Проверьте результаты:

Ожидаемые результаты

Единый дэшборд  Дэшборду на каждый магазин
Проверьте обзорную страницу Overview для новой органической установки (под медиа-источником "organic"). На данный момент при использовании метода единого приложения источники органических установок не указываются.
  1. Перейдите на дэшборд, а затем на страницу обзора приложения, которые относятся к тестируемому магазину.
  2. Вы должны увидеть одну конверсию установки для медиа-источника organic (органические).

Дополнительные функции

Привлечение пользователей из Facebook в магазин приложений Amazon  

  1. Настройте URL-адрес ссылки на приложение в настройках вашего приложения для Meta в разделе Android.
  2. Войдите в Meta как администратор приложения, перейдите по адресу https://developers.facebook.com/apps/ и выберите приложение.
  3. Перейдите к настройкам и найдите параметры для Android или добавьте платформу Android, если она еще не настроена.
  4. Введите необходимые данные, в том числе URL-адрес своего приложения в магазине приложений Amazon.

    outofstore_1.png
  5. На дэшборде AppsFlyer перейдите на страницу «Активные интеграции» и выберите Meta Ads, а потом введите тот же идентификатор приложения Facebook, который вы используете в Meta Ads при регистрации установок мобильных приложений из магазина с помощью AppsFlyer.

Получение данных — дополнительные отчеты AppsFlyer

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

  • Когортный:
    • Консолидируйте данные по нескольким дэшбордам (приложениям) в одном отчете
    • Просматривайте показатели эффективности каждого дэшборда с разбивкой по install_app_store
  • Pull API (для метода с одним приложением) API для получения сырые данные установок не содержат Магазин приложений для установки по умолчанию. Чтобы включить столбец, добавьте следующее в вызов Pull API: &additional_fields=install_app_store
  • Настраиваемый дэшборд (для метода с несколькими приложениями) Если вы используете подход с несколькими дэшбордами, используйте настраиваемый дэшборд, чтобы объединить данные о производительности из нескольких приложений в одном месте. 

Реализация реферера в сторонних магазинах Android

Атрибуция рефералов сторонних магазинов поддерживается в SDK следующим образом: 

  • Реферал магазина Samsung: Готовая встроенная поддержка
  • Реферал магазина Huawei: Зависимость должна быть добавлена вашим разработчиком, для инструкций смотрите Хаб разработчиков.
  • Реферал магазина Xiaomi GetApps: Зависимость должна быть добавлена вашим разработчиком, для инструкций смотрите Хаб разработчиков.
     

Сторонние магазины приложений для Android, у которых есть интеграция атрибуции реферера с AppsFlyer

Сторонний магазин приложений Дата начала Версия SDK
Магазин приложений Huawei Июль 2020 6.14.0+
Магазин Samsung Galaxy Декабрь 2020 6.1.1 +
Магазин Xiaomi GetApps Сентябрь 2022 г. 6.9.0 +

Реферал стороннего магазина в отчетах о сырых данных

Атрибуция реферера стороннего магазина отражается в отчетах с сырыми данными следующим образом:

  • Match type (Тип соответствия): название стороннего магазина, Например: huawei_referrer.
  • Участники: Если пользователь до установки приложения взаимодействовал с несколькими магазинами приложений, AppsFlyer считает эти взаимодействия участниками. Установка атрибутируется источнику последнего клика. Пример:
    • Пользователь нажимает рекламное объявление, показанное Google, перенаправляется в Play Store,  Пользователь не скачивает приложение.
    • Пользователь нажимает другое рекламное объявление и перенаправляется в магазин Samsung Galaxy Store, Пользователь скачивает и устанавливает приложение.
    • Атрибуция присваивается рекламной сети, перенаправившей пользователя в магазин Samsung Galaxy, а Google признаётся участником.

Устранение неполадок

Установки, атрибутированные приложению по умолчанию

Если вы создаете APK приложения с настройкой канала, но не создаете панель для него в аккаунте AppsFlyer: Установки атрибутируются приложению по умолчанию, обычно это приложение Google Play Store в вашем аккаунте. Если приложение по умолчанию не задано, данные не регистрируются.  

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

Характеристика Примечания
Перенаправление с помощью OneLink в различные магазины приложений В шаблоне OneLink можно задать несколько магазинов приложений, только если для всех магазинов имя пакета приложения одинаково и вы выбрали единый дэшборд. 
Установить магазин приложений Этот параметр недоступен для агентств и рекламных сетей.
Перенаправление OneLink в сторонний магазин Если ваше Android-приложение доступно исключительно через сторонний магазин, вы должны установить его статус в Google Play на "Опубликовано вне магазина" при добавлении приложения. Выбор любого другого статуса предотвратит перенаправление в сторонний магазин и приведет к сообщению об ошибке.
Доход от рекламы  af_ad_revenue значения не могут быть сгруппированы по значениям install_app_store.