Segmentación

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

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

Descargar demostración de la API

Requisitos previos

Completar la guía de introducción

GADRequestConfiguration

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

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

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

A los efectos 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 aplicaciones, 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, 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 en true para indicar que quieres que tu contenido se trate como dirigido a niños a los efectos de la COPPA. Esto evita la transmisión del identificador de publicidad, IDFA.
• Establece tagForChildDirectedTreatment en false para indicar que no quieres que tu contenido se trate como dirigido a niños a los efectos de la COPPA.
• No establezcas 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 quieres que tu contenido se considere como dirigido a niños a los efectos de la COPPA:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Si configuras esta etiqueta, certificas que esta notificación es correcta y que tienes autorización para actuar en nombre del propietario de la app. A su vez, declaras que comprendes que el abuso de este parámetro de configuración puede provocar el cierre de tu Cuenta de Google.

Usuarios que no alcanzan la edad de consentimiento

Puedes marcar tus solicitudes de anuncios para 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 (RGPD). Ten en cuenta que puedes tener otras obligaciones legales en virtud del RGPD. Revisa los lineamientos de la Unión Europea y consulta a tu asesor legal. Recuerda 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 se usa esta función, se incluye 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 externos de publicidad, como los servidores de anuncios de terceros y los píxeles de medición de anuncios.

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, se debe establecer la propiedad tagForUnderAgeOfConsent en el objeto GADMobileAds.requestConfiguration y pasar true.

• Establece tagForUnderAgeOfConsent en true para indicar que quieres que las solicitudes de anuncios se controlen de 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 se configura tagForUnderAgeOfConsent, se indica que no quieres que las solicitudes de anuncios se controlen de manera adecuada para los usuarios que no alcanzan la edad de consentimiento.

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

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Las etiquetas para habilitar el parámetro de configuración de contenido dirigido a niños y tagForUnderAgeOfConsent no deben estar simultáneamente establecidas en true. De ser así, prevalecerá el parámetro de configuración de contenido dirigido a niños.

Filtrado de contenido de anuncios

Las apps pueden establecer una clasificación máxima del contenido del anuncio para todas las solicitudes de anuncios que tienen la propiedad maxAdContentRating de GADRequestConfiguration. Este parámetro de configuración se aplicará a todas las solicitudes de anuncios futuras durante el resto de la sesión. Los posibles valores 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 devuelve debe corresponder a una designación de etiqueta de contenido digital que no sea mayor que GADMaxAdContentRatingGeneral.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (Beta)

La API de Publisher Privacy Treatment (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 que tienen la propiedad publisherPrivacyPersonalizationState de GADRequestConfiguration. Cuando se usa esta función, se incluye un parámetro de tratamiento de 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 se publican como anuncios personalizados. El siguiente código desactiva la personalización de anuncios para todas las solicitudes de anuncios:

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

El objeto GAMRequest recopila información de segmentación para enviarla con una solicitud de anuncio.

Agrega parámetros adicionales de red

Los parámetros adicionales de red son detalles complementarios que se envían con una solicitud de anuncio y que son específicos para una fuente de anuncios en particular.

El siguiente fragmento de código establece una clave de parámetro adicional de collapsible con un valor de bottom para Google:

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

URL de contenido

Cuando solicitan un anuncio, las apps pueden pasar la URL del contenido que publican. Esto permite que se use la segmentación por palabras clave para que el anuncio coincida 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 = AdManagerRequest()
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 publicarse en función de esa solicitud de anuncio. Para segmentar anuncios para varios valores de una clave, ingresa los valores como una cadena separada por comas.

let request = AdManagerRequest()
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 corta de URLs a través de la propiedad neighboringContentURLs. Las URLs de contenido adyacente 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. Puedes solicitar anuncios que tengan una clasificación del contenido similar a la de esas URLs pasándolas de la siguiente manera:

let request = AdManagerRequest()
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 establecer 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.

El PPID se establece a través de GAMRequest:

let request = AdManagerRequest()
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 demostración 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 los PPS, puedes usar tus datos de los usuarios 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 y sin necesidad de compartir identificadores de usuarios. Las características de tu público pueden incluir datos basados en intereses y comportamiento (Taxonomía de público de IAB 1.1) y datos contextuales (Taxonomía de contenido de IAB 2.2).

let extras = Extras()
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 = AdManagerRequest()
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é tipo de segmentación se usa 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 de forma explícita a loadRequest en GAMBannerView con un nuevo objeto GAMRequest.

¿Cómo se pueden pasar 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.