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

Segmentación

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

Requisitos previos

Completa la sección Comenzar.

`RequestConfiguration`

RequestConfiguration es una estructura que recopila información de segmentación para aplicarla a nivel global a través de la función global SetRequestConfiguration().

Para actualizar la configuración de la solicitud, primero obtén la configuración actual, realiza las actualizaciones deseadas y configúrala de la siguiente manera:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Configuración de contenido dirigido 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 la rescisión de tu Cuenta de Google.

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. Si indicas que deseas que Google trate tu contenido como dirigido a niños, tomaremos medidas para inhabilitar la IBA y los anuncios de remarketing en esa solicitud de anuncio.

Para configurar el parámetro, asigna el miembro tag_for_child_directed_treatment de la estructura RequestConfiguration a uno de los siguientes valores enumerados:

Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue para indicar que deseas que tu contenido se trate como contenido dirigido a niños para los fines de la COPPA.
Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que no deseas que tu contenido se trate como dirigido a niños para los fines de la COPPA.
Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified 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 considere dirigido a niños para los fines de la COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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.

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. 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 uses esta función, se incluirá un parámetro Tag For Users under the Age of Consent in Europe (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 de contenido dirigido a niños, hay un miembro en RequestConfiguration para configurar el parámetro TFUA: tag_for_under_age_of_consent, que se puede configurar con los siguientes valores enumerados:

Asigna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentTrue para indicar que deseas que la solicitud de anuncio reciba tratamiento para usuarios del Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento.
Asigna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse para indicar que deseas que la solicitud de anuncio no se trate como contenido para usuarios del Espacio Económico Europeo (EEE) que no alcanzan la edad de consentimiento.
Asigna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentUnspecified para indicar que no especificaste si la solicitud de anuncio debe recibir el 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:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Las etiquetas para habilitar la configuración de contenido dirigido a niños y los usuarios que no alcanzaron la edad de consentimiento no deben establecerse al mismo tiempo como verdaderas. Si lo están, prevalecerá la 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 sus solicitudes de anuncios a través de RequestConfiguration::max_ad_content_rating field. 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 esto se basan en las clasificaciones de etiquetas de contenido digital y deben ser uno de los siguientes valores enumerados:

RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

`AdRequest`

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

URL de contenido

Cuando las apps solicitan un anuncio, pueden pasar la URL del contenido que publican. Esto permite usar 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:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();