Commencer

Conformément aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez informer vos utilisateurs de l'Espace économique européen (EEE) ainsi que du Royaume-Uni et obtenir leur consentement pour utiliser des cookies ou tout autre stockage local, lorsque la législation l'impose, et pour utiliser des données à caractère personnel (comme les AdID) afin de diffuser des annonces. Ces règles reflètent les exigences de la directive vie privée et communications électroniques de l'UE, et celles du Règlement général sur la protection des données (RGPD).

Pour aider les éditeurs à satisfaire aux obligations qui leur sont imposées par ce règlement, Google propose le SDK User Platform Platform (UMP). Le SDK UMP a été mis à jour pour être compatible avec les dernières normes de l'IAB. Toutes ces configurations peuvent désormais être facilement gérées dans AdMob Confidentialité et messages.

Prérequis

• Suivez le guide de démarrage.
• Configurez vos messages dans l'onglet Confidentialité et messages de votre compteAdMob . Pour en savoir plus, consultez À propos de la confidentialité et des messages,
• Si vous travaillez sur les exigences liées au RGPD, consultez l'impact des exigences de l'IAB sur les messages de consentement pour l'UE.

Types de messages destinés aux utilisateurs

Consultez Types de messages des utilisateurs pour obtenir la liste complète des messages acceptés. Pour obtenir des instructions spécifiques sur l'implémentation de chaque type de message, consultez la barre de navigation de gauche.

Déterminer si un message doit être affiché

Vous devez demander la mise à jour des informations de consentement de l'utilisateur à chaque lancement de l'application, à l'aide de Update() avant de charger un formulaire. Cela peut déterminer si l'utilisateur doit donner son consentement s'il ne l'a pas déjà fait ou s'il a expiré.

Utilisez les informations stockées dans l'objet ConsentInformationlorsque vous présentez le formulaire.

Avertissement :Il est fortement déconseillé d'utiliser d'autres moyens pour vérifier l'état du consentement (vérifier le cache utilisé par votre application ou rechercher une chaîne de consentement dans le stockage, par exemple), car l'ensemble des partenaires de technologie publicitaire aurait pu changer depuis le dernier consentement de l'utilisateur.

Voici un exemple de vérification de l'état au démarrage de l'application:

using System.Collections.Generic;
using UnityEngine;
using GoogleMobileAds.Ump;
using GoogleMobileAds.Ump.Api;

public class UmpManager : MonoBehaviour
{
    void Start()
    {
        // Set tag for under age of consent.
        // Here false means users are not under age.
        ConsentRequestParameters request = new ConsentRequestParameters
        {
            TagForUnderAgeOfConsent = false,
        };

        // Check the current consent information status.
        ConsentInformation.Update(request, OnConsentInfoUpdated);
    }

    void OnConsentInfoUpdated(FormError error)
    {
        if (error != null)
        {
            // Handle the error.
            UnityEngine.Debug.LogError(error);
            return;
        }

        // If the error is null, the consent information state was updated.
        // You are now ready to check if a form is available.
    }
}

Charger un formulaire (si disponible)

Avant d'afficher un formulaire, vous devez d'abord déterminer si un formulaire est disponible. Cela peut être dû au fait que l'utilisateur a activé le suivi limité des annonces ou que vous les avez marquées comme n'ayant pas atteint l'âge minimal requis.

Pour vérifier la disponibilité d'un formulaire, utilisezthe IsConsentFormAvailable() method on the ConsentInformation instance que vous avez créé précédemment.

Ajoutez ensuite une méthode wrapper pour charger le formulaire:

void OnConsentInfoUpdated(FormError error)
{
    if (error != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(error);
        return;
    }

    // If the error is null, the consent information state was updated.
    // You are now ready to check if a form is available.
    if (ConsentInformation.IsConsentFormAvailable())
    {
        LoadConsentForm();
    }
}

void LoadConsentForm()
{
    // Loads a consent form.
}

Pour charger le formulaire, utilisez the static Load() method on the ConsentForm class.

private ConsentForm _consentForm;

void LoadConsentForm()
{
    // Loads a consent form.
    ConsentForm.Load(OnLoadConsentForm);
}

void OnLoadConsentForm(ConsentForm consentForm, FormError error)
{
    if (error != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(error);
        return;
    }

    // The consent form was loaded.
    // Save the consent form for future requests.
    _consentForm = consentForm;

    // You are now ready to show the form.
}

Présentez le formulaire si nécessaire.

Après avoir déterminé la disponibilité du formulaire et l'avoir chargé, présentez-le à l'aide de la méthodeShow() sur l'instanceConsentForm .

Utilisez l'objetConsentInformation plus tôt pour vérifier laconsent status et mettre à jour votre méthodeLoadForm() :

void LoadForm()
{
    // Loads a consent form.
    ConsentForm.Load(OnLoadConsentForm);
}

void OnLoadConsentForm(ConsentForm consentForm, FormError error)
{
    if (error != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(error);
        return;
    }

    // The consent form was loaded.
    // Save the consent form for future requests.
    _consentForm = consentForm;

    // You are now ready to show the form.
    if(ConsentInformation.ConsentStatus == ConsentStatus.Required)
    {
        _consentForm.Show(OnShowForm);
    }
}

void OnShowForm(FormError error)
{
    if (error != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(error);
        return;
    }

    // Handle dismissal by reloading form.
    LoadForm();
}

Si vous devez effectuer des actions après que l'utilisateur a fait un choix ou a ignoré le formulaire, placez cette logique dans le gestionnaire d'achèvement ou le rappel de votre formulaire.

Tests

Forcer une zone géographique

Le SDK UMP permet de tester le comportement de votre application comme si l'appareil était situé dans l'EEE ou au Royaume-Uni à l'aide de the DebugGeography field on ConsentDebugSettings.

Pour utiliser la fonctionnalité de débogage, vous devez fournir l'ID haché de votre appareil de test dans les paramètres de débogage de votre application. Si vous appelezUpdate() sans définir cette valeur, votre application consigne le hachage d'ID requis lors de l'exécution.

void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        // Geography appears as in EEA for debug devices.
        DebugGeography = DebugGeography.EEA,
        TestDeviceHashedIds = new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Set tag for under age of consent.
    // Here false means users are not under age.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        TagForUnderAgeOfConsent = false,
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

Avec DebugGeography enum, vous pouvez forcer la géographie à l'une des options suivantes:

Débogage géographique	Description
DISABLED	Zone géographique de débogage désactivée.
EEA	La zone géographique s'affiche comme dans l'EEE pour les appareils de débogage.
Not_EEA	La zone géographique n'apparaît pas dans l'EEE pour les appareils de débogage.

Notez que les paramètres de débogage ne fonctionnent que sur les appareils de test. Vous n'avez pas besoin d'ajouter des émulateurs à la liste d'ID d'appareils, car les tests sont déjà activés par défaut.

Réinitialiser l'état du consentement

Lors du test de votre application avec le SDK UMP, il peut être utile de réinitialiser l'état du SDK afin de simuler la première expérience d'un utilisateur. Pour ce faire, le SDK fournit la méthode Reset() .

ConsentInformation.Reset();

Vous devez également appeler Reset() si vous décidez de supprimer complètement le SDK UMP de votre projet.