API отчетов по атрибуции: руководство по интеграции,API отчетов по атрибуции: руководство по интеграции

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

Читая документацию Privacy Sandbox для Android, используйте кнопку Developer Preview или Beta , чтобы выбрать версию программы, с которой вы работаете, поскольку инструкции могут отличаться.

API отчетов по атрибуции предназначен для поддержки ключевых вариантов использования атрибуции и измерения конверсий в приложениях и Интернете без использования межпартийных идентификаторов пользователей. По сравнению с распространенными сегодня конструкциями разработчики API отчетов об атрибуции должны учитывать некоторые важные соображения высокого уровня:

  • Отчеты на уровне событий включают данные о конверсиях низкой точности. Небольшое количество значений конверсии работает хорошо.
  • Агрегированные отчеты включают более точные данные о конверсиях. Ваши решения должны разрабатывать ключи агрегирования на основе требований вашего бизнеса и ограничения в 128 бит.
  • Модели данных и обработка вашего решения должны учитывать ограничения скорости для доступных триггеров , временные задержки для отправки событий триггера и шум, применяемый API.

Чтобы помочь вам в планировании интеграции, в этом руководстве представлен подробный обзор, который может включать функции, которые еще не реализованы на текущем этапе Privacy Sandbox в Android Developer Preview. В таких случаях предоставляются рекомендации по срокам.

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

На диаграмме ниже показаны различные варианты рабочего процесса для интеграции атрибуции. Разделы, перечисленные в одном столбце (обведены зеленым), можно обрабатывать параллельно; например, взаимодействие с партнерами можно осуществлять одновременно с атрибуцией на уровне событий между приложениями.

Схема рабочего процесса интеграции атрибуции

Рисунок 1. Рабочий процесс интеграции атрибуции.

Предварительные условия и настройка

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

Ознакомьтесь с API

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

Настройте и протестируйте пример приложения

  1. Когда вы будете готовы начать интеграцию, настройте последнюю версию Developer Preview в Android Studio .
  2. Настройте конечные точки фиктивного сервера для регистрации событий и доставки отчетов. Мы предоставили макеты , которые вы можете использовать в сочетании с инструментами, доступными в Интернете.
  3. Загрузите и запустите код нашего примера приложения, чтобы ознакомиться с регистрацией источников и триггеров.
    1. Установите временной интервал для отправки отчетов. API поддерживает окна продолжительностью 2 дня, 7 дней или настраиваемый период от 2 до 30 дней.
    2. После того, как вы зарегистрировали источники и триггеры, запустив и используя пример приложения, и по прошествии установленного периода времени, убедитесь, что вы получили отчет на уровне событий и зашифрованный сводный отчет. Если вам необходимо отладить отчеты, вы можете создать их быстрее , принудительно запустив задания отчетов .
    3. Просмотрите результаты атрибуции между приложениями. Убедитесь, что данные в этих результатах соответствуют ожиданиям как для случаев последнего касания, так и для случаев после установки.

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

Предварительная интеграция

Зарегистрируйте свою организацию в Privacy Sandbox на Android. Эта регистрация предназначена для предотвращения ненужного дублирования платформ рекламных технологий, которое позволит получить доступ к большему, чем необходимо, информации о деятельности пользователя.

Участие партнеров

Партнеры по рекламным технологиям (MMP/SSP/DSP) часто создают интегрированные решения атрибуции. Шаги, описанные в этом разделе, помогут вам подготовиться к успеху во взаимодействии с партнерами по рекламным технологиям.

  1. Запланируйте обсуждение со своими ведущими партнерами по измерению, чтобы обсудить тестирование и внедрение API отчетов по атрибуции. Партнерами по измерению могут быть сети рекламных технологий, SSP, DSP, рекламодатели или любые другие партнеры, с которыми вы сейчас работаете или с которыми хотели бы работать.
  2. Сотрудничайте со своими партнерами по измерению, чтобы определить сроки интеграции, от первоначального тестирования до внедрения.
  3. Уточните у своих партнеров по измерению, какие области каждый из вас будет охватывать при разработке атрибуции.
  4. Установите каналы связи между партнерами по измерениям для синхронизации сроков и сквозного тестирования.
  5. Создавайте высокоуровневые потоки данных между партнерами по измерению. Ключевые соображения включают следующее:
    • Как партнеры по сбору данных будут регистрировать источники атрибуции с помощью Attribution Reporting API?
    • Как сети рекламных технологий будут регистрировать триггеры с помощью API отчетов по атрибуции?
    • Как каждый рекламный технический специалист будет проверять запросы API и возвращать ответы для завершения регистрации источника и триггера?
    • Существуют ли какие-либо отчеты, которыми необходимо делиться между партнерами за пределами API отчетов по атрибуции?
    • Существуют ли какие-либо другие точки интеграции или согласования между партнерами? Например, вам и вашим партнерам нужно поработать над дедупликацией конверсий или согласовать ключи агрегирования?
  6. Если применима атрибуция между приложением и веб-сайтом, запланируйте обсуждение с партнерами по измерению в Интернете, чтобы обсудить дизайн, тестирование и внедрение API отчетов по атрибуции. Прежде чем начать общение с веб-партнерами, обратитесь к вопросам из предыдущего шага.

