AdColony in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus AdColony mithilfe der Vermittlung zu laden und einzublenden. Dabei werden sowohl Bidding- als auch abfolgebasierte Integrationen berücksichtigt. Sie erfahren, wie Sie AdColony der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das AdColony SDK und den AdColony-Adapter in eine Unity-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der AdMob -Vermittlungsadapter für AdColony bietet folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar

Voraussetzungen

  • Unity 5.6 oder höher
  • Das aktuelle Google Mobile Ads SDK
  • [Für Gebote]: Vermittlungs-Plug-in für Google Mobile Ads für AdColony 1.0.5 oder höher (aktuelle Version empfohlen)
  • Für die Bereitstellung unter Android
    • Android API-Level 19 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 AdColony-Benutzeroberfläche einrichten

Registrieren Sie sich und melden Sie sich in Ihrem AdColony-Konto an. Fügen Sie Ihre App dem AdColony-Publisher-Dashboard hinzu. Klicken Sie dazu auf die Schaltfläche Setup New App (Neue App einrichten).

Neue App in AdColony einrichten

Füllen Sie das Formular aus und klicken Sie unten auf der Seite auf Erstellen, um Ihre App zu AdColony hinzuzufügen.

Android

AdColony-App erstellen

iOS

AdColony-App erstellen

Nachdem Ihre App erstellt wurde, können Sie Ihre App-ID abrufen. Rufen Sie dazu im Abschnitt Allgemeine App-Informationen der App Monetarisierung > Apps auf.

Android

AdColony-App-ID

iOS

AdColony-App-ID

Erstellen Sie als Nächstes eine neue Zone, indem Sie auf der App-Seite im Bereich Werbezonen auf die Schaltfläche Neue Zone einrichten klicken. Wir empfehlen, für die Vermittlung mit AdMob eine neue Anzeigengruppe zu erstellen, auch wenn Sie bereits eine haben.

Android

AdColony – Zone einrichten

iOS

AdColony – Zone einrichten

Weitere Informationen zum Erstellen eines Anzeigen-Placements finden Sie auf dem Tab für Ihr bevorzugtes Anzeigenformat.

  1. Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).

  2. Geben Sie einen Namen für die Zone ein.

  3. Wählen Sie Banner als Größe der Anzeigenfläche aus.

  4. Geben Sie einen Wert für das Tageslimit für die Wiedergabe ein.

Interstitial

  1. Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).

  2. Geben Sie einen Namen für die Zone ein.

  3. Wählen Sie als Zonentyp Pre-Roll/Interstitial aus.

  4. Geben Sie einen Wert für das Tageslimit für die Wiedergabe ein.

Verfügbar

  1. Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).

  2. Geben Sie einen Namen für die Zone ein.

  3. Wählen Sie Value Exchange/V4VC als Zonentyp aus.

  4. Setzen Sie Nur Client? auf Ja und geben Sie einen Namen für die virtuelle Währung, Maximale Anzahl von Videos pro Nutzer pro Tag und Prämienbetrag ein.

  5. Geben Sie einen Wert für das Tageslimit für die Wiedergabe ein.

Klicken Sie abschließend auf die Schaltfläche Erstellen.

Nachdem die Zone erstellt wurde, finden Sie die Zonen-ID der Zone im Bereich Integration. Die Zonen-ID wird im nächsten Schritt verwendet.

AdColony-Zonen-ID

AdColony-API-Schlüssel finden

Gebote

Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.

Wasserfall

Sie benötigen Ihren AdColony-API-Schlüssel, um IhreAdMob Anzeigenblock-ID einzurichten. Rufen Sie im AdColony-Publisher-Dashboard die Kontoeinstellungen auf und suchen Sie Ihren API-Schlüssel.

AdColony-Einstellungen

Testmodus aktivieren

Um Testanzeigen in AdColony zu aktivieren, rufen Sie Ihr AdColony-Dashboard auf und rufen Sie Monetarisierung > Apps auf. Wählen Sie im Bereich Anzeigenzonen Ihrer App die Zone aus, für die Sie Testanzeigen aktivieren möchten. Wenn Sie Testanzeigen aktivieren möchten, setzen Sie im Bereich Entwicklung ein Häkchen bei Ja, um Nur Testanzeigen zeigen? auszuwählen.

AdColony-Test

Schritt 2: AdColony-Nachfrage auf der AdMob 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.

