Se usó la API de Cloud Translation para traducir esta página.

Orientación

En esta guía, se explica cómo proporcionar información de segmentación al SDK de Google Mobile Ads.

Para ver un ejemplo en funcionamiento, descarga la app de demostración de la API de Android.

Requisitos

Completa la guía de introducción.

RequestConfiguration

RequestConfiguration recopila la información de segmentación que se aplica de forma global a cada solicitud de anuncio. Para conocer las etiquetas de segmentación disponibles, consulta la documentación de RequestConfiguration.Builder.

Para actualizar la configuración de la solicitud, obtén un compilador de la configuración existente, realiza las actualizaciones deseadas y configúralo de la siguiente manera:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Configuración orientada a niños

Debido a la Ley de Protección de la Privacidad Infantil en Internet (COPPA), existe una configuración llamada "etiqueta para tratamiento orientado a niños". Si configuras esta etiqueta, certificas que la notificación es precisa y que tienes autorización para actuar en nombre del propietario de la app. Comprendes que el abuso de este parámetro de configuración puede resultar en el cierre de tu Cuenta de Google.

Como desarrollador de apps, puedes indicar si deseas que Google trate tu contenido como dirigido a niños cuando envías una solicitud de anuncio. Si indicas que quieres que Google trate tu contenido como dirigido a niños, tomaremos las medidas necesarias para inhabilitar la IBA y los anuncios de remarketing en esa solicitud de anuncio.

Puedes aplicar la configuración para niños a través de setTagForChildDirectedTreatment():

Llama a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE para indicar que deseas que tu contenido se trate como contenido dirigido a niños para fines de la COPPA. Esto evita la transmisión del identificador de publicidad de Android (AAID).
Llama a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE para indicar que no quieres que tu contenido se considere dirigido a niños para fines de la COPPA.
Llama a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED si no deseas indicar cómo deseas que se trate tu contenido con respecto a la COPPA en las solicitudes de anuncios.

En el siguiente ejemplo, se indica que deseas que tu contenido se trate como contenido dirigido a niños a los efectos de la COPPA:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Usuarios que no alcanzaron la edad de consentimiento

Puedes marcar tus solicitudes de anuncios de manera que se traten como contenido para usuarios del Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento. Esta función está diseñada para facilitar el cumplimiento del Reglamento General de Protección de Datos (GDPR). Ten en cuenta que puedes tener otras obligaciones legales en virtud del GDPR. Revisa los lineamientos de la Unión Europea y consulta a tu asesor legal. Ten en cuenta que las herramientas de Google están diseñadas para facilitar el cumplimiento y no eximen a ningún publicador de sus obligaciones legales. Obtén más información sobre cómo el RGPD afecta a los publicadores.

Cuando uses esta función, se incluirá un parámetro de etiqueta para usuarios que no alcanzan la edad de consentimiento en Europa (TFUA) en la solicitud de anuncio. Este parámetro inhabilita la publicidad personalizada, incluido el remarketing, para todas las solicitudes de anuncios. También inhabilita las solicitudes a proveedores de anuncios externos, como los píxeles de medición de anuncios y los servidores de anuncios de terceros.

Al igual que la configuración para contenido dirigido a niños, hay un método en RequestConfiguration.Builder para configurar el parámetro TFUA: setTagForUnderAgeOfConsent() ycon las siguientes opciones.

Llama a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE para indicar que deseas que la solicitud de anuncio se trate como contenido para usuarios del Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento. Esto también evita la transmisión del identificador de publicidad de Android (AAID).
Llama a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE para indicar que deseas que la solicitud de anuncio no reciba el tratamiento para usuarios del Espacio Económico Europeo (EEE) que no alcancen la edad de consentimiento.
Llama a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED para indicar que no especificaste si la solicitud de anuncio debe recibir tratamiento para usuarios del Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento.

En el siguiente ejemplo, se indica que deseas que se incluya la TFUA en tus solicitudes de anuncios:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Las etiquetas para habilitar el parámetro de configuración de contenido dirigido a niños y setTagForUnderAgeOfConsent() no deben configurarse simultáneamente en true. Si es así, el parámetro de configuración para contenido dirigido a niños tendrá prioridad.

Filtrado de contenido de anuncios

