Moloco in Gebote einbinden

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen von Moloco mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie Moloco der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Moloco SDK und den Adapter in eine iOS-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für Moloco bietet die folgenden Funktionen:

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

• iOS-Bereitstellungsziel von 13.0 oder höher.

• Moloco-Adapter 3.9.1.0 oder höher

• Aktuelle Google Mobile Ads SDK-Version.

• Vermittlung einrichten

Schritt 1: Konfigurationen in der Moloco-Benutzeroberfläche einrichten

Melden Sie sich im Moloco Publisher Portal an.

Rufen Sie den Tab Übersicht > Apps auf und klicken Sie auf den Button App hinzufügen, um eine neue App zu erstellen.

Wählen Sie das Betriebssystem und die Datenschutzeinstellungen für Ihre App aus, füllen Sie den Rest des Formulars aus und klicken Sie dann auf Erstellen.

Nachdem Ihre App erstellt wurde, wählen Sie sie auf dem Tab Apps aus, um die Details aufzurufen. Notieren Sie sich den App-Schlüssel.

Rufen Sie den Tab Übersicht > Anzeigenblöcke auf, wählen Sie die App im Drop-down-Menü aus und klicken Sie dann auf Neuer Anzeigenblock.

Wählen Sie In-App-Gebote als Auktionsmethode aus und füllen Sie den Rest des Formulars aus. Klicken Sie anschließend auf Erstellen.

Rufen Sie auf dem Tab Anzeigenblöcke den neu erstellten Anzeigenblock auf, um die Details anzusehen. Notieren Sie sich die Anzeigenblock-ID.

Schritt 2: Moloco-Nachfrage in der Ad Manager-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Verwaltungskonto an.

Freigabe sicherer Signale aktivieren

Klicken Sie auf Admin > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Sicheres Signal in Gebotsanfragen freigeben

Rufen Sie Inventar > Sichere Signale auf. Suchen Sie unter Sichere Signale nach Moloco Anzeigen-SDK und aktivieren Sie App-Integration aktivieren.

Klicken Sie auf Speichern.

Freigabe sicherer Signale für SDK-Gebote zulassen

Klicken Sie auf Auslieferung > Einstellungen für Nachfragechannel. Aktivieren Sie auf dem Tab Standardeinstellungen die Option Freigabe sicherer Signale zulassen für SDK-Gebote.

Klicken Sie auf Speichern.

Moloco-Bidding konfigurieren

Klicken Sie auf Auslieferung > Bieter und dann auf SDK‑Gebote aufrufen.

Klicken Sie auf Neuer Bieter.

Wählen Sie Moloco Ads als Bieter aus.

Klicken Sie auf Weiter, um SDK-Gebote für diesen Bieter zu aktivieren.

Klicken Sie auf Fertig.

Anzeigenblockzuordnung konfigurieren

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Wählen Sie das Unternehmen für das Moloco Anzeigen-SDK aus.

Rufen Sie den Tab Zuordnung von Anzeigenblöcken auf und klicken Sie auf Neue Anzeigenblockzuordnung.

Wählen Sie Spezifischer Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format, Mobile App als Inventartyp und Ihre Mobile App aus. Geben Sie dann den App-Schlüssel und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben.

Klicken Sie abschließend auf Speichern.

Moloco Ads zur Liste der Werbepartner für EU-Verordnungen und Bestimmungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter Einstellungen gemäß EU-Verordnungen und Einstellungen zu Verordnungen von US-Bundesstaaten, um Moloco Ads in der Ad Manager-Benutzeroberfläche der Liste der Werbepartner gemäß EU-Verordnungen und Verordnungen von US-Bundesstaaten hinzuzufügen.

Schritt 3: Moloco SDK und Adapter importieren

Swift Package Manager verwenden

Bevor Sie fortfahren, müssen Sie die unterstützte Mindestversion des Adapters (4.1.0.0) haben.

So fügen Sie Ihrem Projekt eine Paketabhängigkeit hinzu:

1. Gehen Sie in Xcode zu File > Add Package Dependencies….

2. Suchen Sie im angezeigten Prompt nach der folgenden Paket-URL:

   https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git
   

3. Wählen Sie unter Abhängigkeitsregel die Option Zweig aus.

4. Geben Sie im Textfeld main ein.

Mit CocoaPods

• Fügen Sie in der Podfile-Datei Ihres Projekts folgende Zeile ein:

  pod 'GoogleMobileAdsMediationMoloco'
  

