Настройка измерения дохода от покупок и подписок в приложении с помощью ROI360

Необходимые условия: Доступ к Google Play Console и проекту в Google Cloud.

Для того, чтобы привязать свой аккаунт разработчика Google Play к проекту в Google Cloud:

1. В Google Play Console зайдите в свой аккаунт разработчика Google Play.
2. Привяжите аккаунт к своему проекту в Google Cloud. Инструкции см. в этом разделе справки Google.
3. Активируйте API разработчика Google Play. Инструкции см. в этом разделе справки Google.

Необходимые условия: Доступ к Google Cloud Platform.

Для настройки сервисного аккаунта:

1. Создайте или выберите сервисный аккаунт:
   1. В Google Cloud Platform перейдите на страницу Service accounts (Сервисные аккаунты), затем нажмите Create Service Account (Создать сервисный аккаунт).
       
   2. Введите данные для сервисного аккаунта.
      
   3. Скопируйте адрес электронной почты.
      
   4. Нажмите Create and continue (Создать и продолжить).
      
   5. На шаге Grant this service account access to the project (Предоставить сервисному аккаунту доступ к проекту) выберите роль Pub/sub subscriber (Подписчик Pub/sub).
      
   6. Нажмите Продолжить > Готово.
      
2. Скачайте файл Service Account Private Key (Закрытый ключ сервисного аккаунта):
   1. В Google Cloud Platform перейдите в раздел Сервисные аккаунты, выберите из списка нужный аккаунт (тот, который вы только что создали) и нажмите на иконку More actions (Другие действия).
   2. Нажмите на Manage keys (Управление ключами).
      
   3. Нажмите Add key (Добавить ключ) > Create new key (Создать новый ключ).
      
   4. Во всплывающем окне Create private key (Создать закрытый ключ), в разделе Key type (Тип ключа) выберите JSON и нажмите Create (Создать).
   5. Нажмите Create (Создать). Загрузится файл JSON закрытого ключа.
      
   6. Сохраните файл ключа JSON, который нужно будет загрузить в AppsFlyer позже. Важно! Ключ необходимо сохранить; его нельзя будет загрузить позже. Если вы его не сохраните, вам придётся генерировать ключ заново.

Необходимые условия: Доступ администратора к AppsFlyer.

Чтобы загрузить закрытый ключ сервисного аккаунта в AppsFlyer:

1. В боковом меню AppsFlyer выберите Параметры > Настройки дохода и выберите своё приложение из списка.
   
2. На вкладке Покупки и подписки нажмите , чтобы загрузить файл JSON.
   
3. Загрузите файл JSON закрытого ключа.
4. Нажмите Сохранить.

Необходимые условия: Доступ к Google Play Console.

Примечание: После установки учётных данных и разрешений аккаунта службы может пройти некоторое время (иногда до 24 часов), прежде чем вы сможете их использовать. Это может привести к появлению ошибок на последующих этапах.

Настройка прав доступа к API в Google Play Console:

1. В Google Play Console перейдите в раздел Пользователи и разрешения, найдите созданный сервисный аккаунт и нажмите кнопку Пригласить новых пользователей.
   
2. Введите адрес электронной почты, который вы скопировали при настройке учётной записи на шаге 1.2.1.3.
    
3. В разделе Разрешения перейдите в Разрешения аккаунта и выберите оба варианта:
   • Просматривать финансовые данные, заказы и ответы на анкетирование после отмены.
   • Управлять заказами и подписками.
     
4. Нажмите Пригласить пользователя.
   
5. Во всплывающем окне подтверждения нажмите Отправить приглашение.
   

Для получения данных о доходах от покупок в приложении и подписок из Google Play можно либо:

• Создать тему, в которой AppsFlyer будет напрямую получать уведомления RTDN из Google Play. Это рекомендуемый вариант, и если вы его выберете, следуйте инструкции ниже.
• Установите AppsFlyer в качестве подписчика на уже существующую тему PUB/SUB. Если вы выбрали этот вариант вместо предыдущего, сразу переходите к следующему шагу.

Необходимые условия: Доступ к Google Play Console и пользовательскому интерфейсу AppsFlyer.

Чтобы отправлять уведомления Google Play непосредственно в AppsFlyer:

1. В боковом меню AppsFlyer выберите Настройки > Настройки доходов, выберите приложение, а во вкладке Покупки & подписки выберите Разрешить теме AppsFlyer получать сообщения RTDN напрямую от Google.
   
2. Скопируйте тему AppsFlyer в буфер обмена.
   
3. В Google Play Console > Главная, выберите приложение для просмотра. Откроется дэшборд.
   
4. Перейдите в меню Монетизация с Play > Настройка монетизации, а в разделе Выставление счетов Google Play убедитесь, что опция Включить оповещение в реальном времени активирована.
   
