Segmentación

La segmentación te permite proporcionar información contextual y del público a Google Mobile Ads SDK for React Native para mostrar anuncios relevantes a tus usuarios.

Puedes configurar la segmentación en los siguientes niveles:

  • Configuración global de solicitudes: Aplica parámetros de configuración en todas las solicitudes de anuncios de tu app, incluidos los tratamientos para niños y adolescentes, las clasificaciones máximas del contenido de los anuncios, los tratamientos de privacidad de los publicadores y los IDs de dispositivos de prueba.
  • Segmentación por solicitud: Personaliza las solicitudes de anuncios individuales con objetos de solicitud de anuncios, incluidas las URLs de contenido y los extras de red.

En esta guía, se explica cómo proporcionar información de segmentación a Google Mobile Ads SDK for React Native.

Requisitos previos

Antes de continuar, configura el Google Mobile Ads SDK for React Native.

Establece la configuración de la solicitud

El objeto RequestConfiguration recopila información de segmentación que se aplica de forma global a todas las solicitudes de anuncios.

Para aplicar la configuración de segmentación de tu primera solicitud de anuncio, establece la propiedad requestConfiguration cuando llames al método initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Reemplaza TEST_DEVICE_HASHED_ID por un ID de dispositivo de prueba con codificación hash. Este ID especifica un dispositivo que debería recibir anuncios de prueba.

Para actualizar la configuración de segmentación después de inicializar Google Mobile Ads SDK for React Native, llama al método setRequestConfiguration. El método setRequestConfiguration reemplaza una configuración existente y se aplica a las solicitudes de anuncios posteriores.

En el siguiente ejemplo, se revisa un objeto RequestConfiguration con parámetros de configuración de segmentación actualizados y se aplican esos parámetros a las solicitudes de anuncios:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Establece el tratamiento según la edad

Para ayudarte a administrar el cumplimiento de las reglamentaciones de privacidad aplicables relacionadas con niños y adolescentes, el Google Mobile Ads SDK for React Native proporciona un parámetro de configuración de tratamiento según la edad. Este parámetro te permite indicar si el Google Mobile Ads SDK for React Native debe aplicar restricciones publicitarias específicas para la protección de niños, adolescentes o una edad no especificada.

Puedes configurar el tratamiento de contenido según la edad con la propiedad ageRestrictedTreatment en RequestConfiguration.

En el siguiente ejemplo, se indica que las solicitudes de anuncios deben recibir el tratamiento de contenido para niños:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Para indicar el tratamiento de contenido según la edad para adolescentes o una edad no especificada, reemplaza el parámetro de configuración AgeRestrictedTreatment.CHILD por lo siguiente:

Cuando usas este parámetro de configuración, el Google Mobile Ads SDK for React Native incluye un parámetro tfat en las solicitudes de anuncios. Comunícate con tu asesor legal para determinar cuál es el tratamiento según la edad aplicable para tus usuarios en función de tus obligaciones legales y reglamentarias. Para obtener más información, consulta Cómo etiquetar una solicitud de anuncio de una app para el contenido restringido por edad.

Filtrar el contenido de los anuncios

La clasificación máxima del contenido del anuncio te permite controlar el contenido de los anuncios que se muestran a tus usuarios. Puedes establecer una clasificación máxima del contenido para ayudar a garantizar el cumplimiento de las políticas de la plataforma.

Puedes establecer una clasificación máxima del contenido del anuncio para las solicitudes de anuncios en tu app con la propiedad maxAdContentRating del objeto RequestConfiguration. Después de configurar este parámetro, los anuncios que se devuelvan tendrán una clasificación del contenido igual o inferior a esa clasificación. Los valores posibles para este parámetro se basan en las clasificaciones de etiquetas de contenido digital y deben ser una de las siguientes constantes:

En el siguiente ejemplo, se configura un objeto RequestConfiguration para especificar que el contenido del anuncio que se devuelve debe corresponder a una clasificación de etiqueta de contenido digital no superior a la constante G:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Si deseas obtener más información, consulta los siguientes recursos:

Opcional: Configura la API de PPT (beta)

La API de Publisher Privacy Treatment (PPT) te permite indicar si se debe desactivar la personalización de anuncios para todas las solicitudes de anuncios que usan la propiedad publisherPrivacyPersonalizationState en el objeto RequestConfiguration. Cuando usas esta función, el Google Mobile Ads SDK for React Native incluye un parámetro de tratamiento de privacidad del publicador (PPT) en todas las solicitudes de anuncios durante el resto de la sesión.

De forma predeterminada, se publican anuncios personalizados para las solicitudes de anuncios que se envían a Google. En el siguiente ejemplo, se desactiva la personalización de anuncios para todas las solicitudes de anuncios:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Configura el objeto AdRequest

El objeto AdRequest recopila información de segmentación que se envía con una solicitud de anuncio.

A diferencia de la configuración global establecida con el método setRequestConfiguration, el objeto AdRequest se pasa al método load de una clase de formato del anuncio, por ejemplo, InterstitialAd.load para los anuncios intersticiales o BannerAd.load para los anuncios de banner.

Agrega parámetros adicionales de red

Para pasar parámetros específicos de la red a Google Mobile Ads SDK for React Native, como los parámetros de los anuncios contraíbles, usa la propiedad extras.

En el siguiente ejemplo, se establece una clave de parámetro adicional de collapsible con un valor de bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Proporciona una URL de contenido

Si quieres proporcionar una URL de contenido para los anuncios segmentados por contenido y la seguridad de la marca, agrega la propiedad contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

La URL del contenido debe tener hasta 512 caracteres.