myTarget in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von myTarget mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie myTarget der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das myTarget SDK und den Adapter in eine Unity-App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Interstitial mit Prämie

Voraussetzungen

  • Unity 4 oder höher
  • Neueste Version des Google Mobile Ads SDK
  • Bereitstellung auf Android-Geräten
    • Android API-Level 21 oder höher
  • Für die Bereitstellung auf iOS-Geräten:
    • iOS-Bereitstellungsziel 12.0 oder höher
  • Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert ist. Weitere Informationen finden Sie unter Erste Schritte.
  • Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der myTarget-Benutzeroberfläche einrichten

Melden Sie sich zuerst in Ihrem myTarget-Konto an oder registrieren Sie sich. Klicken Sie in der Kopfzeile auf APPS, um die Seite „Apps“ aufzurufen. Klicken Sie auf APP HINZUFÜGEN, um Ihre App hinzuzufügen.

Wenn Ihre App sowohl die Android- als auch die iOS-Plattform unterstützt, müssen Sie beide Plattformen separat einrichten.

Android

Geben Sie als Nächstes die Google Play-URL für Ihre App an.

iOS

Geben Sie als Nächstes die iTunes-URL** für Ihre App an.

Wenn Sie eine App hinzufügen, müssen Sie in myTarget einen Anzeigenblock erstellen, bevor Sie den Vorgang abschließen können.

.

Wählen Sie aus den verfügbaren Anzeigenformaten BANNER aus und klicken Sie dann auf die Schaltfläche ANZEIGENBLOCK HINZUFÜGEN.

Interstitial

Wählen Sie aus den verfügbaren Anzeigenformaten INTERSTITIAL aus und klicken Sie dann auf die Schaltfläche ANZEIGENBLOCK HINZUFÜGEN.

Verfügbar

Wählen Sie aus den verfügbaren Anzeigenformaten VIDEO MIT PRÄMIE aus und klicken Sie dann auf die Schaltfläche ANZEIGENBLOCK HINZUFÜGEN.

Nativ

Wählen Sie aus den verfügbaren Anzeigenformaten NATIVE aus und klicken Sie dann auf ANZEIGENBLOCK HINZUFÜGEN.

Notieren Sie sich auf der Detailseite des Anzeigenblocks die Anzeigenflächen-ID. Sie finden sie in den Anzeigenblockeinstellungen unter slot_id. Diese Steckplatz-ID wird im nächsten Abschnitt verwendet, um den Ad Manager-Anzeigenblock einzurichten.

Neben der slot_id benötigen Sie auch Ihr dauerhaftes myTarget-Zugriffstoken, um die AdMob-Anzeigenblock-ID einzurichten. Rufen Sie den Tab Profil auf und wählen Sie Zugriffstokens aus. Klicken Sie auf Token erstellen oder Token anzeigen, um Ihr dauerhaftes Zugriffstoken für myTarget aufzurufen.

Testmodus aktivieren

Folgen Sie der Anleitung in der myTarget-Dokumentation, um ein Testgerät in der myTarget-Benutzeroberfläche hinzuzufügen und zu konfigurieren.

Schritt 2: myTarget-Nachfrage in der Ad Manager -Benutzeroberfläche einrichten

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Android

Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.

iOS

Eine Anleitung finden Sie in Schritt 2 der Anleitung für iOS.

Mail.ru zur Liste der Werbepartner für die DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter Einstellungen für die DSGVO und Einstellungen für die Bestimmungen von US-Bundesstaaten, um Mail.ru in der Ad Manager-Benutzeroberfläche der Liste der Werbepartner für die DSGVO und die Bestimmungen von US-Bundesstaaten hinzuzufügen.

Schritt 3: myTarget SDK und Adapter importieren

OpenUPM-CLI

Wenn Sie OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads-myTarget-Vermittlungs-Plug-in für Unity in Ihrem Projekt installieren. Führen Sie dazu den folgenden Befehl aus dem Stammverzeichnis Ihres Projekts aus:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

Wählen Sie im Unity-Projekt-Editor Bearbeiten > Projekteinstellungen > Paketmanager aus, um die Unity-Paketmanagereinstellungen zu öffnen.

Fügen Sie auf dem Tab Registries mit Bereich OpenUPM als Registry mit Bereich mit den folgenden Details hinzu:

  • Name: OpenUPM
  • URL: https://package.openupm.com
  • Geltungsbereich(e): com.google

OpenUPM-Details

