In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus ironSource mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch die abfolgebasierten Integrationen behandelt. Sie erfahren, wie Sie ironSource der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das ironSource SDK und den Adapter in eine Unity-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Ad Manager -Vermittlungsadapter für ironSource hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie |
Voraussetzungen
- Das aktuelle Google Mobile Ads SDK
- Unity 4 oder höher
- Für die Bereitstellung unter Android
- Android API-Level 21 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 ironSource-UI einrichten
Registrieren Sie sich und melden Sie sich in Ihrem ironSource-Konto an.
Klicken Sie auf die Schaltfläche Neue App, um Ihre Anwendung dem ironSource-Dashboard hinzuzufügen.
App-Details eingeben
Wählen Sie Live-App aus, geben Sie die URL Ihrer App ein und klicken Sie auf App-Info importieren.
Wenn Ihre App nicht verfügbar ist, wählen Sie App Not Live im App Store aus und geben Sie einen Temporären Namen für Ihre App an. Wählen Sie Ihre Plattform aus.
Füllen Sie den Rest des Formulars aus und klicken Sie auf App hinzufügen.
Notieren Sie sich den neuen APP KEY (APP-SCHLÜSSEL), der nach dem Hinzufügen der App angezeigt wird. Sie benötigen diesen Wert, um Ihre Anzeigenblock-IDAd Manager einzurichten. Wählen Sie die Anzeigenformate aus, die Ihre App unterstützt. Anschließend klicken Sie auf Weiter.
Android
iOS
Instanz erstellen
Als Nächstes konfigurieren Sie eine Netzwerkinstanz für die von Ihnen hinzugefügte App. ironSource unterstützt mehrere Netzwerkinstanzen für Anzeigen mit Prämie und Interstitial-Anzeigen.
Gehen Sie zu Anzeigen > Einrichtung > Instanzen. Wählen Sie die Anwendung aus und klicken Sie auf Instanz erstellen.
Geben Sie die erforderlichen Informationen ein und klicken Sie auf Speichern und schließen.
Sobald die Instanz erstellt wurde, wird die Instanz-ID im Feld Instanz-ID aufgeführt.
Neben dem APP-SCHLÜSSEL und der Instanz-ID benötigen Sie auch den geheimen Schlüssel von ironSource und das Aktualisierungstoken, um Ihre Anzeigenblock-IDAd Manager einzurichten.
Rufe in deinem ironSource-Publisher-Dashboard die Seite My Account (Mein Konto) auf und klicke dann auf den Tab API. Notieren Sie sich Ihren Geheimschlüssel und das Token aktualisieren.
Testmodus aktivieren
Folgen Sie der Anleitung im Integrationstest von ironSource, um ironSource-Testanzeigen zu aktivieren.
Schritt 2: ironSource-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.
ironSource Mobile 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 ironSource Mobile in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der Ad Manager Benutzeroberfläche aufzunehmen.
Schritt 3: ironSource SDK und Adapter importieren
Laden Sie die aktuelle Version des Vermittlungs-Plug-ins für Google Mobile Ads für ironSource über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsIronSourceMediation.unitypackage
aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsIronSourceMediation.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 ironSource SDK implementieren
EU-Einwilligung und DSGVO
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 Vermittlungs-Plug-in für Google Mobile Ads für ironSource
Version 1.0.0
enthält die Methode
IronSource.SetConsent()
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das ironSource SDK übergeben werden. Wir empfehlen, diese Methode vor der Anforderung von Anzeigen über das Google Mobile Ads SDK aufzurufen.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
Weitere Informationen finden Sie in der ironSource-Dokumentation zu den erweiterten Einstellungen der Regulation.
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 Google Mobile Ads Vermittlungs-Plug-in für ironSource
Version 2.2.4
enthält die Methode
IronSource.SetMetaData()
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das ironSource SDK übergeben werden. Diese Optionen müssen festgelegt werden, bevor Sie das Google Mobile Ads SDK initialisieren, damit sie korrekt an das ironSource SDK weitergeleitet werden.
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie in der ironSource-Dokumentation zu den erweiterten Einstellungen zur Regulierung für Android und iOS.
Schritt 5: Erforderlichen Code hinzufügen
Android
Proguard-Regeln
Wenn Sie Ihre Anwendung verkleinern, verschleiern und optimieren, benötigt IronSource zusätzliche ProGuard-Regeln für Ihr Projekt.
Wählen Sie beim Erstellen Ihres Projekts Android als Plattform aus. Öffnen Sie dann Player Settings (Playereinstellungen) und aktivieren Sie auf dem Tab Publishing Settings (Veröffentlichungseinstellungen) die Option User Proguard File (Nutzer Proguard-Datei). Unity sollte anzeigen, wo eine benutzerdefinierte proguard-user.txt
-Datei erstellt wurde, die Sie ändern können.
Weitere Informationen dazu, welche ProGuard-Regeln für Ihr Projekt erforderlich sind, finden Sie im Integrationsleitfaden für Android SDK von IronSource. Diese Regeln können Sie der Datei proguard-user.txt
hinzufügen.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von IronSource, 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 Ad Manager und aktivieren Sie den Testmodus in der ironSource Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonironSourceerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der ironSource (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von ironSource 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.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Im Folgenden finden Sie die Codes und Begleitmeldungen, die vom ironSource-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
101 | Die auf der Ad Manager Benutzeroberfläche konfigurierten ironSource-Serverparameter fehlen oder sind ungültig. |
102 | ironSource benötigt zum Initialisieren des SDK einen Activity-Kontext. |
103 | ironSource kann nur eine Anzeige pro ironSource-Instanz-ID laden. |
105 | Die angeforderte Größe für Banneranzeige wird von ironSource nicht unterstützt. |
106 | Das ironSource SDK wurde nicht initialisiert. |
501-1056 | ironSource SDK-Fehler. Weitere Informationen finden Sie in der Dokumentation. |
iOS
Fehlercode | Grund |
---|---|
101 | Die auf der Ad Manager Benutzeroberfläche konfigurierten ironSource-Serverparameter fehlen oder sind ungültig. |
102 | Der ironSource-Adapter unterstützt das angeforderte Anzeigenformat nicht. |
103 | Für diese Netzwerkkonfiguration wurde bereits eine ironSource-Anzeige geladen. |
104 | Die angeforderte Größe für Banneranzeige wird von ironSource nicht unterstützt. |
508-1037 | ironSource SDK-Fehler. Weitere Informationen finden Sie in der Dokumentation. |
Änderungsprotokoll des IronSource Unity Mediation-Plug-ins
Version 3.0.0
- Unterstützt die IronSource Android-Adapterversion 8.0.0.0.
- Unterstützt IronSource iOS-Adapterversion 8.0.0.0.0.
- Das Unity-Plug-in wurde mit Version 9.0.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.6.1
- Unterstützt die IronSource Android-Adapterversion 7.9.0.0.
- Unterstützt die IronSource iOS-Adapterversion 7.9.1.0.0.
- Das Unity-Plug-in wurde mit Version 9.0.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.6.0
- Unterstützt die IronSource Android-Adapterversion 7.9.0.0.
- Unterstützt IronSource iOS Adapterversion 7.9.0.0.0.
- Das Unity-Plug-in wurde mit Version 9.0.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.5.0
- Unterstützt die IronSource Android-Adapterversion 7.6.0.0.
- Unterstützt die IronSource iOS-Adapterversion 7.6.0.0.
- Das Unity-Plug-in wurde in Version 8.6.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.4.0
- Unterstützt die IronSource Android-Adapterversion 7.5.2.0.
- Unterstützt die IronSource iOS-Adapterversion 7.5.1.0.
- Das Unity-Plug-in wurde in Version 8.6.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.3.1
- Unterstützt die IronSource Android-Adapterversion 7.3.1.0.
- Unterstützt IronSource iOS-Adapterversion 7.3.1.0.0.
- Das Unity-Plug-in wurde mit Version 8.3.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.3.0
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/IronSource/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.IronSource
überarbeitet. - Unterstützt die IronSource Android-Adapterversion 7.3.0.1.0.
- Unterstützt IronSource iOS-Adapterversion 7.3.0.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 8.1.0, entwickelt und getestet.
Version 2.2.7
- Unterstützt IronSource Android-Adapterversion 7.2.7.0.
- Unterstützt die IronSource iOS-Adapterversion 7.2.7.0.1.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.4.1, entwickelt und getestet.
Version 2.2.6
- Unterstützt die IronSource Android-Adapterversion 7.2.6.0.
- Unterstützt IronSource iOS-Adapterversion 7.2.6.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.3.1, entwickelt und getestet.
Version 2.2.5
- Unterstützt die IronSource Android-Adapterversion 7.2.5.0.
- Unterstützt die IronSource iOS-Adapterversion 7.2.5.1.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.3.0, entwickelt und getestet.
Version 2.2.4
- Die Methode
IronSource.SetMetaData(string, string)
wurde hinzugefügt. - Unterstützt IronSource Android-Adapterversion 7.2.3.1.0
- Unterstützt Version 7.2.4.0 des IronSource-iOS-Adapters.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.2.0, entwickelt und getestet.
Version 2.2.3
- Unterstützt IronSource Android-Adapterversion 7.2.3.1.0
- Unterstützt die IronSource iOS-Adapterversion 7.2.3.1.0.
- Das Unity-Plug-in wurde mit Version 7.1.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.2.2
- Unterstützt IronSource Android-Adapterversion 7.2.2.1.0
- Unterstützt IronSource iOS-Adapterversion 7.2.2.1.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.2. entwickelt und getestet.
Version 2.2.1
- Unterstützt die IronSource Android-Adapterversion 7.2.1.1.0.
- Unterstützt Version 7.2.1.2.0 des IronSource-iOS-Adapters.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 2.2.0
- Unterstützt die IronSource Android-Adapterversion 7.2.1.0.
- Unterstützt Version 7.2.1.0 des IronSource-iOS-Adapters.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 2.1.5
- Unterstützt die IronSource Android-Adapterversion 7.1.14.0.
- Unterstützt die Version 7.1.14.0 des IronSource-iOS-Adapters.
Version 2.1.4
- Unterstützt die IronSource Android-Adapterversion 7.1.13.0.
- Unterstützt Version 7.1.13.0 des IronSource-iOS-Adapters.
Version 2.1.3
- Unterstützt die IronSource Android-Adapterversion 7.1.12.0.
- Unterstützt IronSource iOS-Adapterversion 7.1.12.0.
Version 2.1.2
- Unterstützt die IronSource Android-Adapterversion 7.1.11.1.0.
- Unterstützt die IronSource iOS-Adapterversion 7.1.11.1.0.
Version 2.1.1
- Unterstützt die IronSource Android-Adapterversion 7.1.8.0.
- Unterstützt die IronSource iOS-Adapterversion 7.1.8.0.
Version 2.1.0
- Unterstützt die IronSource Android-Adapterversion 7.1.6.0.
- Unterstützt IronSource iOS-Adapterversion 7.1.6.1.0.
Version 2.0.3
- Unterstützt die IronSource Android-Adapterversion 7.0.3.1.0.
- Unterstützt IronSource iOS-Adapterversion 7.0.3.0.
Version 2.0.2
- Unterstützt die IronSource Android-Adapterversion 7.0.2.0.
- Unterstützt IronSource iOS-Adapterversion 7.0.2.0.
Version 2.0.1
- Unterstützt die IronSource Android-Adapterversion 7.0.1.1.0.
- Unterstützt IronSource iOS-Adapterversion 7.0.1.0.
Version 2.0.0
- Unterstützt die IronSource Android-Adapterversion 7.0.0.0.
- Unterstützt IronSource iOS-Adapterversion 7.0.0.0.
Version 1.10.0
- Unterstützt die IronSource Android-Adapterversion 6.18.0.0.
- Unterstützt die IronSource iOS-Adapterversion 6.18.0.0.
Version 1.9.1
- Unterstützt die IronSource Android-Adapterversion 6.17.0.1.
- Unterstützt die IronSource iOS-Adapterversion 6.17.0.1.0.
Version 1.9.0
- Unterstützt die IronSource Android-Adapterversion 6.17.0.0.
- Unterstützt die IronSource iOS-Adapterversion 6.16.3.0.
Version 1.8.2
- Unterstützt die IronSource Android-Adapterversion 6.16.2.0.
- Unterstützt die IronSource iOS-Adapterversion 6.16.2.0.
Version 1.8.1
- Unterstützt die IronSource Android-Adapterversion 6.16.1.0.
- Unterstützt die IronSource iOS-Adapterversion 6.16.1.0.
Version 1.8.0
- Unterstützt die IronSource Android-Adapterversion 6.16.0.0.
- Unterstützt die IronSource iOS-Adapterversion 6.16.0.0.
Version 1.7.0
- Unterstützt die IronSource Android-Adapterversion 6.15.0.1.0.
- Unterstützt die IronSource iOS-Adapterversion 6.15.0.1.0.
Version 1.6.0
- Unterstützt die IronSource Android-Adapterversion 6.14.0.1.0.
- Unterstützt die IronSource iOS-Adapterversion 6.14.0.0.
Version 1.5.0
- Unterstützt die IronSource Android-Adapterversion 6.13.0.1.0.
- Unterstützt IronSource iOS Adapterversion 6.13.1.0.0.
Version 1.4.0
- Unterstützt die IronSource Android-Adapterversion 6.12.0.0.
- Unterstützt die IronSource iOS-Adapterversion 6.12.0.0.
Version 1.3.2
- Unterstützt die IronSource Android-Adapterversion 6.10.0.0.
- Unterstützt IronSource iOS-Adapterversion 6.8.7.0.
Version 1.3.1
- Unterstützt IronSource Android-Adapterversion 6.10.0.0
- Unterstützt IronSource iOS-Adapterversion 6.8.6.0
Version 1.3.0
- Unterstützt IronSource Android-Adapterversion 6.10.0.0
- Unterstützt IronSource iOS-Adapterversion 6.8.4.1.0
Version 1.2.0
- Unterstützt IronSource Android-Adapterversion 6.9.0.1
- Unterstützt IronSource iOS-Adapterversion 6.8.4.1.0
Version 1.1.2
- Unterstützt IronSource Android-Adapterversion 6.8.4.1
- Unterstützt IronSource iOS-Adapterversion 6.8.4.1
Version 1.1.1
- Unterstützt IronSource Android-Adapterversion 6.8.4.1
- Unterstützt IronSource iOS-Adapterversion 6.8.3.0
Version 1.1.0
- Das Plug-in wurde aktualisiert, um die neue offene Beta Reward API zu unterstützen.
- Unterstützt IronSource Android-Adapterversion 6.8.1.2
- Unterstützt IronSource iOS-Adapterversion 6.8.0.1
Version 1.0.4
- Unterstützt IronSource Android-Adapterversion 6.7.11.0
- Unterstützt IronSource iOS-Adapterversion 6.7.11.0
Version 1.0.3
- Unterstützt IronSource Android-Adapterversion 6.7.10.0
- Unterstützt IronSource iOS-Adapterversion 6.7.10.0
Version 1.0.2
- Unterstützt IronSource Android-Adapterversion 6.7.9.1.1
- Unterstützt IronSource iOS-Adapterversion 6.7.10.0
- Ein Konflikt mit dem Chartboost Unity-Vermittlungs-Plug-in wurde behoben.
Version 1.0.1
- Unterstützt IronSource Android-Adapterversion 6.7.9.0.
- Unterstützt IronSource iOS-Adapterversion 6.7.9.2.0.
Version 1.0.0
- Erste Version!
- Unterstützt IronSource Android-Adapterversion 6.7.9.0.
- Unterstützt IronSource iOS-Adapterversion 6.7.9.1.0.