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
  • Bereitstellung auf iOS-Geräten
    • iOS-Bereitstellungsziel 12.0 oder höher
  • Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde 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 unter 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 verwendet, um im nächsten Abschnitt Ihren AdMob-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 Dokumentation zu myTarget, um ein Testgerät in der myTarget-UI hinzuzufügen und zu konfigurieren.

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

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Android

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

iOS

Eine Anleitung dazu 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 zur DSGVO und Einstellungen zu Bestimmungen von US-Bundesstaaten, um Mail.ru in der AdMob-Benutzeroberfläche der Liste der Anzeigenpartner für die DSGVO und die Bestimmungen von US-Bundesstaaten hinzuzufügen.

Schritt 3: myTarget SDK und Adapter importieren

OpenUPM-CLI

Wenn Sie die 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 im Stammverzeichnis Ihres Projekts den folgenden Befehl 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.

Von 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.

Auflösung 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. Diese 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 alle Werbenetzwerke in Ihrer Vermittlungskette angeben, die personenbezogene Daten erheben, empfangen oder verwenden können, und Informationen zur Nutzung der einzelnen Werbenetzwerke zur Verfügung stellen. 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

Datenschutzgesetze von US-Bundesstaaten verpflichten Sie, Nutzern das Recht einzuräumen, 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. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google zu aktivieren. Google kann diese Einstellung jedoch nicht auf die einzelnen Werbenetzwerke in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Werbenetzwerke befolgen, um die Compliance 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. Wir empfehlen, diese Methode aufzurufen, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.

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 bei AdMob und aktivieren Sie den Testmodus in der myTarget-UI.

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 mit ResponseInfo in den folgenden Klassen den zugrunde liegenden Fehler aus der Anzeigenantwort 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 die 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 native Anzeigen im einheitlichen Format.
104 Die geladene native Anzeige von myTarget unterscheidet sich von der angeforderten nativen Anzeige.
105 In der geladenen nativen Anzeige von myTarget fehlen einige erforderliche Assets (z.B. ein Bild oder ein 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 Die erforderlichen Assets für native Anzeigen fehlen.

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

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 myTarget-Android-Adapterversion 5.2.5.0.
  • Unterstützt die myTarget iOS-Adapterversion 4.8.9.0.

Version 2.3.1

  • Unterstützt 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 myTarget Android SDK Version 5.1.0.
  • Unterstützt die myTarget iOS SDK-Version 4.7.9.
  • Folgende 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().

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 myTarget Android SDK Version 5.0.0.
  • Unterstützt die myTarget iOS SDK-Version 4.7.7.

Version 1.1.0

  • Unterstützt 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 myTarget iOS SDK Version 4.6.24.