Segmentación

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

Requisitos previos

RequestConfiguration

RequestConfiguration es un struct que recopila información de segmentación para aplicarla de forma 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 establécela de la siguiente manera:

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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 una configuración llamada "etiqueta de contenido dirigido a niños". 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. 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 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 los anuncios de remarketing y la IBA en esa solicitud de anuncio.

Para configurar el parámetro de configuración, asigna el miembro tag_for_child_directed_treatment del struct RequestConfiguration a uno de los siguientes valores enumerados:

  • Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue para indicar que quieres que tu contenido se trate como dirigido a niños con fines de la ley COPPA.
  • Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que no quieres que se trate tu contenido como dirigido a niños de conformidad con la ley COPPA.
  • Asigna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified si no quieres indicar cómo quieres que se trate tu contenido con respecto a la ley COPPA en las solicitudes de anuncios.

En el siguiente ejemplo, se indica que quieres que tu contenido se trate como dirigido a niños de conformidad con la ley 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 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.

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 podrías 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 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 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 se trate para los 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 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 contenido del Espacio Económico Europeo (EEE) que no alcanza la edad de consentimiento.

En el siguiente ejemplo, se indica que deseas que se incluya 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 alcanzan la edad de consentimiento no deben establecerse a la vez como verdaderas. Si es así, prevalecerá la configuración de contenido dirigido a niños.

Filtrado del contenido del anuncio

Las apps pueden establecer una clasificación máxima del contenido del anuncio para sus solicitudes de anuncios mediante RequestConfiguration::max_ad_content_rating field. Los anuncios de AdMob que se muestran cuando se configura tienen una clasificación del contenido igual o inferior a ese nivel. Los valores posibles se basan en 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 mayor que 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 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:

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

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