5. В поле Название темы вставьте адрес темы AppsFlyer, который вы скопировали.
   
6. В Содержание уведомлений выберите Подписки, аннулированные покупки и все одноразовые продукты.
   
7. Нажмите Сохранить изменения.
   Чтобы изменения вступили в силу, может потребоваться время (иногда вплоть до 24 часов). Поэтому не спешите проводить тестирование.

Примечание: Этот шаг предназначен только для тех случаев, когда вы не выбрали рекомендуемый способ получения данных о доходах от покупок в приложении и подписок от Google Play (отправление уведомлений в AppsFlyer напрямую). Если вы выполнили всё необходимое для выбора рекомендуемого метода и создали тему, в которой AppsFlyer напрямую получает RTDN-уведомления от Google Play, пропустите этот шаг.

Если вместо этого вы хотите сделать AppsFlyer подписчиком на вашу уже существующую тему PUB/SUB, следуйте инструкции ниже.

Необходимые условия: Доступ к Google Cloud Platform и пользовательскому интерфейсу AppsFlyer.

чтобы перенаправлять уведомления Google Play в AppsFlyer:

1. В боковом меню AppsFlyer выберите Настройки > Настройки доходов, выберите приложение, а во вкладке Покупки и подписки выберите Переадресовать сообщения по теме RTDN в AppsFlyer.
   
2. Скопируйте URL конечной точки в буфер обмена.
   
3. В Google Cloud Platform в вашем проекте найдите Pub/Sub.
   
4. В разделе Pub/Sub перейдите в раздел Темы и убедитесь, что у вас есть специальная тема pub/sub для подписок.
   
5. В Pub/Sub перейдите в раздел Подписки и нажмите Создать подписку.
   
6. Введите идентификатор подписки.
   
7. Выберите соответствующую тему pub/sub подписки из раскрывающегося списка.
   
8. Для Типа доставки выберите Push.
   
9. Вставьте URL-адрес конечной точки, который вы скопировали из AppsFlyer.
   
10. В Срок действия выберите Никогда не истекает.
    
11. Нажмите Create (Создать).
    
12. Перейдите в раздел Подписки и нажмите на нужное название темы.
    
13. Скопируйте название темы в буфер обмена.
    
14. В Google Play Console перейдите в Монетизация с Play > Настройка монетизации, а в разделе Выставление счетов Google Play в поле Название темы вставьте имя темы, которое было скопировано на предыдущем шаге.
    
15. В Содержание уведомлений выберите Подписки, аннулированные покупки и все одноразовые продукты.
    
16. Выберите Сохранить изменения.
    Чтобы изменения вступили в силу, может потребоваться время (иногда вплоть до 24 часов). Поэтому не спешите проводить тестирование.

Чтобы выбрать типы измерения доходов:

1. В боковом меню AppsFlyer выберите Настройка > Настройки доходов > Покупки и подписки и включите один из них или оба:
   • Валидация покупок через Google Play.
   • Атрибуция и учёт подписок с автопродлением.
     
2. [Необязательно] Установите флажок Разрешить AppsFlyer дедуплицировать транзакции, которые уже были учтены. Таким образом можно исключить дублирование записей транзакций.
3. [Необязательно] Выберите Разрешить AppsFlyer автоматически отслеживать от моего имени незавершённые и отложенные транзакции, а также транзакции возврата. Это позволит AppsFlyer правильно записывать все транзакции.
4. Нажмите Сохранить.
   Чтобы изменения вступили в силу, может потребоваться время (иногда вплоть до 24 часов). Поэтому не спешите проводить тестирование.

Чтобы сгенерировать общий секретный ключ App Store Connect:

• Выберите своё приложение в App Store Connect. В разделе Информация о приложении прокрутите вниз до Общий секретный ключ приложения и нажмите кнопку Управление, чтобы получить общий секретный ключ App Store Connect. Скопируйте ключ в буфер обмена.
  

Чтобы загрузить общий секретный ключ:

1. В боковом меню AppsFlyer выберите Настройка > Настройки доходов > Покупки и подписки.
   Откроется страница Конфигурация дохода.
   
2. Введите свой общий секретный ключ App Store Connect.

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

Если вы выбрали рекомендуемый вариант отправки уведомлений непосредственно в AppsFlyer, следуйте приведённым ниже инструкциям.

Если вы решили перенаправлять уведомления от конечной точки в AppsFlyer, перейдите к следующему шагу.

Чтобы отправлять уведомления напрямую в AppsFlyer:

1. В настройках доходов AppsFlyer скопируйте конечную точку уведомлений сервера AppsFlyer, чтобы ввести её в конфигурацию App Store Connect.
2. В разделе App Store Connect, раздел Информация о приложении, прокрутите вниз до раздела Уведомления сервера App Store и вставьте конечную точку AppsFlyer в поля URL производственного сервера и URL сервера песочницы.
   
