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 Ad Manager -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).
Füllen Sie das Formular aus und klicken Sie unten auf der Seite auf Erstellen, um Ihre App zu AdColony hinzuzufügen.
Android
iOS
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
iOS
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 Ad Manager eine neue Anzeigengruppe zu erstellen, auch wenn Sie bereits eine haben.
Android
iOS
Weitere Informationen zum Erstellen eines Anzeigen-Placements finden Sie auf dem Tab für Ihr bevorzugtes Anzeigenformat.
Banner
- Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).
Geben Sie einen Namen für die Zone ein.
Wählen Sie Banner als Größe der Anzeigenfläche aus.
Geben Sie einen Wert für das Tageslimit für die Wiedergabe ein.
Interstitial
- Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).
Geben Sie einen Namen für die Zone ein.
Wählen Sie als Zonentyp Pre-Roll/Interstitial aus.
Geben Sie einen Wert für das Tageslimit für die Wiedergabe ein.
Verfügbar
- Setzen Sie Zone is Active? (Zone ist aktiv?) auf Yes (Ja).
Geben Sie einen Namen für die Zone ein.
Wählen Sie Value Exchange/V4VC als Zonentyp aus.
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.
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-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 IhreAd Manager Anzeigenblock-ID einzurichten. Rufen Sie im AdColony-Publisher-Dashboard die Kontoeinstellungen auf und suchen Sie Ihren API-Schlüssel.
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.
Schritt 2: AdColony-Nachfrage auf 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.
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 Ad Manager 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
EU-Nutzereinwilligung 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.
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 Ad Manager 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
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/AdColony/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.AdColony
überarbeitet. - Unterstützt Android-Adapterversion 4.8.0.2 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.9.0.2.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 8.1.0, entwickelt und getestet.
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
- Unterstützt Android-Adapterversion 4.8.0.0 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.9.0.0.
- Das Unity-Plug-in wurde mit Version 7.1.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 2.5.0
- Unterstützt Android-Adapterversion 4.7.0.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 4.8.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 2.4.1
- Unterstützt Android-Adapterversion 4.6.5.0 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.7.2.2.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 2.4.0
- Unterstützt Android-Adapterversion 4.6.5.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 4.7.2.0.
Version 2.3.0
- Unterstützt Android-Adapterversion 4.5.0.0 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.6.1.0.
Version 2.2.0
- Unterstützt Android-Adapterversion 4.2.4.0 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.4.1.0.
Version 2.1.0
- Unterstützt Android-Adapterversion 4.2.0.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 4.3.0.0.
Version 2.0.3
adcolony-extras-library.jar
wurde inadcolony-unity-android-library.aar
umgepackt, mit einem.aar
-Build zur Unterstützung von Unity 2020.- Entfernen Sie beim Upgrade auf diese Version
adcolony-extras-library.jar
aus Ihrem Projekt.
- Entfernen Sie beim Upgrade auf diese Version
- Unterstützt Android-Adapterversion 4.1.4.1 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.1.5.0.
Version 2.0.2
- Unterstützt Android-Adapterversion 4.1.4.1 von AdColony.
- Unterstützt die AdColony-iOS-Adapterversion 4.1.4.1.
Version 2.0.1
- Unterstützt Android-Adapterversion 4.1.4.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 4.1.4.0.
Version 2.0.0
- Unterstützt Android-Adapterversion 4.1.0.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 4.1.2.0.
Version 1.0.6
- Unterstützt Android-Adapterversion 3.3.11.0 von AdColony.
- Unterstützt die AdColony iOS-Adapterversion 3.3.8.1.0.
Version 1.0.5
- Die folgenden Methoden wurden aus der Builder-Klasse
AdColonyMediationExtras
in die KlasseAdColonyAppOptions
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-KlasseAdColonyMediationExtras
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-KlasseAdColonyMediationExtras
wird jetzt für Android ignoriert. Publisher können jetzt Testanzeigen von AdColony für Android anfordern, indem sie überAddTestDevice()
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.