In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von ironSource Ads mithilfe der AdMob-Vermittlungladen und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Hier erfahren Sie, wie Sie ironSource Ads der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen, die Anzeigenquellenoptimierung einrichten und das ironSource Ads SDK und den Adapter in Ihre Android-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für ironSource Ads bietet folgende Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge | |
| Formate | |
| Banner | |
| Interstitial | |
| Verfügbar | |
| Interstitial mit Prämie | 1 |
| Nativ | |
1 Dieses Format wird nur bei der Abfolgeintegration unterstützt.
Voraussetzungen
- Android API‑Level 24 oder höher
- [Für Gebote] Wenn Sie alle unterstützten Anzeigenformate in Geboten einbinden möchten, verwenden Sie den ironSource-Adapter 8.5.0.1 oder höher (die neueste Version wird empfohlen)
Schritt 1: Konfigurationen in der ironSource Ads-Benutzeroberfläche einrichten
Registrieren Sie sich und melden Sie sich an für Ihr ironSource Ads Konto.
Neue App hinzufügen
Wenn Sie eine neue App hinzufügen möchten, gehen Sie zu Ads > Apps und klicken Sie auf Add app (App hinzufügen).

Füllen Sie das Formular aus und klicken Sie auf Add app (App hinzufügen).

Notieren Sie sich den App Key (App-Schlüssel), wählen Sie die Anzeigenformate aus, die von Ihrer App unterstützt werden, und klicken Sie auf Continue (Weiter).

Instanz erstellen
Konfigurieren Sie als Nächstes eine Instanz für die hinzugefügte App.
Gehen Sie zu Ads > Setup > Instances (Anzeigen > Einrichtung > Instanzen). Wählen Sie die App aus und klicken Sie auf Create instance (Instanz erstellen).

Gebote
Füllen Sie das Formular aus und wählen Sie unter Pricing (Preisgestaltung) die Option Bidding (Gebote) aus. Klicken Sie auf Save and close (Speichern und schließen).

Notieren Sie sich die Instance ID (Instanz-ID).

Vermittlungsabfolge
Füllen Sie das Formular aus und klicken Sie auf Save and close (Speichern und schließen).

Notieren Sie sich die Instance ID (Instanz-ID).

Reporting API-Schlüssel finden
Gebote
Dieser Schritt ist für Gebotsintegrationen nicht erforderlich.
Vermittlungsabfolge
Klicken Sie auf der Seite My Account auf den Tab API und notieren Sie sich Ihren Secret Key und Ihr Refresh Token.

app-ads.txt-Datei aktualisieren
Authorized Sellers for Apps oder app-ads.txt ist eine IAB Tech Lab-Initiative, die dafür sorgt, dass Ihr
App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Verlust an Werbeeinnahmen zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren.
Wenn Sie das noch nicht getan haben,
richten Sie eine app-ads.txt-Datei für Ihre App ein.
Informationen zur Implementierung von app-ads.txt für ironSource finden Sie unter
ironSource authorized resellers.
Testmodus aktivieren
Folgen Sie der Anleitung im Leitfaden zu Integrationstests von ironSource Ads, um Testanzeigen von ironSource Ads zu aktivieren.
Schritt 2: ironSource Ads-Nachfrage in der AdMob-Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Sie müssen ironSource Ads der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.
Melden Sie sich zuerst in Ihrem AdMob-Konto an. Gehen Sie dann zum Tab Vermittlung. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen dieser Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit ironSource Ads als Anzeigenquelle hinzufügen fort.
Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Zielstandorte aus. Setzen Sie dann den Status der Vermittlungsgruppe auf Aktiviert und klicken Sie auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke angezeigt werden:

ironSource Ads als Anzeigenquelle hinzufügen
Gebote
Wählen Sie im Bereich Anzeigenquellen auf der Karte Gebote die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann ironSource Ads aus.
Klicken Sie auf So unterzeichnen Sie eine Partnervereinbarung und richten Sie eine Gebotsvereinbarung ein mit ironSource Ads.
Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.
Wenn Sie bereits eine Zuordnung für ironSource Ads haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes den App Key und Instance ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Vermittlungsabfolge
Wählen Sie im Bereich Anzeigenquellen auf der Karte Vermittlungsabfolge die Option Anzeigenquelle hinzufügen aus.
Wählen Sie ironSource Ads aus und aktivieren Sie die Option Optimieren. Geben Sie den Secret Key (Geheimer Schlüssel) und das Refresh Token (Aktualisierungstoken) ein, die Sie im vorherigen Abschnitt abgerufen haben, um die Anzeigenquellenoptimierung für ironSource Ads einzurichten. Geben Sie dann einen eCPM-Wert für ironSource Ads ein und klicken Sie auf Weiter.

