myTarget in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus myTarget mithilfe der Vermittlung zu laden und einzublenden. Dies umfasst auch abfolgebasierte Integrationen. Sie erfahren, wie Sie myTarget der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das myTarget SDK und den Adapter in eine Unity-App einbinden.

Unterstützte Integrationen und Anzeigenformate

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

Voraussetzungen

  • Unity 4 oder höher
  • Das aktuelle Google Mobile Ads SDK
  • Für die Bereitstellung unter Android
    • Android API-Level 19 oder höher
  • Für die Bereitstellung unter iOS
    • 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.
  • Arbeiten Sie den Startleitfaden zur Vermittlung ab.

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

Registrieren Sie sich zuerst oder melden Sie sich in Ihrem myTarget-Konto an. Rufen Sie die Seite „Apps“ auf, indem Sie in der Kopfzeile auf APPS klicken. Fügen Sie Ihre App hinzu, indem Sie auf APP HINZUFÜGEN klicken.

Wenn deine App sowohl die Android- als auch die iOS-Plattform unterstützt, musst du jede davon 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 PRÄMIEN 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 als slot_id. Diese Anzeigenflächen-ID wird im nächsten Abschnitt zur Einrichtung des Anzeigenblocks AdMob verwendet.

Zusätzlich zur slot_id benötigen Sie das dauerhafte Zugriffstoken von myTarget, um Ihre Anzeigenblock-ID in AdMob einzurichten. Gehen Sie zum Tab Profile (Profil) und wählen Sie Access Tokens (Zugriffstokens) aus. Klicken Sie auf Token erstellen oder Token anzeigen, um das Permanent Access Token von 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 auf der AdMob 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 gemäß DSGVO und Bestimmungen von US-Bundesstaaten hinzufügen

Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Mail.ru in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.

Schritt 3: myTarget SDK und Adapter importieren

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

Wählen Sie im Unity-Projekteditor Assets > Paket importieren > Benutzerdefiniertes Paket aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsMyTargetMediation.unitypackage. Prüfen Sie, ob alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

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

Schritt 4: Datenschutzeinstellungen im myTarget SDK implementieren

Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie dafür sorgen, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt und deren Einwilligung von diesen eingeholt wird. 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 nutzen kann, und Informationen zur Nutzung der einzelnen Werbenetzwerke angeben. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke weiterzugeben.

Das Google Mobile Ads-Vermittlungs-Plug-in für myTarget Version 2.1.0 enthält die Methoden SetUserConsent() und SetUserAgeRestricted(). Der folgende Beispielcode zeigt, wie Informationen zur Nutzereinwilligung an das myTarget SDK übergeben werden. Wir empfehlen, diese Methode vor der Anforderung von Anzeigen über das Google Mobile Ads SDK aufzurufen.

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

MyTarget.SetUserConsent(true);

Wenn der Nutzer bekanntermaßen zu einer Kategorie mit Altersbeschränkung gehört, kannst du auch die Methode SetUserAgeRestricted() aufrufen.

MyTarget.SetUserAgeRestricted(true);

Weitere Informationen finden Sie im Leitfaden Datenschutz und DSGVO von myTarget.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten schreiben Nutzern das Recht, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Begriffe). Dazu muss auf der Startseite des „Verkäufers“ ein deutlich sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen 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 durch Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in der Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitungen der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.

Das Vermittlungs-Plug-in von Google Mobile Ads für Version 3.13.3 von myTarget enthält die Methode SetCCPAUserConsent(bool). Der folgende Beispielcode zeigt, wie Informationen zur Nutzereinwilligung an das myTarget SDK übergeben werden. Wenn Sie diese Methode aufrufen, sollten Sie dies tun, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.

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

MyTarget.SetCCPAUserConsent(true);