Атрибуция на уровне событий между приложениями в прототипе

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

  1. Настройте сервер сбора записей событий. Вы можете сделать это, используя предоставленную спецификацию для создания макета сервера, или настроить свой собственный сервер с помощью примера кода сервера .
  2. Добавьте вызовы событий источника регистрации в свой SDK или приложение при показе рекламы.
    • Критические соображения включают следующее:
      • Убедитесь, что идентификаторы исходных событий доступны и правильно передаются в вызовы API регистрации источника.
      • Убедитесь, что вы также можете передать `InputEvent` для регистрации источников кликов.
      • Определите, как вы будете настраивать приоритет источника для разных типов событий. Например, назначьте высокий приоритет событиям, которые считаются высокоценными, например кликам по просмотрам.
      • Значение срока действия по умолчанию подходит для тестирования. Альтернативно можно настроить разные сроки действия .
      • Фильтры и окна атрибуции можно оставить по умолчанию для тестирования.
    • Дополнительные соображения включают следующее:
      • Разработайте ключи агрегирования, если вы к ним готовы.
      • Продумайте свою стратегию перенаправления, когда определите, как вы хотите работать с другими партнерами по измерению.
  3. Добавьте триггерные события регистрации в свой SDK или приложение, чтобы записывать события конверсии.
    • Критические соображения включают следующее:
    • Дополнительные соображения включают следующее:
      • Пропустите создание ключей дедупликации, пока не выполните тесты на точность.
      • Пропустите создание ключей и значений агрегации, пока не будет готова поддержка симуляционного тестирования .
      • Пропускайте перенаправления, пока не определите, как вы хотите работать с другими партнерами по измерению.
      • Приоритет триггера не важен для тестирования.
      • Фильтры, вероятно, можно игнорировать при первоначальном тестировании.
  4. Проверьте, что исходные события генерируются для рекламы и что триггеры являются ведущими для создания отчетов о событиях.

Моделирование тестирования

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

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

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

  1. Настройте библиотеку моделирования измерений на локальном компьютере.
  2. Прочтите спецификацию о том, как должны быть отформатированы данные о конверсиях, чтобы они были совместимы с генератором имитированных отчетов.
  3. Создавайте ключи агрегации на основе бизнес-требований.
    • Критические соображения включают следующее:
      • Рассмотрите критические аспекты, которые ваши клиенты или партнеры должны агрегировать, и сосредоточьте на них свою оценку.
      • Определите минимальное количество совокупных измерений и мощностей, необходимое для ваших требований.
      • Убедитесь, что длина ключей на стороне источника и триггера не превышает 128 бит.
      • Если ваши решения включают в себя вклад в несколько значений для каждого триггерного события, обязательно масштабируйте значения в соответствии с максимальным бюджетом вклада, L1. Это поможет минимизировать воздействие шума.
      • Ниже приведен пример , в котором подробно описывается настройка ключа для сбора совокупного количества конверсий на уровне кампании и ключа для сбора совокупной стоимости покупок на географическом уровне.
  4. Запустите генератор отчетов для создания отчетов о событиях и агрегированных отчетов.
  5. Запустите агрегированные отчеты через моделируемые серверы агрегирования, чтобы получить сводные отчеты.
  6. Проведите полезные эксперименты:
    • Сравните общее количество конверсий из отчетов на уровне событий и сводных отчетов с историческими данными о конверсиях, чтобы определить точность отчетов о конверсиях. Для достижения наилучших результатов проводите тестирование и сравнение отчетов на широкой репрезентативной части базы рекламодателей.
    • Переобучите свои модели на основе данных отчета на уровне событий и, возможно, сводных данных отчета. Сравните точность с моделями, построенными на исторических данных обучения.
    • Попробуйте различные стратегии пакетной обработки и посмотрите, как они повлияют на ваши результаты.
      • Критические соображения включают следующее:
      • Своевременность сводных отчетов для корректировки ставок.
      • Средняя частота событий, связанных с устройством. Например, данные о возврате устаревших пользователей основаны на исторических данных о покупках.
      • Уровень шума. Больше пакетов означает меньшую агрегацию, а меньшая агрегация означает больше шума.

