Commencer

Conformément aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez divulguer certaines informations à vos utilisateurs situés dans l'Espace économique européen (EEE) et au Royaume-Uni. Vous devez également obtenir leur consentement pour utiliser des cookies ou tout autre type de stockage local, lorsque la législation l'impose, et pour utiliser des données à caractère personnel (comme AdID) pour 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).

Afin d'aider les éditeurs à satisfaire aux obligations qui leur sont imposées par ce règlement, Google propose le SDK User Messaging 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 la section AdMob Confidentialité et messages.

Conditions préalables

• 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 vous intéressez aux exigences liées au RGPD, consultez Impact des exigences de l'IAB sur les messages demandant le consentement des utilisateurs de l'UE.

Types de messages destinés aux utilisateurs

Consultez la section Types de messages des utilisateurs pour obtenir la liste complète des messages acceptés. Pour obtenir des instructions spécifiques sur la mise en œuvre 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 d'application, à l'aide de Update() , avant de charger un formulaire. Cela peut déterminer si votre utilisateur doit donner son autorisation 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, si nécessaire.

Avertissement : Il est fortement déconseillé d'utiliser d'autres méthodes pour vérifier l'état de consentement (par exemple, vérifier le cache utilisé par votre application ou rechercher une chaîne de consentement dans le stockage), car l'ensemble de partenaires publicitaires technologiques peut avoir changé 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. Les formulaires non disponibles peuvent être dus à l'activation du suivi limité des annonces par l'utilisateur ou à un tag indiquant qu'il n'a 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ésenter le formulaire si nécessaire

Une fois que vous avez déterminé la disponibilité du formulaire et l'avez chargé, utilisez la méthodeShow() sur l'instanceConsentForm pour présenter le formulaire.

Utilisez l'objetConsentInformation précédent pour vérifierconsent 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 son choix ou a ignoré le formulaire, placez cette logique dans le gestionnaire d'achèvement ou de 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 avez la possibilité de forcer la géographie à l'une des options suivantes:

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

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

Réinitialiser l'état du consentement

Lorsque vous testez votre application avec le SDK UMP, il peut être utile de réinitialiser l'état du SDK afin de simuler la première installation 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.