Targeting

En esta guía te explicamos cómo puedes incluir información sobre la segmentación en una solicitud de anuncio. Para consultar un ejemplo práctico, descarga la aplicación API Demo de Android.

Descargar API Demo

Requisito

  • Hacer todo lo que se indica en la guía Empezar.

RequestConfiguration

El objeto RequestConfiguration recoge información sobre la segmentación para aplicarla globalmente mediante el método estático MobileAds.

Para cambiar los ajustes de la solicitud, copia un patrón builder de la configuración actual, realiza las modificaciones que quieras y defínelo de la siguiente manera:

Java

    RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .build();
    MobileAds.setRequestConfiguration(requestConfiguration);
    

Kotlin

    var requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .build()
    MobileAds.setRequestConfiguration(requestConfiguration)
    

Contenido dirigido a niños

Para cumplir la ley de protección de la privacidad infantil online de EE. UU. (Children’s Online Privacy Protection Act o COPPA), hay un ajuste que permite etiquetar contenido como dirigido a niños. Si asignas un valor a esta etiqueta, certificas que la notificación es correcta y que tienes autorización para actuar en nombre del propietario de la aplicación. También reconoces que el uso inadecuado de este ajuste puede conllevar la cancelación de tu cuenta de Google.

Al hacer solicitudes de anuncios, los desarrolladores de aplicaciones pueden indicar si quieren que Google trate su contenido como dirigido a niños. Si lo haces, tomaremos las medidas necesarias para inhabilitar la publicidad basada en intereses y los anuncios de remarketing en dichas solicitudes de anuncios.

Este ajuste se puede usar con todas las versiones del SDK de Servicios de Google Play mediante RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

  • Llama a setTagForChildDirectedTreatment con el valor TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE para indicar que quieres que el contenido se trate como dirigido a niños según lo estipulado en la ley COPPA.

  • Llama a setTagForChildDirectedTreatment con el valor TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE para indicar que no quieres que el contenido se trate como dirigido a niños según lo estipulado en la ley COPPA.

  • Llama a setTagForChildDirectedTreatment con el valor TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED si prefieres no 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 según lo estipulado en la ley COPPA:

