API Topics для мобильных устройств: обзор

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

How the Topics API works

The Topics API can be used to observe and provide access to topics that appear to be of interest to the user, based on their activity. The Topics API can then give API callers (such as ad tech platforms) access to a user's topics of interest, but without revealing additional information about the user's activity.

Key concepts

• A topic is a human-readable topic of interest for the current user and is part of the Topics taxonomy.
• A caller is an entity, such as an app, a third-party SDK, a website, or service, that makes a request to the Topics API to observe or access a user's interests.
• A topic is observed by a caller, if the caller made a Topics API request from a web page or app associated with this topic during the past three epochs.
• An epoch is a period of topic computation, which defaults to one week.
• A taxonomy is a hierarchical list of categories, which includes, for example, such categories as /Arts & Entertainment/Music & Audio/Soul & R&B and /Business & Industrial/Business Services/Corporate Events.
• Topics are derived using a classifier model that maps user activity to zero or more topics.

Topics API flow core steps

The Topics API lifecycle has three main steps:

• Observe user activity, such as when they visit the web page https://cats.example/tabby/index.html or download the app cats.
• Derive topics from user activity, for example /Pets & Animals/Pets/Cats.
• Access topics previously observed for the user, for example as a signal to select relevant advertising (such as a cat food promotion).

Observe topics

Callers can only access topics of interest that they've observed. A caller observes a topic when they make a Topics API request from a context associated with this topic. To illustrate this concept, consider the following simplified example.

• Suppose there are two Topics API callers: A and B.
• There are two contexts:
  • Greenhouse, for example an app named Greenhouse or a website greenhouse.example, associated with the topic Home & Garden.
  • Tennis exercises, for example an app named Tennis Exercises or a website tennis.example, associated with the topic Sports/Tennis.
• Both caller A and B are present in the context of Greenhouse.
• Only the caller B is present in the context of Tennis exercises.
• Assume that no topics were observed for the user before epoch 1, for the sake of simplification.
• The user visits the Greenhouse app, and callers A and B make a Topics API call to record the user visit to the page or app (see the implementation guide suggested in Next steps to find out how to call the Topics API). This record (a hostname or app data) is later used to derive topics of interest. The Topics API will later mark the topic Home & Garden as observed by both callers A and B.
• The user visits the Tennis exercises app. Only the caller B sends a Topics API request. The Topics API will later mark the topic Sports/Tennis as observed by the caller B.
• By the end of the epoch, the Topics API refreshes the user's top topics and determines the callers that observed these topics based on user activity.
• Later, when the caller B makes another Topics API call, it can get either Home & Garden or Sports/Tennis topic (or, with a 5% chance, a random topic) for this user in the response array.
• Caller A can only access the topic Home & Garden, as it has never observed the topic Sports/Tennis. This means that a third-party will only learn about a user's topic of interest within the specific context (app or website) where it is present.

Derive topics

Topics derives topics of interest from user activity. The topics are selected from a predefined open-source taxonomy. Once per epoch, Topics refreshes the user's top five topics and the callers that observed them during the epoch. The Topics classifier model derives topics from user activity: hostname for a web page visit, app information on Android.

Caller accesses user's topics of interest

The API returns only topics that have been observed by the caller within the most recent three epochs. A maximum of three topics may be returned to a caller,one topic for each of the three recent epochs (if the caller observed topics for that epoch). The returned topics can be used by the caller to supplement any contextual information and can be combined to help find a more relevant ad for the user.

Epochs

The Topics API must ensure that the topics of interest it provides are kept up to date. The topics are inferred for a user based on their activity during a period of time known as an epoch, one week by default. Each user has their own epochs (epochs are "per user") and the initial start time is randomized.

Once each epoch, the Topics API computes the user's top five topics and determines which callers observed those topics using on-device information. The topic selected for each epoch is randomly selected from the user's top five topics for that time period. To further enhance privacy and ensure that all topics may be represented, there is a 5% chance the topic is randomly selected from all possible topics in the taxonomy of interests.

Практические аспекты использования Android.

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

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

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

Интеграция тем по типам бизнеса

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

Для всех, кто работает в сфере рекламных технологий.

• Ознакомьтесь с таксономией тем и оставьте свой отзыв .
• Поэкспериментируйте с примерами приложений Topics API, чтобы увидеть, какие данные о темах возвращает классификатор на устройстве.
• Обновите приложение и потоки SDK, чтобы начать вызывать API тем.
• Обновите протоколы, чтобы начать отправлять темы в запросах на рекламу.
• Зарегистрируйте свои рекламные технологии в «Песочнице конфиденциальности».

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

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

Для компаний, занимающихся рекламными технологиями на стороне покупателя.

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

Как API определяет темы для приложения

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

Классификатор тем

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

• Когда модель классификатора используется для вывода информации о темах для данной эпохи, набор используемых сигналов остается на устройстве. Этот набор сигналов может включать установленные или недавно использованные приложения, и впоследствии он может быть расширен за счет других сигналов.
• Модель V5 была обучена Google на 540 000 размеченных людьми и 17 миллионах размеченных машинным обучением общедоступных данных о приложениях из магазинов приложений, таких как Google Play Store. Модель использует названия приложений и названия пакетов в качестве входных сигналов и находится в свободном доступе для разработчиков приложений, которые могут протестировать ее и посмотреть, к каким темам относится их приложение.
• Приложение может относиться к нескольким темам, или не относиться ни к одной теме, или не быть добавлено в историю тем пользователя. В случае, если приложение относится к нескольким темам в таксономии, количество тем, выбранных для этого приложения, будет ограничено тремя наиболее важными.

Чтобы лучше понять, как работает модель классификатора, вы можете протестировать, как различные данные приложения влияют на классификацию, используя Android Topics Classifier Colab.

Таксономия

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

Практические аспекты использования Android.

Предположим, у пользователя на устройстве установлено семь приложений: A, B, C, D, E, F и G. Допустим, классификация тем для приложений и SDK рекламных технологий в этих приложениях следующая:

Конец первой недели: API тем генерирует 5 самых популярных тем пользователя за эту эпоху.

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

• В расчет доступных каждому абоненту тем включается трехвременный период (или три недели).
• Используются только темы, связанные с приложениями, которые вызывают API тем через рекламные SDK. Это означает, что если приложение не включает в себя рекламные SDK, которые вызывают API тем, то темы, связанные с этим приложением, не попадают в пул тем, доступных для рекламных SDK.
• Приложение также может декларативно отказаться от использования API тем. Темы, связанные с приложениями, отказавшимися от использования API, не будут учитываться при еженедельном подсчете тем. Данный документ будет обновлен для включения соответствующих деталей реализации.

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

Шифрование возвращаемых тем

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

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

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

Следующие шаги

Реализация тем

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

Контроль и прозрачность

Узнайте, как пользователи и разработчики могут управлять API Topics и настраивать его в соответствии с предпочтениями и потребностями пользователей.

См. также

Ознакомьтесь с нашими ресурсами, чтобы лучше понять API Topics на Android.

• Ознакомьтесь с примерами приложений Topics, видеороликами для совместной работы и пошаговыми руководствами .
• Узнайте, как пользователи и разработчики могут управлять API.
• Посетите ресурсы поддержки, чтобы задавать вопросы, участвовать и делиться отзывами.