Wenn Sie bereits eine Zuordnung für ironSource Ads haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.

Geben Sie als Nächstes den App Key (App-Schlüssel) und die Instance ID (Instanz-ID) ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

ironSource Mobile der Liste der Werbepartner für die DSGVO und die Verordnungen von US-Bundesstaaten hinzufügen
Folgen Sie der Anleitung unter Einstellungen für EU-Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten , um ironSource Mobile der Liste der Werbepartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.
Schritt 3: ironSource Ads SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
}
Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:ironsource:9.3.0.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:ironsource:9.3.0.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Manuelle Integration
Laden Sie die neueste Version des ironSource Ads Android SDK herunter und fügen Sie sie Ihrem Projekt hinzu.
Rufen Sie die ironSource Ads-Adapterartefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die
.aar-Datei des ironSource-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Datenschutzeinstellungen im ironSource Ads SDK implementieren
Einwilligung in der EU und DSGVO
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.
Ab der ironSource SDK-Version 7.7.0 liest ironSource automatisch die DSGVO Einwilligung, die von Consent Management-Plattformen festgelegt wurde, die die Spezifikation für zusätzliche Einwilligung von Google unterstützen, einschließlich des UMP SDK. Weitere Informationen finden Sie unter Unterstützung für Google UMP und CMPs, die die Spezifikation für zusätzliche Einwilligung von Google unterstützen.
Datenschutzgesetze von US-Bundesstaaten
Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut 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 Google-Anzeigenauslieferung aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbe netzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.
In der SDK-Version 6.14.0 hat ironSource Ads eine API hinzugefügt, um die CCPA-Bestimmungen zu unterstützen. Im folgenden Beispielcode wird gezeigt, wie Sie diese Einwilligungsinformationen an das ironSource Ads SDK weitergeben. Diese Optionen müssen festgelegt werden, bevor Sie initialisieren GMA Next-Gen SDK , damit sie ordnungsgemäß an das ironSource Ads SDK weitergeleitet werden.
Java
LevelPlay.setMetaData("do_not_sell", "true");
Kotlin
LevelPlay.setMetaData("do_not_sell", "true")
Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie in der Dokumentation von ironSource Ads unter Regulation Advanced Settings (Erweiterte Einstellungen für Verordnungen).
Schritt 5: Erforderlichen Code hinzufügen
Anzeige mit Aktivitätskontext laden
Übergeben Sie den Activity-Kontext beim Laden von Banner- und Interstitial-Anzeigen sowie Anzeigenformaten mit Prämie. Ohne Aktivitätskontext schlägt das Laden der Anzeige fehl.
Proguard-Regeln
Wenn Sie Ihre App komprimieren, verschleiern und optimieren , sind für ironSource Ads zusätzliche ProGuard-Regeln für Ihr Projekt erforderlich. Weitere Informationen finden Sie im Leitfaden zur Android SDK-Integration von ironSource Ads.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der ironSource Ads-Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen von ironSource Ads erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen ironSource Ads (Gebote) und ironSource Ads (Vermittlungsabfolge).
Fehlercodes
Wenn der Adapter keine Anzeige von ironSource Ads empfangen kann, können Sie den
zugrunde liegenden Fehler aus der Anzeigenantwort mit
ResponseInfo.getAdSourceResponses()
unter den folgenden Klassen prüfen:
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
Hier sind die Codes und die zugehörigen Meldungen, die vom ironSource Ads-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
| Fehlercode | Grund |
|---|---|
| 101 | Die in der AdMob-Benutzeroberfläche konfigurierten ironSource Ads-Serverparameter fehlen oder sind ungültig. |
| 102 | Für die Initialisierung des ironSource Ads SDK ist ein Aktivitätskontext erforderlich. |
| 103 | Pro ironSource Ads-Instanz-ID kann nur eine Anzeige geladen werden. |
| 105 | Die angeforderte Banneranzeigengröße wird von ironSource Ads nicht unterstützt. |
| 106 | Das ironSource Ads SDK wurde nicht initialisiert. |
| 501-1056 | Fehler im ironSource Ads SDK Weitere Informationen finden Sie in der Dokumentation. |