Segmentación

OBSOLETO: El SDK de C++ de anuncios de Google para dispositivos móviles está obsoleto a partir del 17 de junio de 2024 y no se debe adoptar en proyectos que no lo hayan estado usando previamente. Entrará en Fin del mantenimiento (EoM) el 17 de junio de 2025. Ten en cuenta que las versiones del SDK que se lanzaron antes de la fecha de EoM seguirán funcionando, pero no se lanzarán más correcciones de errores ni cambios después de esa fecha.

En lugar del SDK de C++ de anuncios de Google para dispositivos móviles, considera usar los SDKs para iOS y Android de AdMob. Para obtener asistencia, comunícate con el Foro técnico del SDK de anuncios de Google para dispositivos móviles.

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

Requisitos previos

• Completa 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 orientada 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 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 si fuese para niños, tomaremos las medidas necesarias para inhabilitar en anuncios de IBA y remarketing en la solicitud de anuncio en cuestión.

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 trate como contenido dirigido a niños a los efectos 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.

Nota: Las apps del Programa Diseñado para Familias que se clasifiquen como Apps dirigidas principalmente a niños y los usuarios que accedan a Cuentas de Google administradas con Family Link tendrán todo el contenido tratado como dirigido a niños para todas las solicitudes de anuncios.

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 tiene el propósito de 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 para 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 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::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 la de usuarios que no alcanzan la edad de consentimiento no deben configurarse en "true" al mismo tiempo. Si es así, la configuración dirigida a niños tiene prioridad.

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 las 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 estructura RequestConfiguration 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 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 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:

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

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