Атрибуция прототипа сервера агрегации: настройка

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

  1. Настройте сервер агрегации:
    • Настройте свою учетную запись AWS.
    • Зарегистрируйтесь в услуге агрегации у своего координатора.
    • Настройте свой сервер агрегации на AWS из предоставленных двоичных файлов.
  2. Разработайте ключи агрегации на основе бизнес-требований. Если вы уже выполнили эту задачу в разделе уровня событий между приложениями , вы можете пропустить этот шаг.
  3. Настройте сервер сбора агрегированных отчетов. Если вы уже создали его в разделе уровня событий «приложение-приложение» , вы можете использовать его повторно.

Атрибуция прототипа сервера агрегации: интеграция

Чтобы продолжить этот этап, вам необходимо заполнить раздел «Атрибуция сервера агрегации прототипа: настройка» или раздел «Атрибуция прототипа приложения для приложения на уровне событий» **.

  1. Добавьте данные ключа агрегации в свой источник и инициируйте события. Вероятно, для этого потребуется передать больше данных о рекламном событии, таких как идентификатор кампании, в ваш SDK или приложение для включения в ключ агрегирования.
  2. Собирайте агрегированные отчеты между приложениями из источника и инициируйте события, которые вы зарегистрировали с помощью данных ключа агрегирования.
  3. Тестируйте различные стратегии пакетной обработки, прогоняя эти агрегированные отчеты через сервер агрегации, и наблюдайте, как они влияют на ваши результаты.

Повторяющийся дизайн с дополнительными функциями

Ниже приведены дополнительные функции, которые вы можете включить в свое измерительное решение.

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

Настройте поведение атрибуции

  1. Атрибуция триггеров после установки
    • Эту функцию можно использовать в случае, когда триггеры после установки необходимо отнести к тому же источнику атрибуции, который привел к установке, даже если существуют другие подходящие источники атрибуции, возникшие совсем недавно.
    • Например, может быть случай, когда пользователь нажимает на рекламу, которая приводит к установке. После установки пользователь нажимает на другое объявление и совершает покупку. В этом случае компания, занимающаяся рекламными технологиями, может захотеть, чтобы покупка была связана с первым кликом, а не с кликом повторного вовлечения.
  2. Используйте фильтры для точной настройки данных в отчетах на уровне событий.
    • Фильтры конверсий можно настроить так, чтобы они игнорировали выбранные триггеры и исключали их из отчетов о событиях. Поскольку существуют ограничения на количество триггеров для каждого источника атрибуции , фильтры позволяют включать в отчеты о событиях только те триггеры, которые предоставляют наиболее полезную информацию.
    • Фильтры также можно использовать для выборочной фильтрации некоторых триггеров, фактически игнорируя их. Например, если у вас есть кампания, ориентированная на установки приложения, вы можете отфильтровать триггеры после установки, чтобы они не были связаны с источниками из этой кампании.
    • Фильтры также можно использовать для настройки данных триггера на основе исходных данных. Например, источник может указать "product" : ["1234"] , где продукт — это ключ фильтра, а 1234 — значение. Любой триггер с ключом фильтра «продукт», имеющим значение, отличное от «1234», игнорируется.
  3. Настраиваемый источник и приоритет триггера
    • В случае, если с триггером могут быть связаны несколько источников атрибуции или с одним источником могут быть связаны несколько триггеров, вы можете использовать 64-битное целое число со знаком, чтобы определить приоритет определенных атрибуций источника/триггера над другими.

Работа с ММП и др.

  1. Перенаправление другим третьим сторонам для событий источника и триггера.
    • Вы можете установить URL-адреса перенаправления, чтобы разрешить нескольким рекламным платформам регистрировать запрос. Это можно использовать для включения межсетевой дедупликации при атрибуции.
  2. Ключи дедупликации
    • Когда рекламодатель использует несколько платформ рекламных технологий для регистрации одного и того же триггерного события, для устранения неоднозначности в этих повторяющихся отчетах можно использовать ключ дедупликации. Если ключ дедупликации не указан, дублирующиеся триггеры могут быть отправлены на каждую рекламную платформу как уникальные.

Работа с кроссплатформенными измерениями

  1. Кросс-приложение и веб-атрибуция (доступно в конце четвертого квартала)
    • Поддерживаются случаи использования, когда пользователь видит рекламу в приложении, а затем совершает конверсию в браузере мобильного телефона или приложения или наоборот.
{% дословно %} {% дословно %} {% дословно %} {% дословно %}