• Führen Sie über die Befehlszeile folgenden Befehl aus:

  pod install --repo-update

Schritt 4: Datenschutzeinstellungen im Moloco SDK implementieren

Einwilligung der Nutzer in der EU und DSGVO

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speicherverfahren einholen, sofern dies gesetzlich vorgeschrieben ist. Außerdem müssen Sie ihre Einwilligung zur Erhebung, Weitergabe und Verwendung personenbezogener Daten für personalisierte Anzeigen einholen. 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.

Ab der iOS-Adapterversion 3.5.0.0 des Moloco Anzeigen-SDK wird die Weitergabe von DSGVO-Einwilligungssignalen von Plattformen zur Einwilligungsverwaltung, die in das Transparency and Consent Framework (TCF) des IAB integriert sind, an das Moloco Anzeigen-SDK unterstützt. Weitere Informationen finden Sie unter TCF-Zustimmungsstring.

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 Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk 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 Netzwerke befolgen, um die Einhaltung der Bestimmungen zu gewährleisten.

Das Moloco SDK enthält das Flag isDoNotSell, um Einwilligungsinformationen an das Moloco SDK zu übergeben.

Im folgenden Beispielcode wird gezeigt, wie Sie Einwilligungsinformationen an das Moloco SDK übergeben. Wenn Sie diese Flags festlegen möchten, sollten Sie dies tun, bevor Sie Anzeigen über Google Mobile Ads SDK anfordern.

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

Weitere Informationen finden Sie in der Datenschutzdokumentation von Moloco.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vom Moloco Anzeigen-SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquelle (n) Moloco(Gebote).

Fehlercodes

Wenn der Adapter keine Anzeige von Moloco erhält, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

MolocoSDK.MolocoError
GADMediationAdapterMoloco

Hier sind die Codes und die zugehörigen Meldungen, die vom Moloco-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Moloco iOS Mediation Adapter – Versionshinweise

Version 4.11.1.0

• Kompatibilität mit Moloco SDK-Version 4.11.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.11.0
• Moloco SDK-Version 4.11.1

Version 4.11.0.0

• Kompatibilität mit Moloco SDK-Version 4.11.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.11.0
• Moloco SDK-Version 4.11.0

Version 4.10.0.0

• Kompatibilität mit Moloco SDK-Version 4.10.0 bestätigt.
• Aktualisiert, um anzugeben, dass das Moloco SDK Impressionen nativer Anzeigen erfassen kann.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.9.0
• Moloco SDK-Version 4.10.0

Version 4.9.1.0

• Kompatibilität mit Moloco SDK-Version 4.9.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.8.0
• Moloco SDK-Version 4.9.1

Version 4.9.0.0

• Kompatibilität mit Moloco SDK-Version 4.9.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.7.0
• Moloco SDK-Version 4.9.0

Version 4.8.1.1

• Unterstützung für adaptive Banneranzeigengrößen hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.6.0
• Moloco SDK-Version 4.8.1.

Version 4.8.1.0

• Kompatibilität mit Moloco SDK-Version 4.8.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.6.0
• Moloco SDK-Version 4.8.1.

Version 4.8.0.0

• Kompatibilität mit Moloco SDK-Version 4.8.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.6.0
• Moloco SDK-Version 4.8.0

Version 4.7.0.0

• Kompatibilität mit Moloco SDK-Version 4.7.0 bestätigt.
• Aktualisieren Sie die Mindestversion von iOS, um die Abhängigkeit vom Google Mobile Ads SDK zu verringern und Nebenversionen zuzulassen.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.5.0
• Moloco SDK-Version 4.7.0

Version 4.6.1.1

• Der Adapter leitet das ageRestrictedTreatment-Flag des Google Mobile Ads SDK jetzt an die COPPA API des Moloco SDK weiter.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.3.0
• Moloco SDK Version 4.6.1

Version 4.6.1.0

• Kompatibilität mit Moloco SDK-Version 4.6.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.3.0
• Moloco SDK-Version 4.6.1

Version 4.6.0.0

• Kompatibilität mit Moloco SDK-Version 4.6.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.2.0
• Moloco SDK-Version 4.6.0

Version 4.5.1.0

• Kompatibilität mit Moloco SDK-Version 4.5.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.2.0
• Moloco SDK-Version 4.5.1.

Version 4.5.0.0

• Kompatibilität mit Moloco SDK-Version 4.5.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.1.0
• Moloco SDK-Version 4.5.0

