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 von 12.0 oder höher
- Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert ist. Weitere Informationen finden Sie unter Weitere Informationen
- Vermittlung 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. Navigieren Sie zur Seite „Apps“, indem Sie auf APPS Header. Klicken Sie auf APP HINZUFÜGEN, um Ihre App hinzuzufügen.
Wenn deine App sowohl die Android- als auch die iOS-Plattform unterstützt, musst du eines davon separat.
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 für myTarget einen Anzeigenblock erstellen, bevor Sie um den Prozess abzuschließen.
.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 MIT PRÄMIE aus und klicken Sie dann auf die Schaltfläche ANZEIGENBLOCK HINZUFÜGEN.
Nativ
Wählen Sie unter den verfügbaren Anzeigenformaten NATIVE aus und klicken Sie dann auf ANZEIGENBLOCK HINZUFÜGEN.
Notieren Sie sich auf der Detailseite Ihres Anzeigenblocks die ID der Anzeigenfläche. Diese finden Sie. in den Anzeigenblockeinstellungen als slot_id. Diese Slot-ID wird verwendet, um AdMob-Anzeigenblock einrichten.
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 dazu der Anleitung unter Dokumentation von myTarget 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 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
Schritt 3: myTarget SDK und Adapter importieren
OpenUPM-CLI
Wenn Sie OpenUPM-CLI haben installiert haben, können Sie das myTarget-Tool Vermittlungs-Plug-in für Unity mit dem folgenden Befehl verknüpfen aus dem Stammverzeichnis Ihres Projekts:
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
Gehen Sie dann zu Fenster > Paketmanager, um die Unity Package Manager und Wählen Sie im Drop-down-Menü My Registries (Meine Registrys) aus.
Wählen Sie das Paket Google Mobile Ads myTarget Mediation aus und klicken Sie auf Installieren.
Unity-Paket
Neueste Version des Google Mobile Ads Mediation-Plug-ins für herunterladen
myTarget über den Download-Link in
die
Änderungsprotokoll
und extrahieren Sie die
GoogleMobileAdsMyTargetMediation.unitypackage
aus der ZIP-Datei
-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie nach der heruntergeladenen GoogleMobileAdsMyTargetMediation.unitypackage
-Datei. Wählen Sie alle Dateien aus und klicken Sie auf
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.
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 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 der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. 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 derzeit nicht automatisch an solche Werbenetzwerke übergeben wird.
Das Google Mobile Ads-Vermittlungs-Plug-in für myTarget Version 2.1.0 enthält die
SetUserConsent()
- und SetUserAgeRestricted()
-Methoden. 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);
myTarget aufrufen Leitfaden Datenschutz und DSGVO .
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert der vorliegenden Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über die deutlich sichtbare „Do Not Sell My Personal“- Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Bundesstaaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
Das Google Mobile Ads-Vermittlungs-Plug-in für myTarget Version 3.13.3 enthält die
SetCCPAUserConsent(bool)
-Methode. 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 Dokumentation von myTarget.
um die SKAdNetwork-IDs zur Info.plist
-Datei Ihres Projekts 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 ü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 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
Hier sind die Codes und zugehörigen Nachrichten, 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 stimmt nicht mit einer von myTarget unterstützten Bannergröße überein. |
103 | Die Anzeigenanfrage ist keine Anfrage für native Anzeigen im einheitlichen Format. |
104 | Die von myTarget geladene native Anzeige 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 einzublenden, die nicht geladen wird. |
104 | Die angeforderte Anzeigengröße stimmt nicht mit einer von myTarget unterstützten Bannergröße überein. |
105 | Erforderliche Assets für native Anzeigen fehlen. |
Änderungsprotokoll für myTarget Unity-Vermittlungs-Plug-in
Version 3.18.1
- Unterstützt die Android-Adapterversion 5.22.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.8.0.
- Erstellt und getestet mit der Version 9.2.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.18.0
DummyClient
wurde inPlaceholderClient
umbenannt.- Unterstützt die myTarget-Android-Adapterversion 5.22.1.0.
- Unterstützt die myTarget iOS-Adapterversion 5.21.6.0.
- Erstellt und getestet mit der Version 9.2.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.17.1
- Unterstützt die Android-Adapterversion 5.21.1.0 von myTarget.
- Unterstützt die myTarget iOS-Adapterversion 5.21.5.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 9.2.0.
Version 3.17.0
- Unterstützt die myTarget-Android-Adapterversion 5.21.0.0.
- 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 myTarget-Android-Adapterversion 5.20.1.0.
- Unterstützt die myTarget iOS-Adapterversion 5.21.2.0.
- Erstellt und getestet mit der Version 9.1.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.16.1
- Unterstützt die myTarget-Android-Adapterversion 5.20.1.0.
- Unterstützt die myTarget iOS-Adapterversion 5.21.1.0.
- Erstellt und getestet mit der Version 9.0.0 des Google Mobile Ads Unity-Plug-ins.
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.
- Erstellt und getestet mit der Version 9.0.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.15.0
- Unterstützt die myTarget-Android-Adapterversion 5.20.0.0.
- Unterstützt die myTarget iOS-Adapterversion 5.20.1.0.
- Erstellt und getestet mit der Version 8.7.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.14.0
- Unterstützt die myTarget-Android-Adapterversion 5.18.0.0.
- Unterstützt die myTarget iOS-Adapterversion 5.19.0.0.
- Erstellt und getestet mit der Version 8.5.0 des Google Mobile Ads Unity-Plug-ins.
Version 3.13.2
- Unterstützt die myTarget-Android-Adapterversion 5.16.5.0.
- Unterstützt die myTarget iOS-Adapterversion 5.17.5.0.
- Erstellt und getestet mit der Version 8.3.0 des Google Mobile Ads Unity-Plug-ins.
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.
- Erstellt und getestet mit der Version 8.1.0 des Google Mobile Ads Unity-Plug-ins.
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.
- Erstellt und getestet mit der Version 8.0.0 des Google Mobile Ads Unity-Plug-ins.
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.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.3.0.
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.
- Erstellt und getestet mit der Version 7.2.0 des Google Mobile Ads Unity-Plug-ins.
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 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
- 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 der Version 7.0.2 des Google Mobile Ads Unity-Plug-ins.
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 myTarget-Android-Adapterversion 5.15.0.0.
- 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 myTarget-Android-Adapterversion 5.14.4.0.
- Unterstützt die myTarget iOS-Adapterversion 5.14.4.0.
Version 3.10.1
- Unterstützt die myTarget-Android-Adapterversion 5.14.3.0.
- Unterstützt die myTarget iOS-Adapterversion 5.14.2.0.
Version 3.10.0
- Unterstützt die myTarget-Android-Adapterversion 5.14.2.0.
- Unterstützt die myTarget iOS-Adapterversion 5.14.1.0.
Version 3.9.0
- Unterstützt die myTarget-Android-Adapterversion 5.13.0.0.
- 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 myTarget-Android-Adapterversion 5.11.4.0.
- 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 myTarget-Android-Adapterversion 5.8.3.0.
- Unterstützt myTarget iOS-Adapterversion 5.6.3.0.
Version 3.5.1
- Unterstützt die myTarget-Android-Adapterversion 5.8.2.0.
- Unterstützt die myTarget iOS-Adapterversion 5.6.1.0.
Version 3.5.0
- Unterstützt die myTarget-Android-Adapterversion 5.8.1.0.
- Unterstützt die myTarget iOS-Adapterversion 5.6.0.0.
Version 3.4.0
- Unterstützt die myTarget-Android-Adapterversion 5.8.0.0.
- Unterstützt die myTarget iOS-Adapterversion 5.5.2.0.
Version 3.3.0
- Unterstützt die myTarget-Android-Adapterversion 5.7.0.0.
- Unterstützt die myTarget iOS-Adapterversion 5.5.1.0.
Version 3.2.0
- Unterstützt die myTarget-Android-Adapterversion 5.6.3.0.
- Unterstützt die myTarget iOS-Adapterversion 5.4.9.0.
Version 3.1.0
- Unterstützt die myTarget-Android-Adapterversion 5.4.6.0.
- Unterstützt die myTarget iOS-Adapterversion 5.3.3.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 myTarget iOS Adapter Version 5.0.4.0.
Version 2.3.2
- Unterstützt die 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 die 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 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 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, 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 myTarget Android SDK Version 5.0.2.
- Unterstützt Version 4.7.8 des myTarget iOS SDK.
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 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 die myTarget Android SDK-Version 4.6.27.
- Unterstützt myTarget iOS SDK Version 4.6.24.