3. В разделе Версия уведомлений выберите Уведомления второй версии.
   
4. Нажмите Сохранить.
5. Если вы хотите получать копию уведомлений, в AppsFlyer (как в Шаге 2) введите конечную точку пересылки уведомлений и нажмите Сохранить.

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

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

Для пересылки уведомлений сервера от конечной точки в AppsFlyer:

1. В разделе App Store Connect, раздел Информация о приложении, прокрутите вниз до раздела Уведомления сервера App Store и вставьте свою конечную точку в поля URL производственного сервера и URL сервера песочницы.
   
2. В разделе Версия уведомлений выберите Уведомления второй версии.
   
3. Нажмите Сохранить.
4. Настройте отправку уведомлений сервера Apple из вашего бэкенда на URL конечной точки AppsFlyer для уведомлений. Примечание: Запросы должны быть в точности такими, как они получены из App Store. См. требования к формату Apple

1. На странице настройки доходов от внутренних покупок и подписок в AppsFlyer включите один из следующих переключателей или оба сразу:
   • Атрибуция и учёт подписок с автопродлением (ARS).
   • Проверка покупок в Apple App Store.
     
2. [Необязательно] Установите флажок для Разрешить AppsFlyer дедуплицировать транзакции, которые уже были учтены.
   Таким образом можно исключить дублирование записей транзакций.
3. [Необязательно] Установите флажок для Разрешить AppsFlyer автоматически сообщать об отрицательном доходе при операции возврата. Это гарантирует, что возвраты, отмены и т. д. будут зарегистрированы.
4. [Необязательно] Установите флажок для Дедупликация дохода от покупок в рамках Семейного доступа.
   Это гарантирует, что при покупках по семейному доступу не будет дублирования. События дохода для других членов семьи включают в себя параметр purchase_ownership_type=FAMILY_SHARED и показывают нулевой доход.

В песочнице:

• Только события первичной покупки заставляют коннектор SDK создавать событие, которое фиксируется AppsFlyer. Событие покупки в приложении называется af_purchase_sandbox_sdk. Событие подписки называется af_ars_sandbox_sdk.
• Все остальные события покупки отбрасываются, то есть коннектор SDK не создаёт события.
• Входящие уведомления сервера обрабатываются только в том случае, если коннектор SDK впервые записывает исходную транзакцию. В этом случае создаётся событие покупки в приложении под названием af_purchase_sandbox_s2s. Событие подписки создаётся под названием af_ars_sandbox_s2s.
• Событие не создаётся для любого уведомления сервера, для которого коннектор SDK сначала не зарегистрировал исходную транзакцию.
• Для iOS убедитесь, что в разделе уведомлений сервера App Store в App Store Connect конечная точка AppsFlyer настроена как ваш URL сервера песочницы.
  
• Если в iOS событие af_purchase_sandbox_sdk содержит параметр af_sandbox_revenue со значением дохода, это означает, что в рабочей среде это будет обычное событие af_purchase. Если дохода нет, то в рабочей среде это будет событие af_purchase_free.
• В результате тестирования, проводимого на Android тестировщиками лицензий, создаются события песочницы, даже если песочница в SDK не настроена.

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

1. Скажите разработчикам, что для настройки среды песочницы в коннекторе SDK необходимо следовать инструкциям Android, iOS и Unity.
2. Сделайте тестовую покупку. Также поддерживаются транзакции, выполняемые тестировщиком лицензий в Google Play и из TestFlight в iOS.
   Примечание: Любой продукт по подписке может быть протестирован только один раз с каждого тестового устройства. Другими словами, нельзя зарегистрировать несколько тестовых покупок по одной и той же подписке с одного и того же устройства, поскольку они не будут учтены.
3. Убедитесь, что событие отображается на дэшборде активности AppsFlyer. Событие покупки в приложении называется af_purchase_sandbox_sdk. Событие подписки называется af_ars_sandbox_sdk. Эти события включают в себя:
   • Значение дохода, равное 0 (чтобы не искажать реальные отчёты AppsFlyer).
   • Параметр af_sandbox_revenue, который включает в себя значение дохода от приобретённого продукта, чтобы вы могли проверить правильность учтённого дохода.
4. Если вы проверяете продукт по подписке, дайте AppsFlyer некоторое время на получение уведомления сервера. Обычно это происходит через несколько минут после исходной покупки. 
5. Убедитесь, что событие отображается на дэшборде активности AppsFlyer. Автоматическое продление называется af_ars_sandbox_s2s. Мероприятие включает в себя:
   • Значение дохода, равное 0 (чтобы не искажать реальные отчёты AppsFlyer).
   • Параметр af_sandbox_revenue, который включает в себя значение дохода от приобретённого продукта, чтобы вы могли проверить правильность учтённого дохода.