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.

Descarga la demostración de la API

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 él con el siguiente código:

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Para asegurarte de que todas las solicitudes de anuncios apliquen los cambios de configuración de la solicitud, configura la configuración de la solicitud antes de inicializar el SDK de anuncios para dispositivos móviles.

Configuración orientada a niños

Para los fines de la Ley de Protección de la Privacidad de Menores en Internet (COPPA), existe 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. Cuando indicas que quieres que Google trate tu contenido como dirigido a niños, la empresa 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 en true para indicar que deseas que tu contenido se trate como dirigido a niños para los fines de la COPPA. Esto evita la transmisión del identificador de publicidad, el IDFA.
• Establece tagForChildDirectedTreatment en false para indicar que no quieres que tu contenido se trate como dirigido a niños para los fines de la COPPA.
• No configures tagForChildDirectedTreatment si no quieres indicar cómo quieres que se trate tu contenido con respecto a la COPPA.

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

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Si configuras esta etiqueta, certificas que esta 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.

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 GDPR 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 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.

Para usar la configuración con todas las versiones del SDK de anuncios de Google para dispositivos móviles, configura la propiedad tagForUnderAgeOfConsent en el objeto GADMobileAds.requestConfiguration y pasa true.

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

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

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Las etiquetas para habilitar el parámetro de configuración dirigido a niños y tagForUnderAgeOfConsent 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

Las apps pueden establecer una clasificación máxima del contenido del anuncio para todas las solicitudes de anuncios con la propiedad maxAdContentRating de GADRequestConfiguration. Este parámetro de 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 las 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 que no sea superior a GADMaxAdContentRatingGeneral.

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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 la propiedad publisherPrivacyPersonalizationState de GADRequestConfiguration. 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 para 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:

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

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

URL de contenido

Cuando las apps solicitan un anuncio, 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 mientras muestra contenido de https://www.example.com, puedes pasar esta URL para segmentar palabras clave relevantes:

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

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 valores clave en una solicitud de anuncio. Las líneas de pedido que se segmentan para esos pares clave-valor son aptas para esa solicitud de anuncio. Para segmentar varios valores para una clave, ingresa los valores como una cadena separada por comas.

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

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 diferentes públicos pueden proporcionar una lista breve de URLs a través de la propiedad neighboringContentURLs. Las URLs de contenido vecino 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 de contenido similar a esas URLs, debes pasarlas de la siguiente manera:

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

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

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.

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

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

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

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 demo de la API de iOS:

Swift Objective-C

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 de IAB 1.1) y datos contextuales (Taxonomía de contenido de IAB 2.2).

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)

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é segmentación se utiliza cuando un anuncio se actualiza automáticamente?

En la actualización de anuncios, se vuelve a usar el objeto GAMRequest especificado anteriormente para la segmentación. Para establecer una segmentación nueva, llama de forma explícita a loadRequest en GAMBannerView con un objeto GAMRequest nuevo.

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

Consulta Mediación para obtener información sobre cómo enviar la segmentación a las redes de mediación.