Защищенная аудитория: руководство по интеграции

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

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

Рабочий процесс интеграции Защищенной аудитории состоит из 4 ключевых шагов, выполняемых различными типами партнеров по рекламным технологиям:

  1. Покупатель создает индивидуальные аудитории.
  2. В процессе отбора объявлений выбирается победившее объявление.
    1. Приложение продавца инициирует выбор объявления.
    2. Рекламные службы выполняют код фильтрации и назначения ставок на стороне покупателя.
    3. Рекламные службы выполняют код решения на стороне продавца.
  3. Победившее объявление отображается в приложении продавца.
  4. Отчеты о показах рекламы доступны как покупателю, так и продавцу.

Следующая диаграмма иллюстрирует эти шаги:

Наглядная схема рабочего процесса выбора объявлений.
Рабочий процесс управления индивидуальной аудиторией Protected Audience и выбора рекламы.

Терминология

  • Рекламодатель : компания, которая привлекает пользователей посредством покупки рекламных ресурсов.
  • Издатель : компания, которая продает рекламные ресурсы, доступные вместе с их контентом.
  • Покупатель : компания, занимающаяся рекламными технологиями, которая помогает рекламодателям покупать рекламные ресурсы.
  • Продавец : компания, занимающаяся рекламными технологиями, которая помогает издателям продавать рекламные ресурсы.
  • Сеть : рекламная технологическая компания, которая выступает как в роли покупателя, так и в роли продавца.
  • В собственности и управлении : компания, которая выступает в качестве издателя, продавца и покупателя.
  • Партнеры по интеграции : любые компании, с которыми вам необходимо сотрудничать для успешной интеграции с Защищенной аудиторией.

Предварительные условия, привлечение партнеров по интеграции и настройка

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

Схема, показывающая руководство по развертыванию функций защищенной аудитории.
Руководство по развертыванию функций защищенной аудитории.

Ознакомьтесь с защищенной аудиторией

Первым шагом является ознакомление с API и сервисами защищенной аудитории.

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

Настройка и тестирование примеров приложений

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

  1. Когда вы будете готовы начать интеграцию, настройте свою среду разработки с помощью последней версии Privacy Sandbox Developer Preview .
  2. Настройте необходимые конечные точки сервера. Используйте примеры макетов с предпочитаемым вами решением для тестирования API, чтобы запустить этот процесс.
  3. Создайте и запустите код в нашем примере приложения , чтобы ознакомиться с управлением индивидуальной аудиторией, рабочим процессом выбора объявлений и отчетами о показах.

Привлечение партнеров по интеграции

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

Бета-версия (доступна в четвертом квартале)

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

Архитектурные соображения

Как для покупателей, так и для продавцов Protected Audience предоставляет возможность проводить аукционы рекламы на устройстве. При разработке проектов вы и ваши партнеры по интеграции должны учитывать несколько важных факторов:

Аудитории и объявления ремаркетинга хранятся на устройстве.

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

Процессы торгов и аукционов происходят на устройстве.

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

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

Стратегия данных

Платформам рекламных технологий следует учитывать типы данных, которые используются на аукционах. Сегодня эта информация собирается из различных источников, а затем централизованно хранится на сервере. Аукционы с защищенной аудиторией предлагают несколько различных способов передачи этих данных. Например: сигналы в реальном времени, такие как оставшийся бюджет, поступают от службы «ключ-значение» в качестве доверенных сигналов, тогда как контекстные сигналы, такие как время суток, отправляются от продавцов при проведении аукциона. . Эти сигналы более подробно объяснены в соответствующих разделах данного руководства.

Создайте свое решение

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

Покупатели: формирование аудитории

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

Если у вас есть собственный SDK в приложении для рекламодателей, вы можете реализовать этот код напрямую через joinCustomAudience() .

Если у вас нет собственного кода SDK на устройствах, вы можете рассмотреть возможность сотрудничества с существующим партнером по интеграции, который также является поставщиком SDK. Определите этого партнера и работайте с ним, чтобы определить контракт и порядок определения индивидуальной аудитории и управления ею. В этом руководстве используется термин «покупатель» независимо от того, какой подход используется. Некоторые примеры подходов включают в себя:

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

Прототип кампании ремаркетинга: создание индивидуальной аудитории

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

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

Настройка и прототип

Рекомендации по проектированию

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

URL логики назначения ставок

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

Сигналы назначения ставок пользователями

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

  • Другие аудитории, в которые добавлен пользователь.
  • Собственная информация о пользователе, которую имеет рекламодатель.

Поскольку эти сигналы доступны во время аукциона, покупатели могут выполнять специальные операции по назначению ставок во время аукциона, в том числе:

  • Повышайте или понижайте ставки в зависимости от сигналов торгов.
  • Отфильтруйте конкретные объявления с аукциона.

