Segmentación

En esta guía, se explica cómo proporcionar información sobre la segmentación a una solicitud de anuncio. Para un ejemplo de funcionamiento, descarga la app de demostración de Android API.

Descargar demostración de API

Requisitos

• Completa la Guía de introducción.

RequestConfiguration

RequestConfiguration es un objeto que recopila información sobre orientación que se aplicará globalmente a través de un MobileAds método estático.

Para actualizar la configuración de la solicitud, obtén un compilador a partir del realizar las actualizaciones deseadas y configurarla de la siguiente manera:

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

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

Configuración de contenido dirigido a niños

En virtud de la Ley de Protección de la Privacidad de Menores en Internet (COPPA), hay un parámetro de configuración llamado "etiqueta de contenido dirigido a niños". Si configuras esta etiqueta, certificas que esta notificación es correcta y que tienes autorización para actuar en nombre del propietario de la aplicación. Que comprendes que el abuso de este parámetro de configuración puede ocasionar la rescisión de tu Cuenta de Google.

Como desarrollador de apps, puedes indicar si deseas que Google trate a contenido como dirigido a niños cuando realiza una solicitud de anuncio. Si indicas que desea que Google trate su contenido como dirigido a niños, tomamos medidas para lo siguiente: inhabilitar los anuncios de remarketing y de publicidad basada en intereses en esa solicitud de anuncio.

El parámetro de configuración se puede usar con todas las versiones del SDK de Servicios de Google Play a través de RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• Llamar a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE para indicar que deseas que tu contenido que se considera dirigido a niños de conformidad con la ley COPPA. Esto evita la transmisión del identificador de publicidad de Android (AAID).

• Llamar a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE para indicar que no deseas que tu contenido que se considera dirigido a niños de conformidad con la ley COPPA.

• Llamar a setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED si no quieres indicar cómo te gustaría que se tratara tu contenido con respecto a la COPPA en las solicitudes de anuncios.

En el siguiente ejemplo, se indica que quieres que se trate tu contenido como contenido dirigido a niños conforme a la ley COPPA:

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

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

Usuarios que no alcanzan la edad de consentimiento

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

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

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

• Llamar a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE para indicar que desea que la solicitud de anuncio reciba tratamiento para usuarios de en el Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento. Esto también impide la transmisión del identificador de publicidad de Android (AAID).

• Llamar a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE para indicar que deseas que la solicitud de anuncio no se trate para los usuarios. en el Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento.

• Llamar a setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED para indicar que no especificó si la solicitud de anuncio debería recibir tratamiento para los usuarios en la Espacio Económico Europeo (EEE) que no alcanza la edad de consentimiento.

El siguiente ejemplo indica que deseas que se incluya TFUA en tus solicitudes de anuncios:

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

var 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 lo están, prevalecerá la configuración de contenido dirigido a niños.

Filtrado de contenido de anuncios

Para cumplir con la Política de Anuncios Inapropiados de Google Play que incluya las ofertas asociadas a un anuncio, todos los anuncios y sus ofertas que se muestren en la aplicación deben ser apropiadas para el contenido calificación de su aplicación, incluso si el contenido cumple con los requisitos de las las políticas de Play.

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

Las aplicaciones pueden establecer una clasificación máxima del contenido del anuncio para sus solicitudes de anuncios mediante el setMaxAdContentRating . Los anuncios de AdMob que se muestran cuando se configura esta opción tienen una clasificación del contenido de por debajo de ese nivel. Los valores posibles para este extra de red se basan en clasificaciones de etiquetas de contenido digital y debe 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 muestre debe corresponder a la designación de una etiqueta de contenido digital superior a G:

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

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

Consulta lo siguiente:

• Cómo configurar la clasificación máxima del contenido de cada anuncio solicitud

• Configurar la clasificación máxima del contenido del anuncio para una aplicación o cuenta

Tratamiento de Privacidad para Publicadores (Beta)

El Tratamiento de Privacidad del Publicador (PPT) La API es una herramienta opcional que permite que las apps indiquen si deben desactivar los anuncios la personalización para todas las solicitudes de anuncios setPublisherPrivacyPersonalizationState(). Cuando se utiliza esta función, se aplica un parámetro de tratamiento de privacidad del publicador (PPT) se incluirá en todas las solicitudes de anuncios futuras para el resto de la sesión.

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

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

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

Solicitud de anuncio

El objeto AdManagerAdRequest recopila la segmentación. que se enviará con una solicitud de anuncio.

Segmentación personalizada

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

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

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

Puede pasar varios valores para una clave como una lista de cadenas. Por ejemplo, para orientar anuncios a personas de entre 20 y 25 años, en lugar de solo 25.

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

Consulta el ejemplo de segmentación personalizada de Ad Manager. para implementar una orientación personalizada en la app Android API Demo.

Exclusiones de categorías

Para agregar un nivel de exclusión de categoría a nivel del espacio publicitario a una solicitud, utiliza el addCategoryExclusion() método proporcionado por AdManagerAdRequest.Builder:

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

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

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

Identificadores proporcionados por el publicador

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

Este es un ejemplo de configuración del PPID:

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

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

Consulta el ejemplo de PPID de Ad Manager. para una implementación de identificadores proporcionados por el publicador (PPID) en la biblioteca App de demostración de API.

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 los PPS, puedes usar los datos del usuario para mejorar la monetización programática comunicando las características de tu público a ofertantes de todos tipos de transacciones taxonomías estándar, sin la necesidad de compartir identificadores de usuario. Tu público características pueden incluir datos basados en intereses y en el comportamiento (Público de IAB Taxonomía 1.1) y el contexto (taxonomía de contenido de IAB 2.2).

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()

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()

URL de contenido

Si deseas proporcionar una URL de contenido para los anuncios con segmentación por contenido y la seguridad de la marca, puedes llamar a setContentUrl() cuando compilas un AdManagerAdRequest:

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

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

Seguridad de la marca (beta)

Las aplicaciones que muestran contenido dinámico destinado a públicos diversos tienen las siguientes características: una lista corta de URLs con el setNeighboringContentUrls() cuando compilas un AdManagerAdRequest:

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();

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

.setNeighboringContentUrls() se diferencia de .setContentUrl() en que solo es para la seguridad de la marca.