Para cumplir con la Política de Anuncios Inapropiados de Google Play, que incluye ofertas asociadas dentro de un anuncio, todos los anuncios y sus ofertas asociadas que se muestran en tu app deben ser adecuados para la clasificación del contenido de tu app, incluso si el contenido en sí satisface las políticas de Google Play.

Las herramientas como la clasificación máxima del contenido del anuncio pueden ayudarte a tener más control sobre el contenido de los anuncios que se muestran a tus usuarios. Puedes establecer una clasificación máxima del contenido para ayudar a garantizar el cumplimiento de las políticas de la plataforma.

Las apps pueden establecer una clasificación máxima del contenido del anuncio para sus solicitudes de anuncios con el método setMaxAdContentRating . Los anuncios de AdMob que se muestran cuando se configura esta opción tienen una clasificación del contenido igual o inferior a ese nivel. Los valores posibles para este extra de red se basan en las clasificaciones de etiquetas de contenido digital y deben ser una de las siguientes cadenas:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

El siguiente código configura un objeto RequestConfiguration para especificar que el contenido del anuncio que se muestra debe corresponder a una designación de etiqueta de contenido digital que no sea superior a G:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Conoce más sobre:

Tratamiento de Privacidad del Publicador (beta)

La API de Tratamiento de Privacidad del Publicador (PPT) es una herramienta opcional que permite que las apps indiquen si se debe desactivar la personalización de anuncios para todas las solicitudes de anuncios con el método setPublisherPrivacyPersonalizationState(). Cuando se usa esta función, se incluye un parámetro de tratamiento de la privacidad del publicador (PPT) en todas las solicitudes de anuncios futuras durante el resto de la sesión.

De forma predeterminada, las solicitudes de anuncios a Google publican anuncios personalizados. El siguiente código desactiva la personalización de anuncios para todas las solicitudes de anuncios:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Solicitud de anuncio

El objeto AdManagerAdRequest recopila información de segmentación para su envío con una solicitud de anuncio.

Segmentación personalizada

Puedes pasar pares clave-valor personalizados para segmentar campañas de Google Ad Manager (líneas de pedido) a través de AdManagerAdRequest.Builder.addCustomTargeting():

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Puedes pasar varios valores para una clave como una lista de cadenas. Por ejemplo, para segmentar anuncios para personas de unos 25 años en lugar de solo para personas de 25 años.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Consulta el ejemplo de segmentación personalizada de Ad Manager para ver una implementación de la segmentación personalizada en la app de demostración de Android API.

Exclusiones de categorías

Puedes agregar un nivel de exclusión de categorías a nivel del espacio a una solicitud con el método addCategoryExclusion() que proporciona AdManagerAdRequest.Builder:

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Consulta el ejemplo de exclusiones de categorías de Ad Manager para ver una implementación de exclusiones de categorías en la app de demostración de la API de Android.

Identificadores proporcionados por el publicador

Puedes configurar un identificador proporcionado por el publicador (PPID) para usarlo en la limitación de frecuencia, la segmentación y orientación por público, la rotación secuencial de anuncios y otros controles de publicación de anuncios basados en el público en todos los dispositivos.

Este es un ejemplo de cómo configurar el PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Java

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

Consulta el ejemplo de PPID de Ad Manager para ver una implementación de los identificadores proporcionados por el publicador (PPID) en la app de demostración de la API de Android.

Indicadores proporcionados por el publicador

Puedes enviar datos contextuales y de público como indicadores proporcionados por el publicador (PPS) en las solicitudes de anuncios. Con PPS, puedes usar tus datos de usuarios para mejorar la monetización programática, ya que puedes comunicar las características de tu público a los ofertantes en todos los tipos de transacciones con taxonomías estándar, sin necesidad de compartir identificadores de usuario. Las características de tu público pueden incluir datos basados en intereses y comportamientos (Taxonomía de público 1.1 de IAB) y datos contextuales (Taxonomía de contenido 2.2 de IAB).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

URL de contenido

Para proporcionar una URL de contenido para los anuncios segmentados por contenido y la seguridad de la marca, puedes llamar a setContentUrl() cuando crees un AdManagerAdRequest:

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

Seguridad de la marca (beta)

Las aplicaciones que muestran contenido dinámico destinado a diferentes públicos pueden proporcionar una lista breve de URLs con el método setNeighboringContentUrls() cuando se crea un AdManagerAdRequest:

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() difiere de .setContentUrl() en que solo se usa para la seguridad de la marca.