In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus myTarget mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch Vermittlungsabfolgen berücksichtigt. Sie erfahren, wie Sie myTarget zur 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
- Neuestes Google Mobile Ads SDK
- So stellen Sie sie unter Android bereit:
- Android API-Level 21 oder höher
- So stellen Sie sie unter iOS bereit:
- iOS-Bereitstellungsziel von 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.
- Schließen Sie die Vermittlung ab. Startleitfaden
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.
Banner
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 in 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.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Mail.ru
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 über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsMyTargetMediation.unitypackage
aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) und suchen Sie die heruntergeladene Datei GoogleMobileAdsMyTargetMediation.unitypackage
. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie dann Assets > Play-Dienste-Resolver > Android-Resolver > Erzwingung erzwingen. 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-App.
Schritt 4: Datenschutzeinstellungen im myTarget SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie dafür sorgen, dass Nutzer im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten erhalten und deren Einwilligungen eingeholt werden. 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 ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.
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 aufzurufen, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
Wenn der Nutzer bekanntermaßen zu einer 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 müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. 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 identifizieren, 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)
. Der folgende Beispielcode zeigt, wie Informationen zur Nutzereinwilligung an das myTarget SDK übergeben werden. 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 Dokumentation zu myTarget, um die SKAdNetwork-IDs zur Datei Info.plist
Ihres Projekts hinzuzufü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 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
Hier sind die Codes und zugehörigen Meldungen, die vom myTarget-Adapter ausgegeben werden, wenn das Laden einer Anzeige fehlschlägt:
Android
Fehlercode | Grund |
---|---|
100 | myTarget SDK hat einen Fehler zurückgegeben. |
101 | Die in der AdMob Benutzeroberfläche konfigurierten myTarget-Server-Parameter 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 Anfrage für native Anzeigen. |
104 | Die von myTarget geladene native Anzeige 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 AdMob Benutzeroberfläche konfigurierten myTarget-Server-Parameter fehlen oder sind ungültig. |
102 | Der myTarget-Adapter unterstützt das angeforderte Anzeigenformat nicht. |
103 | Es wurde versucht, eine myTarget-Anzeige einzublenden, die nicht geladen wird. |
104 | Die angeforderte Anzeigengröße stimmt nicht mit einer von myTarget unterstützten Bannergröße überein. |
105 | Die erforderlichen Assets für native Anzeigen fehlen. |
Änderungsprotokoll für myTarget Unity-Vermittlungs-Plug-in
Version 3.17.0
- Unterstützt die Android-Adapterversion 5.21.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.4.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.16.2
- Unterstützt die Android-Adapterversion 5.20.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.2.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.16.1
- Unterstützt die Android-Adapterversion 5.20.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.1.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.0.0 erstellt und getestet.
Version 3.16.0
- Unterstützt die Android-Adapterversion 5.20.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.0.1.
- Mit dem Google Mobile Ads Unity Plugin Version 9.0.0 erstellt und getestet.
Version 3.15.0
- Unterstützt die Android-Adapterversion 5.20.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.20.1.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.7.0 erstellt und getestet.
Version 3.14.0
- Unterstützt die Android-Adapterversion 5.18.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.19.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.5.0 erstellt und getestet.
Version 3.13.2
- Unterstützt die Android-Adapterversion 5.16.5.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.17.5.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.3.0 erstellt und getestet.
Version 3.13.1
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/MyTarget/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.MyTarget
überarbeitet. - Unterstützt die Android-Adapterversion 5.16.4.1 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.17.4.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.1.0 erstellt und getestet.
Version 3.13.0
- Unterstützt die Android-Adapterversion 5.16.4.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.17.4.0.
- Mit dem Google Mobile Ads Unity Plugin Version 8.0.0 erstellt und getestet.
Version 3.12.0
- Unterstützt die Android-Adapterversion 5.15.5.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.16.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.3.0 erstellt und getestet.
Version 3.11.4
- Unterstützt die Android-Adapterversion 5.15.4.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.15.2.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.2.0 erstellt und getestet.
Version 3.11.3
- Die Methode
IsConsent()
wurde von der KlasseMyTarget
inGetUserConsent()
umbenannt. - Der Klasse
MyTarget
wurden die folgenden Methoden hinzugefügt:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- Unterstützt die Android-Adapterversion 5.15.3.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.15.2.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.2.0 erstellt und getestet.
Version 3.11.2
- Unterstützt die Android-Adapterversion 5.15.2.1 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.15.2.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.0.2.
Version 3.11.1
- Unterstützt die Android-Adapterversion 5.15.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.15.1.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.11.0
- Unterstützt die Android-Adapterversion 5.15.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.15.0.1.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.10.2
- Unterstützt die Android-Adapterversion 5.14.4.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.14.4.0.
Version 3.10.1
- Unterstützt die Android-Adapterversion 5.14.3.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.14.2.0.
Version 3.10.0
- Unterstützt die Android-Adapterversion 5.14.2.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.14.1.0.
Version 3.9.0
- Unterstützt die Android-Adapterversion 5.13.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.11.2.0.
Version 3.8.2
- Unterstützt die Android-Adapterversion 5.11.7.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.9.10.0.
Version 3.8.1
- Unterstützt die Android-Adapterversion 5.11.5.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.9.6.0.
Version 3.8.0
- Unterstützt die Android-Adapterversion 5.11.4.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.9.5.0.
Version 3.7.0
- Unterstützt die Android-Adapterversion 5.10.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.7.5.0.
Version 3.6.1
- Die Methode
MyTarget.IsUserConsent()
wurde inMyTarget.IsConsent()
umbenannt. - Unterstützt die Android-Adapterversion 5.9.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.7.2.0.
Version 3.6.0
- Unterstützt die Android-Adapterversion 5.9.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.7.0.0.
Version 3.5.2
- Unterstützt die Android-Adapterversion 5.8.3.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.6.3.0.
Version 3.5.1
- Unterstützt die Android-Adapterversion 5.8.2.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.6.1.0.
Version 3.5.0
- Unterstützt die Android-Adapterversion 5.8.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.6.0.0.
Version 3.4.0
- Unterstützt die Android-Adapterversion 5.8.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.5.2.0.
Version 3.3.0
- Unterstützt die Android-Adapterversion 5.7.0.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.5.1.0.
Version 3.2.0
- Unterstützt die Android-Adapterversion 5.6.3.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.4.9.0.
Version 3.1.0
- Unterstützt die Android-Adapterversion 5.4.6.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.3.3.0.
Version 3.0.0
- Das Plug-in wurde aktualisiert, um die neue Open-Beta Reward API zu unterstützen.
- Unterstützt myTarget-Android-Adapterversion 5.3.9.0.
- Unterstützt myTarget iOS Adapter Version 5.0.4.0.
Version 2.3.2
- Unterstützt myTarget-Android-Adapterversion 5.2.5.0.
- Unterstützt myTarget iOS Adapter Version 4.8.9.0.
Version 2.3.1
- Unterstützt myTarget-Android-Adapterversion 5.2.5.0.
- Unterstützt myTarget iOS Adapter Version 4.8.5.0.
Version 2.3.0
- Unterstützt myTarget-Android-Adapterversion 5.2.2.0.
- Unterstützt myTarget iOS Adapter Version 4.8.0.0.
Version 2.2.0
- Unterstützt myTarget-Android-Adapterversion 5.1.4.0.
- Unterstützt myTarget iOS Adapter Version 4.8.0.0.
Version 2.1.2
- Unterstützt myTarget-Android-Adapterversion 5.1.3.0.
- Unterstützt myTarget iOS Adapter Version 4.7.11.0.
Version 2.1.1
- Unterstützt myTarget-Android-Adapterversion 5.1.1.0.
- Unterstützt myTarget iOS Adapter Version 4.7.10.0.
Version 2.1.0
- Unterstützt myTarget Android SDK Version 5.1.0.
- Unterstützt Version 4.7.9 des myTarget iOS SDK.
- Die folgenden Methoden wurden hinzugefügt:
MyTarget.SetUserConsent()
, um den Einwilligungsstatus des Nutzers an das MyTarget SDK weiterzuleiten.MyTarget.SetUserAgeRestricted
-Methode, die ein Flag festlegt, das angibt, ob der Nutzer bekanntermaßen einer Altersbeschränkung (d.h. unter 16 Jahren) angehört.MyTarget.IsUserConsent()
-Methode, um den aktuellen Einwilligungsstatus des Nutzers abzurufen.MyTarget.IsUserAgeRestricted()
.
Version 2.0.1
- Unterstützt myTarget Android SDK Version 5.0.2.
- Unterstützt Version 4.7.8 des myTarget iOS SDK.
Version 2.0.0
- Unterstützt myTarget Android SDK Version 5.0.0.
- Unterstützt Version 4.7.7 des myTarget iOS SDK.
Version 1.1.0
- Unterstützt myTarget Android SDK Version 4.7.2.
- Unterstützt Version 4.7.6 des myTarget iOS SDK.
Version 1.0.0
- Erste Veröffentlichung!
- Unterstützt myTarget Android SDK Version 4.6.27.
- Unterstützt myTarget iOS SDK Version 4.6.24.