Segmentación

En esta guía, se explica cómo proporcionar información de segmentación a una solicitud de anuncio.

Para ver la segmentación de anuncios en acción, descarga la app de demostración de la API de iOS en Swift o Objective-C.

Descargar API Demo

Requisitos previos

Completa la Guía de introducción.

GADRequestConfiguration

GADRequestConfiguration es un objeto que recopila información de segmentación para aplicarla de forma global a través de la instancia compartida GADMobileAds. Se puede acceder a ella con el siguiente código:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective‑C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Parámetro de configuración de contenido dirigido a niños

Para cumplir con la Ley de Protección de la Privacidad de Menores en Internet (COPPA), hay un parámetro de configuración llamado tagForChildDirectedTreatment.

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, Google toma medidas para inhabilitar la IBA y los anuncios de remarketing en esa solicitud de anuncio. Las opciones de configuración son las siguientes:

• Establece tagForChildDirectedTreatment como true para indicar que quieres que tu contenido se considere dirigido a niños con fines de la ley COPPA. Esto evita la transmisión del identificador de publicidad, el IDFA.
• Establece tagForChildDirectedTreatment como false para indicar que no quieres que tu contenido se trate como dirigido a niños de conformidad con la ley COPPA.
• No configures tagForChildDirectedTreatment si no quieres indicar cómo te gustaría que se trate tu contenido con respecto a la ley COPPA.

En el siguiente ejemplo, se indica que quieres que tu contenido se considere dirigido a niños de conformidad con la ley COPPA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective‑C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Si configuras esta etiqueta, certificas que esta notificación es precisa y que estás autorizado para actuar en nombre del propietario de la app. Además, comprendes que el abuso de esta configuración puede ocasionar la rescisión de tu Cuenta de Google.

Usuarios que no alcanzan 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). Tenga en cuenta que puede 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 GDPR afecta a los publicadores.

Cuando se utilice esta función, se incluirá un parámetro de Etiqueta para usuarios que no alcanzaron la edad de consentimiento en Europa (TFUA) en todas las solicitudes de anuncios futuras. Este parámetro inhabilita la publicidad personalizada, incluido el remarketing, para esa solicitud de anuncio específica. 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.

Este parámetro de configuración se puede usar con todas las versiones del SDK de anuncios de Google para dispositivos móviles. Para ello, debes configurar la propiedad tagForUnderAgeOfConsent en el objeto GADMobileAds.requestConfiguration y pasar true.

• Establece tagForUnderAgeOfConsent como true para indicar que deseas que las solicitudes de anuncios se manejen de una manera adecuada para los usuarios que no alcanzaron la edad de consentimiento. Esto también evita la transmisión del IDFA, el identificador de publicidad.
• Si no estableces tagForUnderAgeOfConsent, significa que no quieres que las solicitudes de anuncios se manejen de una manera adecuada para usuarios que no alcanzaron la edad de consentimiento.

En el siguiente ejemplo, se indica que deseas que se incluya TFUA en tu solicitud de anuncio:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective‑C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Las etiquetas para habilitar la configuración de contenido dirigido a niños y tagForUnderAgeOfConsent no deben establecerse simultáneamente en true. Si es así, prevalecerá la configuración de contenido dirigido a niños.

Punto clave: Este parámetro tagForUnderAgeOfConsent no se reenvía a los adaptadores de mediación de redes de publicidad. Es tu responsabilidad garantizar que cada red de publicidad de terceros en tu app publique anuncios que sean adecuados para usuarios que no alcancen la edad de consentimiento conforme al GDPR.

Filtrado del contenido del anuncio

Las apps pueden establecer una clasificación máxima del contenido del anuncio para todas las solicitudes de anuncios mediante la propiedad maxAdContentRating de GADRequestConfiguration. Esta configuración se aplica a todas las solicitudes de anuncios futuras durante el resto de la sesión. Los valores posibles para esta propiedad se basan en clasificaciones de etiquetas de contenido digital y deben ser una de las siguientes constantes:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

El siguiente código configura todas las solicitudes de anuncios para especificar que el contenido del anuncio que se muestra debe corresponder a una designación de etiqueta de contenido digital no mayor que GADMaxAdContentRatingGeneral.

Punto clave: La configuración del filtro de clasificación del contenido que se especifique a través del SDK anula cualquier configuración establecida con la Ad Manager IU.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective‑C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Tratamiento de Privacidad del Editor (beta)

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

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective‑C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Nota: En el caso de las solicitudes de anuncios con varios indicadores de privacidad del usuario, prevalecerá el indicador más restrictivo. Consulta la documentación de la API de Tratamiento de Privacidad para Publicadores para obtener ejemplos específicos.

GAMRequest

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

URL de contenido

Cuando solicitan un anuncio, las apps pueden pasar la URL del contenido que publican. Esto permite que la segmentación por palabras clave haga coincidir el anuncio con el contenido.

Por ejemplo, si tu app solicita un anuncio al mismo tiempo que muestra contenido de https://www.example.com, puedes pasar esta URL para segmentar palabras clave relevantes:

Swift

let request = GAMRequest()
request.contentURL = "https://www.example.com"

Objective‑C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

Segmentación personalizada

Una vez que hayas configurado los pares clave-valor en la IU de Ad Manager, establece la segmentación personalizada con los pares clave-valor en una solicitud de anuncio. Las líneas de pedido que se orientan a esos pares clave son aptas para publicarse en función de esa solicitud de anuncio. Si quieres incluir varios valores para una clave, ingresa los valores como una cadena separada por comas.

Swift

let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective‑C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Seguridad de la marca (beta)

Las apps que muestran contenido dinámico destinado a públicos variables pueden proporcionar una breve lista de URLs a través de la propiedad neighboringContentURLs. Las URLs de contenido vecinas difieren de la propiedad contentURL en que solo se usan para la seguridad de la marca.

Supongamos que tu app muestra contenido de cuatro URLs en un feed que también contiene anuncios. Para solicitar anuncios que tengan una clasificación del contenido similar a la de esas URLs, pásalos de la siguiente manera:

Swift

let request = GAMRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective‑C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Punto clave: El SDK solo usa las cuatro primeras URLs. Se ignorarán todos los demás.

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 segmentación de 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.

Nota: Esta función no está disponible para todos los publicadores. Consulta Acerca de los identificadores proporcionados por el publicador para obtener más detalles.

La configuración del PPID se realiza a través de GAMRequest:

Swift

let request = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective‑C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

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

Objective‐C de Swift

Indicadores proporcionados por el publicador

Puedes enviar datos contextuales y del público como indicadores proporcionados por el publicador (PPS) en las solicitudes de anuncios. Con PPS, puedes usar tus datos del usuario para mejorar la monetización programática comunicando 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 de IAB 1.1) y datos contextuales (taxonomía de contenido de IAB 2.2).

Swift

let extras = GADExtras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = GAMRequest()()
request.register(extras)

Objective‑C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Preguntas frecuentes

¿Qué tipo de segmentación se utiliza cuando un anuncio se actualiza automáticamente?

Cuando se actualiza un anuncio, el objeto GAMRequest especificado anteriormente se vuelve a usar para la segmentación. Para establecer una nueva segmentación, llama explícitamente a loadRequest en GAMBannerView con un nuevo objeto GAMRequest.

¿Cómo transfiero parámetros de segmentación adicionales a las redes de mediación?

Consulta Mediación para averiguar cómo enviar orientación a las redes de mediación.