AdColony zur Liste der Werbepartner für DSGVO und Bestimmungen von US-Bundesstaaten hinzufügen

Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um AdColony in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.

Schritt 3: AdColony SDK und Adapter importieren

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für AdColony über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsAdColonyMediation.unitypackage aus der ZIP-Datei.

Wählen Sie im Unity-Projekteditor Assets > Paket importieren > Benutzerdefiniertes Paket aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsAdColonyMediation.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 Bibliothek des externen Abhängigkeitsmanagers 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 AdColony 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.

Im Google Mobile Ads-Vermittlungs-Plug-in für AdColony Version 2.6.1 wurde die Klasse AdColonyAppOptions mit den Methoden SetPrivacyFrameworkRequired() und SetPrivacyConsentString() hinzugefügt, damit Sie die Einwilligung an das AdColony SDK übergeben können. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an den AdColony-Adapter übergeben werden, die dann in der Initialisierungsmethode von AdColony verwendet werden. Diese Optionen müssen vor dem Initialisieren des Google Mobile Ads SDK festgelegt werden, damit sie korrekt an das SDK von AdColony weitergeleitet werden.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie im Artikel zum Datenschutz bei Verbraucher:innen von AdColony und im Leitfaden zur Umsetzung von Datenschutzgesetzen.

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.

Im Google Mobile Ads-Vermittlungs-Plug-in für AdColony Version 2.6.1 wurde die Klasse AdColonyAppOptions mit den Methoden SetPrivacyFrameworkRequired() und SetPrivacyConsentString() hinzugefügt, damit Sie die Einwilligung an das AdColony SDK übergeben können. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an den AdColony-Adapter übergeben werden, die dann in der Initialisierungsmethode von AdColony verwendet werden. Diese Optionen müssen vor dem Initialisieren des Google Mobile Ads SDK festgelegt werden, damit sie ordnungsgemäß an das SDK von AdColony weitergeleitet werden.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie im Artikel zum Datenschutz bei Verbraucher:innen von AdColony und im Leitfaden zur Umsetzung von Datenschutzgesetzen.

Schritt 5: Erforderlichen Code hinzufügen

Android

Für die AdColony-Integration ist kein zusätzlicher Code erforderlich.

iOS

SKAdNetwork-Integration