Gehen Sie dann zu Fenster > Paketmanager, um den Unity-Paketmanager zu öffnen. Wählen Sie dann im Drop-down-Menü Meine Registrierungen aus.

Unity-Registre

Wählen Sie das Paket Google Mobile Ads myTarget Mediation aus und klicken Sie auf Installieren.

Über OpenUPM installieren

Unity-Paket

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für myTarget über den Downloadlink im Changelog herunter und extrahieren Sie die GoogleMobileAdsMyTargetMediation.unitypackage aus der ZIP-Datei.

Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie nach der heruntergeladenen GoogleMobileAdsMyTargetMediation.unitypackage-Datei. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

Aus Unity importieren

Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die External Dependency Manager-Bibliothek führt die Abhängigkeitsauflösung von Grund auf neu durch und kopiert die deklarierten Abhängigkeiten in das Assets/Plugins/Android-Verzeichnis Ihrer Unity-Anwendung.

Problem erzwingen

Schritt 4: Datenschutzeinstellungen im myTarget SDK implementieren

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Geräte-IDs und personenbezogenen Daten offenlegen und ihre Einwilligung einholen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie die Einwilligung einholen, müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder verwenden kann. Außerdem müssen Sie Informationen zur Nutzung jedes Netzwerks bereitstellen. Google kann die Einwilligung des Nutzers derzeit nicht automatisch an diese Netzwerke weitergeben.

Das Google Mobile Ads-Vermittlungs-Plug-in für myTarget Version 2.1.0 enthält die Methoden SetUserConsent() und SetUserAgeRestricted(). Im folgenden Codebeispiel wird gezeigt, wie Informationen zur Nutzereinwilligung an das myTarget SDK übergeben werden. Wenn Sie diese Methode aufrufen, sollten Sie dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

Wenn bekannt ist, dass sich der Nutzer in einer Kategorie mit Altersbeschränkung befindet, kannst du auch die Methode SetUserAgeRestricted() aufrufen.

MyTarget.SetUserAgeRestricted(true);

Weitere Informationen finden Sie im myTarget-Leitfaden zu Datenschutz und DSGVO.

Datenschutzgesetze von US-Bundesstaaten

Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten sollen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Anleitungen der einzelnen Netzwerke befolgen, um die Einhaltung der Anforderungen sicherzustellen.

Das Google Mobile Ads-Vermittlungs-Plug-in für myTarget Version 3.13.3 enthält die Methode SetCCPAUserConsent(bool). Im folgenden Codebeispiel wird gezeigt, wie Sie Informationen zur Nutzereinwilligung an das myTarget SDK übergeben. Wenn Sie diese Methode aufrufen, sollten Sie dies vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK tun.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

Weitere Informationen erhalten Sie vom myTarget-Support.

Schritt 5: Erforderlichen Code hinzufügen

Android

Für die myTarget-Integration ist kein zusätzlicher Code erforderlich.

iOS

SKAdNetwork-Integration

Folgen Sie der myTarget-Dokumentation, um der Datei Info.plist Ihres Projekts die SKAdNetwork-IDs hinzuzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager und aktivieren Sie den Testmodus in der myTarget-Benutzeroberfläche.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von myTarget erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen myTarget (Abfolge).

Fehlercodes

Wenn der Adapter keine Anzeige von myTarget empfängt, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo in den folgenden Klassen prüfen:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Im Folgenden finden Sie die Codes und zugehörigen Meldungen, die vom myTarget-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Android

Fehlercode Grund
100 Das myTarget SDK hat einen Fehler zurückgegeben.
101 Die in der Ad Manager -Benutzeroberfläche konfigurierten myTarget-Serverparameter fehlen oder sind ungültig.
102 Die angeforderte Anzeigengröße entspricht nicht einer von myTarget unterstützten Bannergröße.
103 Die Anzeigenanfrage ist keine Anfrage für eine einheitliche native Anzeige.
104 Die geladene native Anzeige von myTarget unterscheidet sich von der angeforderten nativen Anzeige.
105 Der geladenen nativen Anzeige von myTarget fehlen einige erforderliche Assets (z.B. Bild oder Symbol).

iOS

Fehlercode Grund
100 Für das myTarget SDK ist noch keine Anzeige verfügbar.
101 Die in der Ad Manager -Benutzeroberfläche konfigurierten myTarget-Serverparameter fehlen oder sind ungültig.
102 Der myTarget-Adapter unterstützt das angeforderte Anzeigenformat nicht.
103 Es wurde versucht, eine myTarget-Anzeige zu schalten, die nicht geladen wurde.
104 Die angeforderte Anzeigengröße entspricht nicht einer von myTarget unterstützten Bannergröße.
105 Erforderliche Assets für native Anzeigen fehlen.

