myTarget in die Vermittlung einbinden

Plattform auswählen: Android (Beta) Android iOS Unity Flutter

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von myTarget mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie myTarget der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das myTarget SDK und den Adapter in eine Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für myTarget bietet folgende Funktionen:

Voraussetzungen

• Android API‑Level 24 oder höher

• Neueste Version des GMA Next-Gen SDK.

• Vermittlung abschließen Startleitfaden.

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

Melden Sie sich an in Ihrem myTarget-Konto. Klicken Sie in der Kopfzeile auf APPS , um zur Seite „Apps“ zu gelangen. Klicken Sie auf APP HINZUFÜGEN , um Ihre App hinzuzufügen.

Geben Sie als Nächstes die Google Play-URL für Ihre App an.

Wenn Sie eine App hinzufügen, müssen Sie in myTarget einen Anzeigenblock erstellen, bevor Sie den Vorgang abschließen können.

Notieren Sie sich auf der Detailseite Ihres Anzeigenblocks die Slot-ID, die Sie in den Einstellungen des Anzeigenblocks unter slot_id finden. Diese Slot-ID wird im nächsten Abschnitt verwendet, um Ihren Ad Manager-Anzeigenblock einzurichten.

Neben der slot_id benötigen Sie auch Ihr Permanent Access Token von myTarget, um Ihre AdMob-Anzeigenblock-ID einzurichten. Rufen Sie den Tab Profil auf und wählen Sie Zugriffstokens aus. Klicken Sie auf Token erstellen oder Token anzeigen , um Ihr Permanent Access Token von myTarget aufzurufen.

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 Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Falls noch nicht geschehen, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

Informationen zum Implementieren von app-ads.txt für myTarget finden Sie unter app-ads.txt-Datei erstellen und veröffentlichen.

Testmodus aktivieren

Folgen Sie der Anleitung in der myTarget-Dokumentation , um ein Testgerät in der myTarget-Benutzeroberfläche hinzuzufügen und zu konfigurieren.

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

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Melden Sie sich in Ihrem Ad Manager-Konto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf den Button Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, legen Sie den Status auf Aktiv fest, wählen Sie das Anzeigenformat aus und legen Sie den Inventartyp auf Mobile App fest. Wählen Sie im Bereich Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf den Button Ertragspartner hinzufügen.

Wenn Sie bereits einen Ertragspartner für myTarget haben, können Sie ihn auswählen. Andernfalls wählen Sie Neuen Ertragspartner erstellen aus.

Wählen Sie myTarget als das Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie Vermittlung.

Aktivieren Sie Automatische Datenerfassung und geben Sie das Permanent Access Token ein, das Sie im vorherigen Abschnitt erhalten haben.

Sobald Sie den Ertragspartner ausgewählt haben, wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus. Geben Sie die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Geben Sie dann einen Wert für den Standard-CPM ein.

Klicken Sie abschließend unten auf der Seite auf Speichern.

Mail.ru der Liste der Werbepartner für die DSGVO und 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 Mail.ru der Liste der Werbepartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten in der Ad Manager-Benutzeroberfläche hinzuzufügen.

Schritt 3: myTarget SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

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

• Informationen zum Einbinden des myTarget SDK finden Sie in der myTarget Android SDK Dokumentation.

• Rufen Sie die myTarget-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des myTarget-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Datenschutzeinstellungen für das myTarget SDK implementieren

Einwilligung der Nutzer 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.

In SDK-Version 5.1.0, hat myTarget eine API für die Einwilligung der Nutzer hinzugefügt, um die Datenschutzanforderungen zu erfüllen. Der folgende Beispielcode zeigt, wie Sie diese Einwilligungsinformationen an das myTarget SDK weitergeben. Wenn Sie diese Methode aufrufen, sollten Sie das vor dem Anfordern von Anzeigen über GMA Next-Gen SDK tun.

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

Wenn Sie wissen, dass der Nutzer einer Altersbeschränkung unterliegt, können Sie außerdem den folgenden Code verwenden, um diese Einwilligungsinformationen an das myTarget SDK weiterzugeben.

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

Weitere Informationen und die Werte, die in der Methode angegeben werden können, finden Sie im Leitfaden zu Datenschutz und DSGVO von myTarget.

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 am Verkauf personenbezogener Daten beteiligt sein kann, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.

In SDK-Version 5.9.0, hat myTarget eine API für die Einwilligung der Nutzer hinzugefügt, um die Datenschutzanforderungen zu erfüllen. Der folgende Beispielcode zeigt, wie Sie diese Einwilligungsinformationen an das myTarget SDK weitergeben. Wenn Sie diese Methode aufrufen, sollten Sie das vor dem Anfordern von Anzeigen über GMA Next-Gen SDK tun.

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

Weitere Informationen und die Werte, die in der Methode angegeben werden können, erhalten Sie vom myTarget-Support.

Schritt 5: Erforderlichen Code hinzufügen

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

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager und aktivieren Sie den Testmodus in der myTarget-Benutzeroberfläche.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von myTarget erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen myTarget (Vermittlungsabfolge).

Optionale Schritte

Native Anzeigen verwenden

Anzeigen-Rendering

Der myTarget-Adapter gibt seine nativen Anzeigen als NativeAd-Objekte zurück. Er füllt die folgenden Felder für NativeAd aus.

Das myTarget SDK gibt immer 0 für die Breite und Höhe von mediaView zurück, sodass der myTarget-Adapter immer 0 für getAspectRatio() zurückgibt. Dieses Problem wird in einer zukünftigen Version des myTarget SDK behoben.

Impressionen- und Klick-Tracking

GMA Next-Gen SDK verwendet die Callbacks des myTarget SDK für das Impressionen- und Klick-Tracking. Die Berichte aus beiden Quellen sollten daher weitgehend übereinstimmen.

Fehlercodes

Wenn der Adapter keine Anzeige von myTarget empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() unter den folgenden Klassen prüfen:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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