ironSource in die Vermittlung einbinden

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

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.

Unity User Proguard-Datei

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

Version 2.6.1

Version 2.6.0

Version 2.5.0

Version 2.4.0

Version 2.3.1

Version 2.3.0

Version 2.2.7

Version 2.2.6

Version 2.2.5

Version 2.2.4

Version 2.2.3

Version 2.2.2

Version 2.2.1

Version 2.2.0

Version 2.1.5

Version 2.1.4

Version 2.1.3

Version 2.1.2

Version 2.1.1

Version 2.1.0

Version 2.0.3

Version 2.0.2

Version 2.0.1

Version 2.0.0

Version 1.10.0

Version 1.9.1

Version 1.9.0

Version 1.8.2

Version 1.8.1

Version 1.8.0

Version 1.7.0

Version 1.6.0

Version 1.5.0

Version 1.4.0

Version 1.3.2

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.