Надежные данные о ставках

В рамках реализации Защищенной аудитории покупатели могут получать доступ к информации в режиме реального времени во время аукциона из службы «ключ-значение». В качестве временного механизма покупатель и продавец могут получать эти сигналы торгов из любого сервиса, включая тот, которым они управляют сами. Самый распространенный пример — поиск оставшегося бюджета на рекламу. Во время разработки можно имитировать этот сервис, и вы можете разрабатывать его с использованием этой макетной конечной точки. Инструкции по установке см. в каталоге FledgeServerSpec в репозитории нашего примера приложения на GitHub.

Поле TrustedBiddingData состоит из URL-адреса и набора ключей. Вот некоторые соображения при проектировании того, какую структуру ключей использовать:

  • Простой подход — включить ключ, который сопоставляет 1:1 с создаваемой аудиторией. Служба «ключ-значение» может затем содержать всю соответствующую информацию, связанную с аудиторией.
  • Бюджет и статус объявления — важные вещи, которые следует учитывать в режиме реального времени.
  • Максимальная сумма ставки или другие сигналы, которые можно использовать для определения цены объявления на аукционе. Эту информацию можно включить в объявление в список AdData , но хранение ее в службе «ключ-значение» позволяет легче обновлять ее по мере необходимости.

Список данных рекламы

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

Объем информации, включаемой в каждое объявление, решает покупатель. Некоторые вещи, которые следует учитывать:

  • Список AdData можно обновить двумя способами:
    • Если приложение имеет видимое действие на переднем плане, оно может инициировать список, когда присоединяет пользователя к настраиваемой аудитории.
    • Во время ежедневного обновления выборка инициируется в фоновом режиме. Устройство отправляет запрос на daily_update_url включенный в вызов joinCustomAudience , и ожидает ответа, включающего обновленный список AdData .
  • Дополнительную информацию об объявлениях можно запросить во время аукциона. Перед аукционом устройство отправляет запрос в службу «ключ-значение» покупателей, указанную в trustedBiddingData joinCustomAudience . Служба «ключ-значение» — это новая услуга, которая является частью реализации покупателями защищенной аудитории. Более подробная информация об этой услуге описана далее в этом документе .
  • Включение идентификатора креатива в ваше объявление может помочь вам выполнить определенные действия с конкретными креативами. Например, рекламодатели могут приостановить определенные объявления, и вы хотите получить эти идентификаторы объявлений из службы «ключ-значение» в режиме реального времени, а затем сопоставить их с объявлениями в списке AdData .

AdData должен включать render_url . URL-адрес показа победившего объявления ремаркетинга используется для показа объявления . Некоторые соображения включают в себя:

  • URL-адрес рендеринга имеет порог анонимности k, поэтому избегайте включения узких параметров. Дополнительная информация об этом пороге k-анонимности будет опубликована позднее.
  • Этот URL-адрес должен содержать всю информацию, необходимую для показа объявления. Например, если вы хотите показывать определенные продукты, вставьте идентификаторы продуктов в качестве параметров в URL-адрес.

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

Время активации и срок действия

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

  • Пользователь с истекшим сроком действия (например, пользователь, который не взаимодействовал с приложением рекламодателя в течение последних 7 дней)
    • Каждый раз, когда пользователь открывает приложение, покупатель может вызвать joinCustomAudience и настроить activation_time как отметку времени на 7 дней в будущем.
    • Аудитория имеет право на участие в торгах, если с момента последнего открытия приложения пользователем прошло 7 дней.
  • Сезонная аудитория (аудитория, которая действительна только в течение определенного периода времени в ближайшем будущем)
    • Покупатель может заранее начать определять индивидуальные аудитории, которые будут иметь право на участие в торгах только в течение заранее определенного времени в (ближайшем) будущем.
    • Например, если у рекламодателя заканчивается летняя кампания в США в 2022 году, его покупатель может позвонить в joinCustomAudience и настроить activation_time на субботу, 20 августа 2022 года. Если кампания продлится только одну неделю, покупатель может установить дату истечения срока действия. до 27 августа 2022 г., после чего пользовательская аудитория отфильтровывается платформой при выборе рекламы и, в конечном итоге, вывозится мусором.

Покупатели и продавцы: выбор объявлений

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

  1. Продавцы определяют стратегию посредничества .
  2. Продавцы настраивают аукцион и инициируют отбор объявлений.
  3. Покупателям предлагается принять участие в аукционе через конфигурацию, определенную продавцом. Логика назначения ставок покупателя выполняется для выбора объявления-кандидата и ставки.
  4. Логика принятия решений продавца выполняется для оценки кандидатов и выбора выигрышного объявления.

