API de Topics: Guía de integración

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La API de Topics para Android se diseñó para admitir publicidad basada en intereses sin depender de identificadores de apps múltiples.

Los anunciantes se esfuerzan por publicar anuncios relevantes que se relacionen con el interés de un usuario. Por ejemplo, si a un usuario le interesa la información relacionada con la cocina, es posible que piense que los anuncios relacionados con ese tema son más relevantes que los que no se relacionan con sus intereses.

La publicidad basada en intereses (IBA) es una forma de publicidad personalizada en la que los anuncios se seleccionan en función de los intereses del usuario. Con Privacy Sandbox en Android, estos intereses derivan de las apps con las que participa el usuario. Esto es diferente de la publicidad contextual, que se basa solo en los intereses derivados del contenido que se visualiza en el momento. La IBA permite que las apps muestren anuncios más relevantes y atractivos que los anuncios contextuales.

La IBA suele involucrar la comunicación entre apps, vendedores y compradores. Esta guía está destinada a todas estas partes, incluidas las redes y AdTech que operan como compradores y vendedores.

La API de Topics infiere indicadores generales de interés en el dispositivo a partir de las apps que usa un usuario. Estos indicadores, denominados temas, se comparten con los anunciantes para admitir la IBA sin realizar un seguimiento de los usuarios individuales en todas las apps.

Hay consideraciones importantes de alto nivel cuando implementas la publicidad basada en intereses con la API de Topics, como las siguientes:

  • La inferencia de interés del usuario se procesa en el dispositivo: La información del usuario sobre con exactitud qué apps se instalan en el dispositivo del usuario no sale del dispositivo, y la privacidad está protegida. Este modelo contrasta con el actual que se usa normalmente, en el que los datos de apps cruzadas de un usuario se envían y procesan fuera del dispositivo, en servidores AdTech. Ciertos tipos de procesamiento continuarán en servidores AdTech, como el uso de los indicadores proporcionados por la API de Topics en modelos de personalización y optimización para la selección de anuncios.

  • Los compradores y los anunciantes dependen de la parte de venta: Para obtener temas, los SDKs y las apps que se orientan a la venta deben establecer una huella mediante la observación de la API de Topics durante al menos 1 época.

Terminología

  • Anunciante: Es una empresa que interactúa con los usuarios a través de una compra de inventario de anuncios.
  • Publicador: Es una empresa que vende inventario de anuncios que está disponible junto con su contenido.
  • Comprador (o lado de la compra): Es una empresa de AdTech que facilita a los anunciantes la compra de inventario de anuncios.
  • Vendedor (o lado de la venta): Es una empresa de AdTech que facilita a los publicadores la venta de inventario de anuncios.
  • Red: Es una empresa de AdTech que actúa como comprador y vendedor.
  • Administrado y propiedad: Es una empresa que actúa como publicador, vendedor y comprador.

Objetivos

Si la IBA es importante para tu negocio, queremos que tengas una versión de la API de Topics en ejecución en el contexto de los casos comerciales de tu app, de manera que podamos obtener tus comentarios y permitirte desarrollar la API. Queremos asegurarnos de que puedas desbloquear diseños y desarrollo para que puedas obtener temas cuando se lance la versión beta.

En este momento, los objetivos de la planificación de integración para Privacy Sandbox en la Versión preliminar para desarrolladores de Android te permiten hacer lo siguiente:

Para todas las AdTech

  • Revisar la taxonomía de temas y enviar comentarios sobre los temas incluidos
  • Experimentar con las apps de ejemplo de la API de Topics para ver qué datos de temas se muestran desde el clasificador en el dispositivo
  • Actualizar los flujos de la app y el SDK para comenzar a llamar a la API de Topics
  • Actualizar los protocolos para comenzar a enviar temas en las solicitudes de anuncios
  • Registrar el AdTech en Privacy Sandbox

Para las AdTech orientadas a la venta

  • Convertirse en observador para establecer una huella de API de Topics (la API de Topics es un indicador nuevo, por lo que debes actualizar tu SDK para comenzar a llamar a dicha API. Para recuperar temas de manera coherente, las apps deben llamar a la API al menos una vez por época. Demora hasta 4 épocas para obtener la cantidad máxima de temas (3 temas) que se enviarán con tus solicitudes de anuncios.)
  • Incluir información de la API de Topics en tus solicitudes de anuncios (para cada solicitud de anuncio, comienza a compartir los datos de la API de Topics con socios de compra. Esta API pretende complementar otros indicadores (como los indicadores contextuales) para ayudar a encontrar un anuncio apropiado para un visitante determinado.)
  • Colaborar en un protocolo para compartir temas con tus socios orientados a la compra (la API de Topics necesita que cada SDK trabaje con socios de downstream para acordar cómo se comparten los datos de la API de Topics.)

Para las AdTech orientadas a la compra

  • Poder conéctarte con socios orientados a la venta para confirmar sus planes de observar temas y establecer su huella (para recibir temas, los proveedores de ventas deben llamar a la API de Topics al menos una vez por época.)
  • Colaborar en un protocolo para recibir temas de tus socios orientados a la venta (los temas son un nuevo indicador que compartirán los socios de venta como parte de la solicitud de anuncio. Los consumidores orientados a la compra deberán asegurarse de trabajar con sus socios de upstream para saber el modo en que se compartirán los temas.)
  • Incorporar temas en los modelos de ofertas y optimización (se espera que la API de Topics complemente otros indicadores, como el contexto, a fin de ayudar a encontrar un anuncio apropiado para el visitante.)

Requisitos previos y configuración

Los desarrolladores de apps, vendedores y compradores deben seguir estos pasos para configurar la API de Topics.

Familiarízate con la API

  1. Comienza por leer la propuesta de diseño para conocer la API de Topics y sus capacidades.
  2. Lee la guía para desarrolladores a fin de obtener información para incorporar el código y las llamadas a la API que necesitas en tus casos de uso.
  3. Revisa la taxonomía y proporciona comentarios sobre los temas que se incluyen en la lista.
  4. Envía comentarios sobre la propuesta de diseño o la documentación.
  5. Regístrate para recibir actualizaciones sobre la API de Topics. Esto te ayudará a estar al tanto de las funciones nuevas que se incluirán en versiones futuras.

Configura y prueba la app de ejemplo

  1. Sigue las instrucciones de esta página para configurar Privacy Sandbox en el SDK de Android en Android Studio.
  2. Bifurca y ejecuta el código en la versión de Java o Kotlin de la app de ejemplo para familiarizarte con la recuperación de temas en un dispositivo.
  3. Mientras pruebas, experimenta con la información de la app sobre el nombre y la descripción a fin de cambiar los temas que mostrarán el clasificador en el dispositivo.
  4. Una vez que comprendas cómo funcionan la API del cliente y las clasificaciones en el dispositivo, usa la app de ejemplo para guiar tu propia integración.

Sugerencia: Revisa detenidamente la utilidad de los datos de tema que se muestran sobre tu app. Identifica formas en las que crees que se puede mejorar la clasificación o la taxonomía, y envía comentarios si tienes recomendaciones para mejorar la taxonomía.