Version 4.4.1.0

• Kompatibilität mit Moloco SDK-Version 4.4.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.1.0
• Moloco SDK-Version 4.4.1

Version 4.4.0.0

• Kompatibilität mit Moloco SDK-Version 4.4.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 13.1.0
• Moloco SDK-Version 4.4.0

Version 4.3.0.2

• Die Google Mobile Ads SDK-Abhängigkeit wurde auf Version 13.0.0 aktualisiert.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.0.0
• Moloco SDK-Version 4.3.0

Version 4.3.0.1

• Die mindestens erforderliche iOS-Version für CocoaPods wurde auf 13.0 aktualisiert.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 13.0.0
• Moloco SDK-Version 4.3.0

Version 4.3.0.0

• Kompatibilität mit Moloco SDK-Version 4.3.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• Moloco SDK-Version 4.3.0

Version 4.2.0.0

• Kompatibilität mit Moloco SDK-Version 4.2.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• Moloco SDK-Version 4.2.0

Version 4.1.2.0

• Kompatibilität mit Moloco SDK-Version 4.1.2 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• Moloco SDK-Version 4.1.2

Version 4.1.0.0

• Kompatibilität mit Moloco SDK-Version 4.1.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.14.0
• Moloco SDK-Version 4.1.0

Version 3.13.0.0

• Enthält Info.plist in den Frameworks.
• Kompatibilität mit Moloco SDK-Version 3.13.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.9.0
• Moloco SDK Version 3.13.0

Version 3.12.1.0

• Kompatibilität mit Moloco SDK-Version 3.12.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.8.0
• Moloco SDK-Version 3.12.1

Version 3.12.0.0

• Kompatibilität mit Moloco SDK-Version 3.12.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.8.0
• Moloco SDK-Version 3.12.0

Version 3.11.0.0

• Kompatibilität mit Moloco SDK-Version 3.11.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.6.0
• Moloco SDK Version 3.11.0

Version 3.10.1.0

• Kompatibilität mit Moloco SDK-Version 3.10.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.6.0
• Moloco SDK-Version 3.10.1

Version 3.10.0.0

• Kompatibilität mit Moloco SDK-Version 3.10.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.5.0
• Moloco SDK-Version 3.10.0

Version 3.9.1.0

• Unterstützung für Wasserzeichen für Bidding-Anzeigenformate hinzugefügt.
• Ein Problem beim Laden von MREC-Banneranzeigen wurde behoben.
• Kompatibilität mit Moloco SDK-Version 3.9.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.3.0
• Moloco SDK-Version 3.9.1.

Version 3.9.0.0

• Der Name der Vermittlungsplattform wird jetzt beim Initialisieren des Moloco SDK festgelegt.
• Kompatibilität mit Moloco SDK-Version 3.9.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.3.0
• Moloco SDK Version 3.9.0

Version 3.8.0.0

• Die Flags -fobjc-arc und -fstack-protector-all sind aktiviert.
• Ein Problem beim Abrufen der Sternebewertung für native Anzeigen wurde behoben.
• Kompatibilität mit Moloco SDK-Version 3.8.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.2.0
• Moloco SDK Version 3.8.0

Version 3.7.2.0

• Kompatibilität mit Moloco SDK-Version 3.7.2 bestätigt.
• Bidding-Unterstützung für native Anzeigenformate hinzugefügt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.1.0
• Moloco SDK-Version 3.7.2

Version 3.7.1.0

• Kompatibilität mit Moloco SDK-Version 3.7.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 12.1.0
• Moloco SDK-Version 3.7.1

Version 3.7.0.0

• Kompatibilität mit Moloco SDK-Version 3.7.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.0.0
• Moloco SDK-Version 3.7.0

Version 3.6.0.1

• Der Adapter wurde aktualisiert, um die Moloco SDK-Version aus dem Hauptthread abzurufen.
• Jetzt ist das Google Mobile Ads SDK ab Version 12.0.0 erforderlich.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 12.0.0
• Moloco SDK Version 3.6.0

Version 3.6.0.0

• Kompatibilität mit Moloco SDK-Version 3.6.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 11.13.0
• Moloco SDK Version 3.6.0

Version 3.5.0.0

• Erste Version
• Unterstützung für Gebote für Banner- (einschließlich MREC), Interstitial- und Anzeigenformate mit Prämie hinzugefügt.
• Kompatibilität mit Moloco SDK-Version 3.5.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 11.13.0
• Moloco SDK-Version 3.5.0