Weitere Informationen erhalten Sie beim 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 die SKAdNetwork-IDs in die Datei Info.plist Ihres Projekts einzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

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

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vonmyTargeterhalten, aktivieren Sie im Anzeigenprüftool mithilfe der myTarget (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.

Fehlercodes

Wenn der Adapter keine Anzeige von myTarget empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit 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 sind die Codes und Begleitmeldungen aufgeführt, die vom myTarget-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Android

Fehlercode Grund
100 myTarget SDK hat einen Fehler zurückgegeben.
101 Die auf der AdMob Benutzeroberfläche konfigurierten myTarget-Serverparameter fehlen oder sind ungültig.
102 Die angeforderte Anzeigengröße stimmt nicht mit einer von MyTarget unterstützten Bannergröße überein.
103 Die Anzeigenanfrage ist keine einheitliche native Anzeigenanfrage.
104 Die geladene native Anzeige aus myTarget unterscheidet sich von der angeforderten nativen Anzeige.
105 Bei der aus myTarget geladenen nativen Anzeige fehlen einige erforderliche Assets (z.B. ein Bild oder Symbol).

iOS

Fehlercode Grund
100 Für myTarget SDK ist noch keine Anzeige verfügbar.
101 Die auf der AdMob 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 auszuliefern, die nicht geladen ist.
104 Die angeforderte Anzeigengröße stimmt nicht mit einer von MyTarget unterstützten Bannergröße überein.
105 Es fehlen erforderliche Assets für native Anzeigen.

Änderungsprotokoll des myTarget Unity Mediation-Plug-ins

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() wurde aus der Klasse MyTarget in GetUserConsent() umbenannt.
  • Der MyTarget-Klasse wurden die folgenden Methoden hinzugefügt:
    • SetCCPAUserConsent(bool)
    • GetCCPAUserConsent()
  • Unterstützt myTarget Android-Adapterversion 5.15.3.0.
  • Unterstützt myTarget iOS Adapterversion 5.15.2.0.
  • Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.2.0, entwickelt und getestet.

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 offene Beta Reward API zu unterstützen.
  • Unterstützt die Android-Adapterversion 5.3.9.0 von myTarget.
  • Unterstützt die Version 5.0.4.0 des myTarget-iOS-Adapters.

Version 2.3.2

  • Unterstützt die Android-Adapterversion 5.2.5.0 von myTarget.
  • Unterstützt die Version 4.8.9.0 des myTarget-iOS-Adapters.

Version 2.3.1

  • Unterstützt die Android-Adapterversion 5.2.5.0 von myTarget.
  • Unterstützt die Version 4.8.5.0 des myTarget-iOS-Adapters.

Version 2.3.0

  • Unterstützt die Android-Adapterversion 5.2.2.0 von myTarget.
  • Unterstützt die Version 4.8.0.0 des myTarget-iOS-Adapters.

Version 2.2.0

  • Unterstützt die Android-Adapterversion 5.1.4.0 von myTarget.
  • Unterstützt die Version 4.8.0.0 des myTarget-iOS-Adapters.

Version 2.1.2

  • Unterstützt die Android-Adapterversion 5.1.3.0 von myTarget.
  • Unterstützt die Version 4.7.11.0 des myTarget-iOS-Adapters.

Version 2.1.1

  • Unterstützt die Android-Adapterversion 5.1.1.0 von myTarget.
  • Unterstützt die Version 4.7.10.0 des myTarget-iOS-Adapters.

Version 2.1.0

  • Unterstützt myTarget Android SDK Version 5.1.0.
  • Unterstützt myTarget iOS SDK Version 4.7.9.
  • Folgende Methoden wurden hinzugefügt:
    • MyTarget.SetUserConsent(), um den Einwilligungsstatus des Nutzers an das MyTarget SDK weiterzuleiten.
    • MyTarget.SetUserAgeRestricted-Methode, bei der ein Flag gesetzt wird, um anzugeben, ob der Nutzer bekanntermaßen in einer Kategorie mit Altersbeschränkung ist, d.h. unter 16 Jahren.
    • MyTarget.IsUserConsent(), um den aktuellen Einwilligungsstatus des Nutzers abzurufen.
    • MyTarget.IsUserAgeRestricted()-Methode zum Abrufen des Flags, das angibt, dass der Nutzer bekanntermaßen in einer Kategorie mit Altersbeschränkung ist, d.h. unter 16 Jahren.

Version 2.0.1

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

Version 2.0.0

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

Version 1.1.0

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

Version 1.0.0

  • Erste Version!
  • Unterstützt myTarget Android SDK Version 4.6.27.
  • Unterstützt myTarget iOS SDK Version 4.6.24.