Чтобы облегчить разработку, можно имитировать ответы службы для покупателей и продавцов, что включает в себя логику торгов и оценки, что позволяет вам сосредоточиться на разработке того, что имеет отношение к вашему варианту использования. Инструкции по настройке фиктивных конечных точек см. в каталоге FledgeServerSpec на GitHub, а инструкции по устранению необходимости удаленной загрузки JavaScript — в руководстве разработчика .

Продавцы: определение стратегии посредничества

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

Продавцы: настройка аукциона

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

Настройка и прототип

  • Продавец может настроить и инициировать аукцион, настроив объект AdSelectionConfig и используя API AdSelection . Запустите аукцион, вызвав selectAds() .
  • Подробности реализации и использования API см. в руководстве разработчика .

Рекомендации по проектированию

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

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

  • Прежде чем начать рабочий процесс выбора объявлений, запустите запрос объявления, чтобы собрать информацию от покупателей. Затем используйте эту информацию для настройки выбора объявлений.

  • Поскольку многие покупатели могли бы создать на устройстве пользовательские аудитории, продавцам необходимо использовать поле «Покупатели индивидуальной аудитории» , чтобы указать конкретных покупателей, которых следует включить в процесс. Есть много способов составить этот список. Вот некоторые примеры:

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

  • Продавец может передать информацию в процесс несколькими способами:

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

Покупатели: ставки за рекламное место

Настройка и прототип

  • Покупатель может добавить свою логику назначения ставок в функцию generateBid() , которая обслуживается из набора параметров biddingLogicUrl при создании CustomAudience . Вы можете настроить фиктивную службу, используя предоставленную спецификацию , или реализовать эту конечную точку на реальном сервере.
  • Подробности реализации и использования API см. в руководстве разработчика .

Рекомендации по проектированию

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

Разработка логики назначения ставок

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

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

Сигналы назначения ставок в реальном времени с помощью сервисов «ключ-значение»

Как покупатель, вы можете получать сигналы в реальном времени во время аукциона от принадлежащей вам службы «ключ-значение». Первоначальную реализацию этого сервиса можно найти в общедоступном репозитории Privacy Sandbox или создать собственный сервис. URL-адрес этой службы указан trustedBiddingUrl в пользовательской аудитории, и платформа пытается получить данные и сделать их доступными для вашей generateBid с помощью trusted_bidding_signals parameter . Вам необходимо создать собственную структуру ключей.

Контекстные и пользовательские сигналы

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

Поле contextual_signals содержит информацию, которая может иметь отношение к пользователю. Объект, содержащий эти сигналы, создается самой Защищенной аудиторией и передается в вашу логику назначения ставок. В настоящее время это передается как пустой объект. Если вы считаете, что контекстный сигнал о пользователе может иметь отношение к вашему варианту использования, отправьте отзыв на рассмотрение.

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

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

Продавцы: оцените и выберите победившее объявление.

Настройка и прототип

  • Продавец может добавить свою логику оценки в функцию scoreAd() , которая обслуживается из набора параметров scoringLogicUrl при построении AdSelectionConfig . Вы можете настроить фиктивную службу, используя предоставленную спецификацию , или реализовать эту конечную точку на реальном сервере.
  • Подробности реализации и использования API см. в руководстве разработчика .

Логика оценки дизайна

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

Данные о подсчете поставок

Сигналы оценки в реальном времени с помощью сервисов «ключ-значение»

Как продавец, вы можете получать сигналы в реальном времени во время аукциона от принадлежащей вам службы «ключ-значение». Первоначальную реализацию этого сервиса можно найти в общедоступном репозитории Privacy Sandbox . URL-адрес этой службы указан trustedScoringUri в конфигурации аукциона, и платформа пытается получить данные и сделать их доступными для вашей функции scoreAd через trusted_scoring_signals . Вам следует создать свою собственную структуру ключей.

Контекстные и пользовательские сигналы

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

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

Продавцы: разместить объявление

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

Отчет о результатах показов

Настройка и прототип

  • Покупатели и продавцы могут добавить логику отчетности в функцию JavaScript reportWin() , которая обслуживается параметром biddingLogicUrl или scoringLogicUrl соответственно. Вы можете настроить фиктивную службу, используя предоставленную спецификацию , или реализовать эту конечную точку на реальном сервере.
  • Подробности реализации и использования API см. в руководстве разработчика .

Рекомендации по проектированию

Покупатели и продавцы должны реализовать функцию reportWin в своем коде JavaScript, возвращаемом из настроенных ими конечных точек. Этот метод позволяет отправлять данные обратно на ваши серверы.

Privacy Sandbox также предоставляет API отчетов об атрибуции для управления уровнями событий и сводными отчетами. Подробнее читайте в руководстве по интеграции .

{% дословно %} {% дословно %} {% дословно %} {% дословно %}