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 über die AdMob-Vermittlung laden und präsentieren. Dabei werden auch Vermittlungsabfolge-Integrationen behandelt. Außerdem 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.

• Startleitfaden zur Vermittlung abschließen.

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 AdMob-Anzeigenblock einzurichten.

Neben der slot_id benötigen Sie auch Ihr permanentes Zugriffstoken von myTarget, um die Anzeigenblock-ID von AdMob einzurichten. Rufen Sie den Tab Profil auf und wählen Sie Zugriffstokens aus. Klicken Sie auf Token erstellen oder Token anzeigen , um Ihr permanentes Zugriffstoken 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. Wenn Sie das noch nicht getan haben, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Informationen zum Implementieren von app-ads.txt für myTarget finden Sie unter 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 AdMob-Benutzeroberfläche einrichten

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Sie müssen myTarget der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.

Melden Sie sich zuerst in Ihrem AdMob-Konto an. Rufen Sie dann den Tab Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit myTarget 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:

myTarget als Anzeigenquelle hinzufügen

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 AdMob-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 im 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 wird die Möglichkeit geboten, die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung zu aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk 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 jeweiligen 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 AdMob 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 Feldbeschreibungen für native Anzeigen für ein NativeAdaus.

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

Impressions- und Klick-Tracking

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

Fehlercodes

Wenn der Adapter keine Anzeige von myTarget empfangen kann, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() in 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: