Jetzt starten

Gemäß der Richtlinie zur EU-Nutzereinwilligung von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR) und im Vereinigten Königreich bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speicherverfahren, sofern gesetzlich erforderlich, sowie für die Verwendung personenbezogener Daten (z. B. AdID) zur Auslieferung von Anzeigen einholen. Diese Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO).

Google bietet das User Messaging Platform SDK (UMP) an, um Publisher bei der Umsetzung dieser Richtlinie zu unterstützen. Das UMP SDK wurde aktualisiert, um die neuesten IAB-Standards zu unterstützen. Alle diese Konfigurationen können jetzt bequem in AdMob Datenschutz und Mitteilungen durchgeführt werden.

Voraussetzungen

• Arbeiten Sie den Startleitfaden durch.
• Konfigurieren Sie Ihre Mitteilungen auf dem Tab Datenschutz und Mitteilungen IhresAdMob -Kontos. Weitere Informationen finden Sie unterDatenschutz und Mitteilungen und
• Wenn Sie an DSGVO-bezogene Anforderungen arbeiten, lesen Sie Auswirkungen der IAB-Anforderungen auf Mitteilungen zur EU-Nutzereinwilligung.

Arten von Nutzermitteilungen

Siehe Arten von Nutzermitteilungen Eine vollständige Liste der unterstützten Nachrichten. Eine genaue Anleitung zur Implementierung der einzelnen Nachrichtentypen finden Sie in der linken Navigationsleiste.

Bestimmen, ob eine Nachricht angezeigt werden muss

Sie sollten bei jedem App-Start eine Aktualisierung der Einwilligungsinformationen des Nutzers anfordern, bevor Sie ein Formular laden. RequestConsentInfoUpdate() So können Sie feststellen, ob Ihre Nutzer eine Einwilligung geben müssen, falls sie das noch nicht getan haben oder wenn ihre Einwilligung abgelaufen ist.

Verwenden Sie die im ConsentInformation-Objekt gespeicherten Informationen, wenn Sie das Formular bei Bedarf präsentieren.

Warnung: Von anderen Möglichkeiten zur Prüfung des Einwilligungsstatus, z. B. der Überprüfung eines von Ihrer App genutzten Caches oder der Suche nach einem Einwilligungsstring im Speicher, wird dringend abgeraten, da sich die Anzeigentechnologie-Partner seit der letzten Einwilligung des Nutzers möglicherweise geändert haben.

Hier ein Beispiel dafür, wie Sie den Status beim App-Start prüfen können:

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.RequestConsentInfoUpdate(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.
    }
}

Formular laden, falls verfügbar

Bevor ein Formular angezeigt werden kann, müssen Sie zuerst prüfen, ob eines verfügbar ist. Nicht verfügbare Formulare können daran liegen, dass der Nutzer eingeschränktes Anzeigen-Tracking aktiviert hat oder Sie das Formular als minderjährig gekennzeichnet haben.

Die Verfügbarkeit eines Formulars können Sie mit dem zuvor erstelltenthe IsConsentFormAvailable() method on the ConsentInformation instance prüfen.

Fügen Sie dann eine Wrapper-Methode hinzu, um das Formular zu laden:

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.
    // 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.
}

Verwenden Sie the static LoadConsentForm() method on the ConsentForm class, um das Formular zu laden.

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

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

    // The consent form was loaded.
    // You are now ready to show the form.
}

Präsentieren Sie das Formular bei Bedarf.

Nachdem Sie die Verfügbarkeit des Formulars ermittelt und geladen haben, verwenden Sie die MethodeShow() auf der InstanzConsentForm , um das Formular zu präsentieren.

Verwenden Sie dasConsentInformation -Objekt aus einem früheren Schritt, um dieconsent status zu prüfen und die MethodeLoadConsentForm() zu aktualisieren:

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

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

    // The consent form was loaded.
    // 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();
}

Wenn Sie Aktionen ausführen müssen, nachdem der Nutzer eine Auswahl getroffen oder das Formular geschlossen hat, platzieren Sie diese Logik in dem Vervollständigungs-Handler oder dem Callback für Ihr Formular.

Testen

Geografie erzwingen

Mit dem UMP SDK können Sie das Verhalten Ihrer App testen, als ob sich das Gerät im EWR oder im Vereinigten Königreich befinden würde, und zwar mithilfe von the DebugGeography field on ConsentDebugSettings.

Sie müssen die Hash-ID Ihres Testgeräts in den Debug-Einstellungen Ihrer App angeben, um die Fehlerbehebungsfunktion verwenden zu können. Wenn SieRequestConsentInfoUpdate() aufrufen, ohne diesen Wert festzulegen, protokolliert die Anwendung bei der Ausführung den erforderlichen ID-Hash.

void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        // Geography appears as in EEA for debug devices.
        DebugGeography = DebugGeography.DEBUG_GEOGRAPHY_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.RequestConsentInfoUpdate(request,
                                                OnConsentInfoUpdated);
}

Mit DebugGeography enumkönnen Sie die Geografie auf eine der folgenden Optionen erzwingen:

DebugGeografie	Beschreibung
DISABLED	Debug-Geografie deaktiviert.
EEA	Die Region entspricht bei Fehlerbehebungsgeräten dem EWR.
Not_EEA	Geografie wird für Debug-Geräte nicht im EWR angezeigt.

Die Einstellungen zur Fehlerbehebung funktionieren nur auf Testgeräten. Emulatoren müssen der Geräte-ID-Liste nicht hinzugefügt werden, da für sie standardmäßig bereits Tests aktiviert sind.

Einwilligungsstatus zurücksetzen

Wenn Sie Ihre App mit dem UMP SDK testen, kann es hilfreich sein, den SDK-Status zurückzusetzen, damit Sie die erste Installation eines Nutzers simulieren können. Das SDK bietet die Methode Reset() dafür.

ConsentInformation.Reset();

Sie sollten sich auch an Reset() wenden, wenn Sie das UMP SDK vollständig aus Ihrem Projekt entfernen möchten.