Integrare myTarget con la mediazione

Seleziona la piattaforma: Android (beta) Android iOS Unity Flutter

Questa guida mostra come utilizzare GMA Next-Gen SDK per caricare e mostrare gli annunci di myTarget utilizzando la mediazione, incluse le integrazioni con struttura a cascata. Viene illustrato come aggiungere myTarget alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore myTarget in un'app per Android.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per myTarget ha le seguenti funzionalità:

Requisiti

• Livello API Android 24 o versioni successive

• Più recente GMA Next-Gen SDK.

• Completa la Guida introduttiva alla mediazione .

Passaggio 1: configura le impostazioni nell'UI di myTarget

Accedi al tuo account myTarget. Vai alla pagina App facendo clic su APP nell'intestazione. Aggiungi l'app facendo clic su AGGIUNGI APP.

Poi, fornisci l' URL di Google Play per la tua app.

Quando aggiungi un'app, myTarget ti chiede di creare un'unità pubblicitaria prima di poter completare la procedura.

Nella pagina dei dettagli dell'unità pubblicitaria, prendi nota dell'ID slot, che si trova nelle impostazioni dell'unità pubblicitaria come slot_id. Questo ID slot verrà utilizzato per configurare l'unità pubblicitaria di Ad Manager nella sezione successiva.

Oltre a slot_id, avrai bisogno anche del token di accesso permanente di myTarget per configurare l'ID unità pubblicitaria di AdMob. Vai alla scheda Profilo e seleziona Token di accesso. Fai clic su Crea token o Mostra token per visualizzare il token di accesso permanente di myTarget.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa IAB Tech Lab che garantisce la vendita dell'inventario di annunci per app della tua app solo in canali che hai indicato come autorizzati. Per evitare una riduzione significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai ancora fatto, crea un file app-ads.txt per Ad Manager.

Per implementare app-ads.txt per myTarget, consulta Come creare e pubblicare un file.

Attiva la modalità di test

Segui le istruzioni nella documentazione di myTarget per aggiungere e configurare un dispositivo di test nell'UI di myTarget.

Passaggio 2: configura la domanda di myTarget nell'UI di Ad Manager

Configura le impostazioni di mediazione per l'unità pubblicitaria

Accedi al tuo account Ad Manager.

Vai a Pubblicazione > Gruppi di rendimento e fai clic sul pulsante Nuovo gruppo di rendimento.

Inserisci un nome univoco per il gruppo di rendimento, imposta lo Stato su Attivo, seleziona il Formato dell'annuncio e imposta il Tipo di inventario su App mobile. Nella sezione Targeting > Inventario , seleziona l'unità pubblicitaria in Inventario e Applicazione mobile a cui vuoi aggiungere la mediazione.

Poi, fai clic sul pulsante Aggiungi partner di rendimento.

Se hai già un partner di rendimento per myTarget, puoi selezionarlo. In alternativa, seleziona Crea un nuovo partner di rendimento.

Seleziona myTarget come Rete pubblicitaria, inserisci un nome univoco e attiva Mediazione.

Attiva Raccolta automatica dei dati e inserisci il token di accesso permanente ottenuto nella sezione precedente.

Una volta selezionato il partner di rendimento, scegli Mediazione SDK per dispositivi mobili come Tipo di integrazione, Android come la Piattaforma, e Attivo come lo Stato. Inserisci l' ID slot ottenuto nella sezione precedente. Poi, inserisci un valore di CPM predefinito.

Al termine, fai clic su Salva nella parte inferiore della pagina.

Aggiungi Mail.ru all'elenco dei partner pubblicitari per il GDPR e le normative statali degli Stati Uniti

Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere Mail.ru all' elenco dei partner pubblicitari per i regolamenti europei e statali degli Stati Uniti nell'UI di Ad Manager.

Passaggio 3: importa l'SDK e l'adattatore myTarget

Integrazione di Android Studio (consigliata)

Nel file gradle a livello di app, aggiungi le seguenti dipendenze e configurazioni di implementazione:

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'
}

Integrazione manuale

• Per includere l'SDK myTarget, consulta la documentazione dell'SDK Android myTarget.

• Vai agli artefatti dell'adattatore myTarget nel repository Maven di Google. Seleziona la versione più recente, scarica il file .aar dell'adattatore myTarget e aggiungilo al tuo progetto.

Passaggio 4: implementa le impostazioni sulla privacy nell'SDK myTarget

Consenso degli utenti dell'UE e GDPR

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, è obbligatorio informare i tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ricevere il loro consenso per l'utilizzo dei cookie o di altri tipi di archiviazione locale, laddove richiesto dalla legge, nonché per la raccolta, la condivisione e l'utilizzo dei dati personali ai fini della personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. È tua responsabilità verificare che il consenso venga propagato a ogni origine annuncio nella catena di mediazione. Google non è in grado di trasmettere automaticamente la scelta di consenso dell'utente a queste reti.

Nella versione 5.1.0 dell'SDK, myTarget ha aggiunto un'API per il consenso degli utenti per supportare i requisiti di privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso all'SDK myTarget. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite GMA Next-Gen SDK.

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

MyTargetPrivacy.setUserConsent(true);

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

MyTargetPrivacy.setUserConsent(true)

Inoltre, se sai che l'utente appartiene a una categoria con limitazioni di età, puoi utilizzare il seguente codice per trasmettere queste informazioni sul consenso all'SDK myTarget.

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

MyTargetPrivacy.setUserAgeRestricted(true);

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

MyTargetPrivacy.setUserAgeRestricted(true)

Per ulteriori informazioni e per i valori che possono essere forniti nel metodo, consulta la guida alla privacy e al GDPR di myTarget.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti impongono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (secondo la definizione di questi termini fornita dalla legge) mediante il link "Non vendere le mie informazioni personali" ben in evidenza nella home page del "venditore". La guida alla conformità alle leggi statali sulla privacy degli Stati Uniti offre la possibilità di attivare il trattamento dati limitato per la pubblicazione di annunci Google, ma Google non è in grado di applicare questa impostazione a ogni rete pubblicitaria nella catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

Nella versione 5.9.0 dell'SDK, myTarget ha aggiunto un'API per il consenso degli utenti per supportare i requisiti di privacy. Il seguente codice campione mostra come passare queste informazioni sul consenso all'SDK myTarget. Se scegli di chiamare questo metodo, ti consigliamo di farlo prima di richiedere gli annunci tramite GMA Next-Gen SDK.

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

MyTargetPrivacy.setCcpaUserConsent(true);

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

MyTargetPrivacy.setCcpaUserConsent(true)

Per ulteriori informazioni e per i valori che possono essere forniti nel metodo, contatta l'assistenza di myTarget per maggiori informazioni.

Passaggio 5: aggiungi il codice richiesto

Non è necessario aggiungere altro codice per l'integrazione di myTarget.

Passaggio 6: verifica l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager e attivare la modalità di test nell'UI di myTarget.

Verifica gli annunci di prova

Per verificare di ricevere annunci di prova da myTarget, attiva il test di una singola origine annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio myTarget (cascata).

Passaggi facoltativi

Utilizzo degli annunci nativi

Rendering dell'annuncio

L'adattatore myTarget restituisce gli annunci nativi come NativeAd oggetti. Compila i seguenti campi per un NativeAd.

L'SDK myTarget restituisce sempre 0 per mediaView larghezza e altezza, quindi l' adattatore myTarget restituisce sempre 0 per getAspectRatio(). L'SDK myTarget risolverà questo problema in una release futura.

Monitoraggio delle impressioni e dei clic

GMA Next-Gen SDK utilizza i callback dell'SDK myTarget per il monitoraggio delle impressioni e dei clic, quindi i report di entrambe le origini dovrebbero corrispondere con poche o nessuna discrepanza.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da myTarget, puoi controllare l' errore sottostante nella risposta dell'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

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

Ecco i codici e i messaggi associati generati dall'adattatore myTarget quando un annuncio non viene caricato: