Integra Pangle 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 Pangle utilizzando la mediazione, che copre sia le integrazioni con struttura a cascata sia quelle con offerte. Descrive come aggiungere Pangle alla configurazione di mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore Pangle in un'app per Android.

Integrazioni e formati degli annunci supportati

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

Requisiti

• Livello API Android 24 o versioni successive

• [Per le offerte] Per integrare tutti i formati degli annunci supportati nelle offerte, utilizza l'adattatore Pangle 5.5.0.4.0 o versioni successive (versione più recente consigliata)

• Più recente GMA Next-Gen SDK

• Completa la mediazione Guida introduttiva

Passaggio 1: configura le impostazioni nell'UI di Pangle

Registrati o accedi al tuo account Pangle.

Aggiungi una nuova applicazione

Vai alla scheda Applicazioni e fai clic sul pulsante Aggiungi app.

Seleziona il sistema operativo per cui vuoi creare un'applicazione e compila il resto del modulo. Quindi, fai clic su Invia.

Prendi nota dell'ID app della tua applicazione.

Crea un posizionamento dell'annuncio

Una volta creata l'applicazione, fai clic sul pulsante Aggiungi per creare il posizionamento dell'annuncio.

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 Pangle, consulta la pagina Come aggiungere Pangle al file app-ads.txt.

Attiva la modalità di test

Segui le istruzioni riportate nella guida Come aggiungere un annuncio di test di Pangle su come attivare gli annunci di test di Pangle.

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

Accedi al tuo account Ad Manager.

Aggiungi Pangle in Aziende

Attiva la condivisione di indicatori sicuri

Condividi indicatori sicuri nelle richieste di offerta

Consenti la condivisione di indicatori sicuri per le offerte dell'SDK

Configura le offerte di Pangle

Configura la mappatura delle unità pubblicitarie

Aggiungi Pangle DSP 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 Pangle DSP 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 Pangle

Integrazione di Android Studio (consigliata)

Nel file settings.gradle.kts a livello di progetto, aggiungi i seguenti repository:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifact.bytedance.com/repository/pangle/")
    }
  }
}

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:pangle:7.9.1.1.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:pangle:7.9.1.1.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

1. Scarica la versione più recente dell' SDK Pangle per Android ed estrai open_ad_sdk.aar dalla cartella dell'archivio scaricato e aggiungilo al tuo progetto.

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

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

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.

A partire dalla versione 7.9.0.9 dell'SDK Pangle, Pangle legge automaticamente il consenso GDPR impostato dalle piattaforme di gestione del consenso che supportano la specifica di consenso aggiuntivo di Google, incluso l'SDK UMP.

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à.

L'adattatore Pangle fornisce il PangleMediationAdapter.setPAConsent() metodo che inoltra le informazioni sul consenso all'adattatore Pangle e poi all' SDK Pangle. Il seguente codice campione mostra come passare le informazioni sul consenso all'SDK Pangle. Imposta le informazioni sul consenso prima di inizializzare GMA Next-Gen SDK per assicurarti che vengano inoltrate correttamente all'SDK Pangle.

import com.google.ads.mediation.pangle.PangleMediationAdapter;
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT);

import com.google.ads.mediation.pangle.PangleMediationAdapter
// ...

PangleMediationAdapter.setPAConsent(PAGConstant.PAGPAConsentType.PAG_PA_CONSENT_TYPE_CONSENT)

Per maggiori dettagli e per i valori che possono essere forniti in ogni metodo, consulta la guida all'integrazione Android di Pangle.

Passaggio 5: aggiungi il codice richiesto

Offuscamento di ProGuard

Se utilizzi ProGuard per offuscare il codice Android, segui le istruzioni riportate nella documentazione di Pangle per assicurarti che il codice dell'SDK Pangle non venga offuscato.

Passaggio 6: testa l'implementazione

Attiva gli annunci di test

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

Verifica gli annunci di test

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

Passaggi facoltativi

Annunci nativi

Rendering degli annunci

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

¹ L'adattatore Pangle non fornisce l'accesso diretto all'asset immagine principale per i suoi annunci nativi. L'adattatore compila invece il MediaView con un video o un'immagine.

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da Pangle, puoi controllare il errore sottostante dalla risposta all'annuncio utilizzando ResponseInfo.getAdSourceResponses() nelle seguenti classi:

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

Di seguito sono riportati i codici e i messaggi associati generati dall'adattatore Pangle quando un annuncio non viene caricato: