Эта страница переведена с помощью Cloud Translation API.

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

API Topics для Android предназначен для поддержки рекламы на основе интересов без использования идентификаторов между приложениями.

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

Реклама на основе интересов (IBA) — это форма персонализированной рекламы, при которой реклама подбирается на основе интересов пользователя. В Privacy Sandbox на Android эти интересы определяются приложениями, с которыми взаимодействовал пользователь. Это отличается от контекстной рекламы, которая основана исключительно на интересах, связанных с просматриваемым в данный момент контентом. IBA позволяет приложениям показывать более релевантную и привлекательную рекламу, чем контекстная реклама.

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

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

При реализации рекламы на основе интересов с помощью Topics API необходимо учитывать важные моменты:

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

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

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

Цели

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

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

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

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

Для специалистов по рекламе на стороне продавца

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

Для специалистов по рекламе на стороне покупателя

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

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

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

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

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

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

Следуйте инструкциям на этой странице , чтобы настроить Privacy Sandbox на Android SDK в Android Studio.
Разветвите и запустите код в версии примера приложения на Java или Kotlin , чтобы узнать, как получать темы на устройстве.
Во время тестирования поэкспериментируйте с информацией о приложении (названием и описанием), чтобы изменить темы, которые будут возвращаться из классификатора на устройстве.
После того, как вы поймете, как работают клиентский API и классификации на устройстве, используйте пример приложения в качестве примера для собственной интеграции.

Совет . Внимательно проверьте полезность данных тем, возвращаемых вашим приложением. Определите способы, которыми, по вашему мнению, можно улучшить классификацию или таксономию, и отправьте отзыв, если у вас есть рекомендации по улучшению таксономии.

При реализации рекламы на основе интересов с помощью Topics API необходимо учитывать важные моменты:

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

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

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

Цели

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

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

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

Для специалистов по рекламе на стороне продавца

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

Для специалистов по рекламе на стороне покупателя

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

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

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

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

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

Следуйте инструкциям на этой странице , чтобы настроить Privacy Sandbox на Android SDK в Android Studio.
Разветвите и запустите код в версии примера приложения на Java или Kotlin , чтобы узнать, как получать темы на устройстве.
Во время тестирования поэкспериментируйте с информацией о приложении (названием и описанием), чтобы изменить темы, которые будут возвращаться из классификатора на устройстве.
После того, как вы поймете, как работают клиентский API и классификации на устройстве, используйте пример приложения в качестве примера для собственной интеграции.

При реализации рекламы на основе интересов с помощью Topics API необходимо учитывать важные моменты:

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

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

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

Цели

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

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

Для специалистов по рекламе на стороне продавца

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

Для специалистов по рекламе на стороне покупателя

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

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

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

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

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

Следуйте инструкциям на этой странице , чтобы настроить Privacy Sandbox для Android SDK в Android Studio.
Разветвите и запустите код в версии примера приложения на Java или Kotlin , чтобы узнать, как получать темы на устройстве.
Во время тестирования поэкспериментируйте с информацией о приложении (названием и описанием), чтобы изменить темы, которые будут возвращаться из классификатора на устройстве.
После того, как вы поймете, как работают клиентский API и классификации на устройстве, используйте пример приложения в качестве примера для собственной интеграции.