Folgen Sie der AdColony-Dokumentation, um die SKAdNetwork-Kennungen in die Info.plist-Datei Ihres Projekts einzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der AdColony Benutzeroberfläche.

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vonAdColonyerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der AdColony (Bidding) and AdColony (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.

Optionale Schritte

Android

Berechtigungen

Für eine optimale Leistung empfiehlt AdColony, der Datei AndroidManifest.xml im Verzeichnis Assets/Plugins/Android/GoogleMobileAdsPlugin Ihres Unity-Projekts die folgenden optionalen Berechtigungen hinzuzufügen.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

iOS

Für die iOS-Integration sind keine weiteren Schritte erforderlich.

Netzwerkspezifische Parameter

Das AdColony-Vermittlungspaket unterstützt zusätzliche Konfigurations- und Anfrageparameter, die mithilfe der Klassen AdColonyMediationExtras und AdColonyAppOptions an den Adapter übergeben werden können.

Die Klasse AdColonyMediationExtras umfasst die folgenden Methoden:

SetShowPrePopup(bool)
Damit wird festgelegt, ob vor der Anzeigenauslieferung ein Pop-up-Fenster eingeblendet werden soll. Legen Sie den Wert auf „false“ fest, wenn vor der Anzeigenauslieferung kein Pop-up eingeblendet werden soll.
SetShowPostPopup(bool)
Damit wird festgelegt, ob nach dem Einblenden einer Anzeige ein Pop-up-Fenster eingeblendet werden soll. Legen Sie „false“ fest, wenn nach der Anzeigenauslieferung kein Pop-up eingeblendet werden soll.

Die Klasse AdColonyAppOptions umfasst die folgenden Methoden:

SetUserId(string)
Legt die User-ID für das AdColony SDK fest, das dem AdColony-Ad-Server weitere Analysen liefert.
SetTestMode(bool)
Legt fest, ob der Testmodus für das AdColony SDK aktiviert werden soll.

Hier ein Codebeispiel für das Festlegen dieser Konfigurationen und Anzeigenanfragenparameter:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Fehlercodes

Wenn der Adapter keine Anzeige von AdColony empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo in den folgenden Klassen prüfen:

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

Im Folgenden sind die Codes und Begleitmeldungen aufgeführt, die vom AdColony-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Android

Fehlercode Grund
100 Das AdColony SDK hat einen Fehler zurückgegeben.
101 Ungültige Serverparameter (z.B. fehlende Zonen-ID).
102 Es wurde bereits eine Anzeige für dieselbe Zonen-ID angefordert.
103 Das AdColony SDK hat einen Initialisierungsfehler zurückgegeben.
104 Die angeforderte Bannergröße ist keiner gültigen AdColony-Anzeigengröße zugeordnet.
105 Präsentationsfehler, da die Anzeige nicht geladen wurde.
106 Der zum Initialisieren des AdColony SDK verwendete Kontext war keine Activity-Instanz.

iOS

Fehlercode Grund
0–3 Das AdColony SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation.
101 Ungültige Serverparameter (z.B. fehlende Zonen-ID).
102 Root-Ansicht-Controller, der die Anzeige präsentiert, ist nil.
103 Das AdColony SDK hat einen Initialisierungsfehler zurückgegeben.
104 Das AdColony SDK unterstützt keine zweimalige Konfiguration innerhalb von fünf Sekunden.
105 Anzeige konnte nicht eingeblendet werden.
106 Die für Anzeigen mit Prämie verwendete Zone ist keine Zone mit Prämie im AdColony-Portal.

Änderungsprotokoll des AdColony Unity-Vermittlungs-Plug-ins

Version 2.6.3 (In Bearbeitung)

  • Es wurde eine Warnung wegen doppelter Definition für MediationExtras behoben.

Version 2.6.2

Version 2.6.1

  • Wir haben die Privacy APIs der Klasse AdColonyAppOptions auf die folgenden Methoden aktualisiert, um die DSGVO und das CCPA zu unterstützen:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • Unterstützt Android-Adapterversion 4.8.0.1 von AdColony.
  • Unterstützt die AdColony-iOS-Adapterversion 4.9.0.2.
  • Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.4.1, entwickelt und getestet.

Version 2.6.0

Version 2.5.0

Version 2.4.1

Version 2.4.0

Version 2.3.0

Version 2.2.0

Version 2.1.0

Version 2.0.3

Version 2.0.2

Version 2.0.1

Version 2.0.0

Version 1.0.6

Version 1.0.5

  • Die folgenden Methoden wurden aus der Builder-Klasse AdColonyMediationExtras in die Klasse AdColonyAppOptions verschoben:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Der AdColonyAppOptions-Klasse wurden die folgenden Methoden hinzugefügt:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • Die Methode SetZoneId() wurde aus der Builder-Klasse AdColonyMediationExtras entfernt.
  • Unterstützt die Android-Adapterversion 3.3.10.1 von AdColony.
  • Unterstützt die iOS-Adapterversion 3.3.7.2 von AdColony.

Version 1.0.4

  • Das Plug-in wurde aktualisiert, um die neue offene Beta Reward API zu unterstützen.
  • Unterstützt die Android-Adapterversion 3.3.8.1 von AdColony.
  • Unterstützt iOS-Adapterversion 3.3.6.1 von AdColony.

Version 1.0.3

  • Unterstützt die Android-Adapterversion 3.3.5.1 von AdColony.
  • Unterstützt iOS-Adapterversion 3.3.5.0 von AdColony.

Version 1.0.2

  • Unterstützt AdColony Android SDK Version 3.3.4.
  • Unterstützt Version 3.3.4 des AdColony iOS SDK.
  • SetTestMode() aus der Builder-Klasse AdColonyMediationExtras wird jetzt für Android ignoriert. Publisher können jetzt Testanzeigen von AdColony für Android anfordern, indem sie über AddTestDevice() aus der Builder-Klasse ein Testgerät angeben.AdRequest
  • Der Builder-Klasse AdColonyMediationExtras wurden die folgenden Methoden hinzugefügt:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Version 1.0.1

  • Unterstützt AdColony Android SDK Version 3.3.0-unity.
  • Unterstützt Version 3.3.0 des AdColony iOS SDK.

Version 1.0.0

  • Erste Version!
  • Unterstützt AdColony Android SDK Version 3.3.0.
  • Unterstützt Version 3.3.0 des AdColony iOS SDK.