Änderungsprotokoll für das myTarget Unity-Vermittlungs-Plug-in

Version 3.20.0

Version 3.19.0

Version 3.18.2

Version 3.18.1

Version 3.18.0

Version 3.17.1

Version 3.17.0

Version 3.16.2

Version 3.16.1

Version 3.16.0

Version 3.15.0

Version 3.14.0

Version 3.13.2

Version 3.13.1

Version 3.13.0

Version 3.12.0

Version 3.11.4

Version 3.11.3

  • Die Methode IsConsent() der Klasse MyTarget wurde in GetUserConsent() umbenannt.
  • Der Klasse MyTarget wurden die folgenden Methoden hinzugefügt:
    • SetCCPAUserConsent(bool)
    • GetCCPAUserConsent()
  • Unterstützt die myTarget-Android-Adapterversion 5.15.3.0.
  • Unterstützt die myTarget iOS-Adapterversion 5.15.2.0.
  • Erstellt und getestet mit der Version 7.2.0 des Google Mobile Ads Unity-Plug-ins.

Version 3.11.2

Version 3.11.1

Version 3.11.0

Version 3.10.2

Version 3.10.1

Version 3.10.0

Version 3.9.0

Version 3.8.2

Version 3.8.1

Version 3.8.0

Version 3.7.0

Version 3.6.1

Version 3.6.0

Version 3.5.2

Version 3.5.1

Version 3.5.0

Version 3.4.0

Version 3.3.0

Version 3.2.0

Version 3.1.0

Version 3.0.0

  • Das Plug-in wurde aktualisiert, um die neue Rewarded API in der offenen Betaphase zu unterstützen.
  • Unterstützt die myTarget-Android-Adapterversion 5.3.9.0.
  • Unterstützt die myTarget iOS-Adapterversion 5.0.4.0.

Version 2.3.2

  • Unterstützt die myTarget-Android-Adapterversion 5.2.5.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.8.9.0.

Version 2.3.1

  • Unterstützt die myTarget-Android-Adapterversion 5.2.5.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.8.5.0.

Version 2.3.0

  • Unterstützt die myTarget-Android-Adapterversion 5.2.2.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.8.0.0.

Version 2.2.0

  • Unterstützt die myTarget-Android-Adapterversion 5.1.4.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.8.0.0.

Version 2.1.2

  • Unterstützt die myTarget-Android-Adapterversion 5.1.3.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.7.11.0.

Version 2.1.1

  • Unterstützt die myTarget-Android-Adapterversion 5.1.1.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.7.10.0.

Version 2.1.0

  • Unterstützt die myTarget Android SDK-Version 5.1.0.
  • Unterstützt die myTarget iOS SDK-Version 4.7.9.
  • Die folgenden Methoden wurden hinzugefügt:
    • MyTarget.SetUserConsent()-Methode, um den Einwilligungsstatus des Nutzers an das MyTarget SDK weiterzuleiten.
    • MyTarget.SetUserAgeRestricted-Methode, mit der ein Flag gesetzt wird, um anzugeben, ob der Nutzer zu einer Kategorie mit Altersbeschränkung gehört (d.h. unter 16 Jahre alt ist).
    • MyTarget.IsUserConsent()-Methode, um den aktuellen Einwilligungsstatus des Nutzers abzurufen.
    • MyTarget.IsUserAgeRestricted()-Methode, um das Flag abzurufen, das angibt, dass der Nutzer einer altersbeschränkten Kategorie angehört (d.h. unter 16 Jahren alt ist).

Version 2.0.1

  • Unterstützt die myTarget Android SDK-Version 5.0.2.
  • Unterstützt die myTarget iOS SDK-Version 4.7.8.

Version 2.0.0

  • Unterstützt die myTarget Android SDK-Version 5.0.0.
  • Unterstützt die myTarget iOS SDK-Version 4.7.7.

Version 1.1.0

  • Unterstützt die myTarget Android SDK-Version 4.7.2.
  • Unterstützt die myTarget iOS SDK-Version 4.7.6.

Version 1.0.0

  • Erster Release!
  • Unterstützt die myTarget Android SDK-Version 4.6.27.
  • Unterstützt die myTarget iOS SDK-Version 4.6.24.