Java

    RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .setTagForChildDirectedTreatment(TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
            .build();
    

Kotlin

    var requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .setTagForChildDirectedTreatment(TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
            .build()
    

Puedes marcar tus solicitudes de anuncios para que se adecuen a los usuarios cuya edad sea inferior a la edad de consentimiento legal fijada en el Espacio Económico Europeo (EEE). Esta función se ofrece para facilitar el cumplimiento del Reglamento General de Protección de Datos (RGPD). Debes tener en cuenta que podrías tener otras obligaciones legales de conformidad con dicho documento, así que revisa las prácticas recomendadas en la Unión Europea y consúltalo con un asesor jurídico. Recuerda que las herramientas de Google están diseñadas para facilitar el cumplimiento y no eximen a ningún editor de sus obligaciones legales. Más información sobre cómo afecta el RGPD a los editores

Cuando utilices esta función, en la solicitud de anuncio se incluirá un parámetro TFUA (etiqueta para usuarios que no tengan la edad legal necesaria en Europa para dar su consentimiento) que inhabilita la publicidad personalizada, incluido el remarketing, en todas las solicitudes de anuncios, así como las solicitudes a proveedores de anuncios externos, como los píxeles de medición de anuncios y los servidores de anuncios externos.

Tal como ocurre con la configuración de contenido dirigido a niños, hay un método en RequestConfiguration.Builder que permite definir el parámetro TFUA: setTagForUnderAgeOfConsent con las siguientes opciones:

  • Llama a setTagForUnderAgeOfConsent con el valor TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE para indicar que quieres que las solicitudes de anuncios se traten como procedentes de contenido dirigido a usuarios del EEE que no tengan edad para dar su consentimiento legal.

  • Llama a setTagForUnderAgeOfConsent con el valor TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE para indicar que no quieres que las solicitudes de anuncios se traten como procedentes de contenido dirigido a usuarios del EEE que no tengan edad para dar su consentimiento legal.

  • Llama a setTagForUnderAgeOfConsent con el valor TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED para indicar que no vas a especificar si las solicitudes de anuncios se deben tratar como procedentes de contenido dirigido a usuarios del EEE que no tengan edad para dar su consentimiento legal.

En el siguiente ejemplo se muestra cómo debes indicar que quieres incluir el parámetro TFUA en las solicitudes de anuncios:

Java

    RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .setTagForUnderAgeOfConsent(TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
            .build();
    

Kotlin

    var requestConfiguration = MobileAds.getRequestConfiguration()
            .toBuilder()
            .setTagForUnderAgeOfConsent(TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
            .build()
    

No se debe asignar el valor true simultáneamente a las etiquetas que habilitan el contenido dirigido a niños y a las etiquetas setTagForUnderAgeOfConsent. Si lo haces, las que habilitan el contenido dirigido a niños tendrán prioridad.

Solicitud de anuncio

El objeto PublisherAdRequest recoge información sobre la segmentación para enviarla en la solicitud de anuncio.

Ubicación

Si un usuario ha otorgado permisos de ubicación a tu aplicación, Ad Manager envía automáticamente dichos datos al SDK, que los utiliza para mejorar la segmentación de los anuncios sin que tengas que modificar el código de la aplicación. Por supuesto, puedes habilitar o inhabilitar los datos de ubicación para mostrar anuncios.

La información sobre la ubicación que se rellena automáticamente no se reenvía a las redes de mediación y también se puede inhabilitar por completo. Por lo tanto, el SDK permite configurar la ubicación manualmente. Puedes especificar la segmentación geográfica en la solicitud de anuncio como se indica a continuación:

Java

    PublisherAdRequest request = new PublisherAdRequest.Builder()
            .setLocation(location)
            .build();
    

Kotlin

    val request = PublisherAdRequest.Builder()
            .setLocation(location)
            .build()
    

Para obtener la ubicación de los usuarios, debes utilizar un método adecuado.

Por respeto a la privacidad de los usuarios, Google te pide que especifiques la ubicación solo si tu aplicación ya utiliza esos datos.

Segmentación personalizada

Puedes enviar pares clave‑valor personalizados para segmentar campañas (líneas de pedido) de Google Ad Manager con PublisherAdRequest.Builder.addCustomTargeting:

Java

    // Example: Pass custom targeting "age=25".
    PublisherAdRequest newRequest = new PublisherAdRequest.Builder()
            .addCustomTargeting("age", "25")
            .build();
    

Kotlin

    // Example: Pass custom targeting "age=25".
    var newRequest = PublisherAdRequest.Builder()
            .addCustomTargeting("age", "25")
            .build()
    

Puedes enviar varios valores de una clave en forma de lista de cadenas. Hazlo, por ejemplo, si quieres orientar las campañas a usuarios que sean veinteañeros, en lugar de solo a quienes tengan 25 años.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
    

Consulta el ejemplo de segmentación personalizada de Ad Manager para ver cómo se implementa este tipo de segmentación en la aplicación API Demo de Android.

Exclusiones de categorías

Puedes añadir a una solicitud de anuncio una exclusión de categoría a nivel de espacio publicitario si utilizas el método addCategoryExclusion que proporciona PublisherAdRequest.Builder:

Java

    // Example: Exclude "automobile" and "boat" categories.
    PublisherAdRequest newRequest = new PublisherAdRequest.Builder()
            .addCategoryExclusion("automobile")
            .addCategoryExclusion("boat")
            .build();
    

Kotlin

    // Example: Exclude "automobile" and "boat" categories.
    var newRequest = PublisherAdRequest.Builder()
            .addCategoryExclusion("automobile")
            .addCategoryExclusion("boat")
            .build()
    

Consulta el ejemplo de exclusiones de categorías de Ad Manager para ver cómo se implementan estas exclusiones en la aplicación API Demo de Android.

Cargar un anuncio con segmentación

Cuando hayas definido la información de segmentación de la solicitud, llama a loadAd() en la vista de anuncio mediante tu instancia de PublisherAdRequest.

Java

    PublisherAdRequest request = new PublisherAdRequest.Builder()
            .setLocation(location)
            .build();
    adView.loadAd(request);
    

Kotlin

    val request = PublisherAdRequest.Builder()
            .setLocation(location)
            .build()
    adView.loadAd(request)
    

Identificadores proporcionados por el editor

Puedes definir un identificador proporcionado por el editor (PPID) para usarlo en todos los dispositivos a la hora de limitar la frecuencia, segmentar la publicidad por audiencia, rotar secuencialmente los anuncios y utilizar otros controles de publicación de anuncios basados en la audiencia.

A continuación, se muestra un ejemplo de cómo configurar el PPID:

Java

    PublisherAdRequest adRequest = new PublisherAdRequest.Builder()
            .setPublisherProvidedId("AB123456789")
            .build();
    

Kotlin

    var adRequest = PublisherAdRequest.Builder()
            .setPublisherProvidedId("AB123456789")
            .build()
    

Consulta el ejemplo de PPID de Ad Manager para ver cómo se implementan los PPID en la aplicación API Demo de Android.

URL de contenido

Si quieres proporcionar una URL de contenido para utilizarla en los anuncios segmentados por contenido y para mantener la seguridad de tu marca, puedes llamar a PublisherAdRequest.Builder.setContentUrl al crear un objeto PublisherAdRequest:

Java


    PublisherAdRequest requestWithContent = new PublisherAdRequest.Builder()
            .setContentUrl("https://www.example.com")
            .build();
    

Kotlin

    var requestWithContent = PublisherAdRequest.Builder()
            .setContentUrl("https://www.example.com")
            .build()
    

Seguridad de la marca

Las aplicaciones que muestran contenido dinámico dirigido a varias audiencias pueden proporcionar una lista breve de URLs mediante el método PublisherAdRequest.Builder.setNeighboringContentUrls al crear un objeto PublisherAdRequest:

Java

    ArrayList<String> urls = new ArrayList<String>();
    urls.add("https://www.mycontenturl1.com");
    urls.add("https://www.mycontenturl2.com");
    urls.add("https://www.mycontenturl3.com");
    urls.add("https://www.mycontenturl4.com");
    PublisherAdRequest requestWithContent = new PublisherAdRequest.Builder()
            .setNeighboringContentUrls(urls)
            .build();
    

Kotlin

    var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
    var requestWithContent = PublisherAdRequest.Builder()
            .setNeighboringContentUrls(urls)
            .build()
    

.setNeighboringContentUrls() se diferencia de .setContentUrl() en que solo se utiliza para proteger la seguridad de la marca.