Integrare BidMachine con la mediazione

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

Questa guida mostra come utilizzare Google Mobile Ads SDK per caricare e visualizzare gli annunci di BidMachine utilizzando la mediazione, che copre le integrazioni di asta. Illustra come aggiungere BidMachine alla configurazione della mediazione di un'unità pubblicitaria e come integrare l'SDK e l'adattatore BidMachine in un'app per iOS.

Integrazioni e formati degli annunci supportati

L'adattatore di mediazione per BidMachine offre le seguenti funzionalità:

Integrazione
Offerte
Cascata	^1
Formati
Apertura app
Banner
Interstitial
Con premio
Interstitial con premio
Nativo

¹ L'integrazione con la struttura a cascata è in versione beta chiusa. Contatta il tuo account manager per richiedere l'accesso.

Prerequisiti

Prima di continuare, verifica quanto segue:

• Target di deployment iOS 13.0 o versioni successive.

• Ultima versione di Google Mobile Ads SDK.

• Configura la mediazione.

Passaggio 1: imposta le configurazioni nell'interfaccia utente di BidMachine

Accedi alla dashboard del tuo account BidMachine.

Crea nuovi posizionamenti

Vai alla scheda Origine e, nella tabella Origini, seleziona il pulsante Modifica.

Nota :BidMachine crea automaticamente un'origine. Se vuoi creare una nuova origine, contatta il tuo account manager.

Verrà visualizzato un elenco di tutti i posizionamenti disponibili. Per creare un nuovo posizionamento, fai clic sul pulsante Aggiungi posizionamento nella finestra di dialogo.

Seleziona Asta come Tipo di posizionamento. Compila il modulo e fai clic su Salva.

Infine, prendi nota dell'ID posizionamento.

Aggiorna il file app-ads.txt

Authorized Sellers for Apps app-ads.txt è un'iniziativa di IAB Tech Lab che contribuisce a garantire che il tuo inventario pubblicitario dell'app venga venduto solo tramite canali che hai identificato come autorizzati. Per evitare una perdita significativa delle entrate pubblicitarie, devi implementare un file app-ads.txt. Se non l'hai già fatto, crea un file app-ads.txt per Ad Manager.

Per implementare app-ads.txt per BidMachine, vai alla scheda app-ads.txt dalla dashboard. Poi, copia l'elenco e aggiungilo al file app-ads.txt del tuo sito web.

Passaggio 2: configura la domanda BidMachine nell'interfaccia utente di Ad Manager

Accedi al tuo account Ad Manager.

Aggiungi BidMachine in Aziende

Offerte

Questo passaggio non è obbligatorio per le integrazioni di asta.

Cascata

Vai ad Amministrazione > Aziende, poi fai clic sul pulsante Nuova azienda nella scheda Tutte le aziende. Seleziona Rete pubblicitaria.

Seleziona BidMachine come Rete pubblicitaria, inserisci un Nome univoco e attiva Mediazione.

Non è necessario inserire un Nome utente o una Password. Al termine, fai clic su Salva.

Attiva la condivisione di indicatori sicuri

Offerte

Vai su Amministratore > Impostazioni globali. Vai alla scheda Impostazioni dell'account Ad Exchange, rivedi e attiva Condivisione di indicatori sicuri. Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni con la struttura a cascata.

Condividere indicatori sicuri nelle richieste di offerta

Offerte

Vai a Inventario > Indicatori sicuri. Nella sezione Indicatori sicuri, cerca BidMachine e attiva Attiva integrazione app.

Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni con la struttura a cascata.

Consenti la condivisione di indicatori sicuri per SDK Bidding

Offerte

Vai a Pubblicazione > Impostazioni canali di domanda. Nella scheda Impostazioni predefinite, attiva l'opzione Consenti la condivisione di indicatori sicuri per SDK Bidding.

Fai clic su Salva.

Cascata

Questo passaggio non è obbligatorio per le integrazioni a cascata.

Configura l'asta BidMachine

Offerte

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Fai clic su Nuovo offerente.

Seleziona BidMachine come offerente.

Fai clic su Continua per attivare SDK Bidding per questo offerente.

Fai clic su Fine.

Cascata

Questo passaggio non è obbligatorio per le integrazioni con la struttura a cascata.

Configura la mappatura delle unità pubblicitarie

Offerte

Vai a Pubblicazione > Offerenti e fai clic su Vai a SDK Bidding.

Seleziona l'azienda per BidMachine.

Vai alla scheda Mappatura delle unità pubblicitarie e fai clic su Nuova mappatura delle unità pubblicitarie.

Scegli Unità pubblicitaria specifica. Seleziona un'unità pubblicitaria e un formato, App mobile come Tipo di inventario e la tua Applicazione mobile. Poi, inserisci l'ID origine e l'ID posizionamento ottenuti nella sezione precedente.

Infine, fai clic su Salva.

Importante: l'unità pubblicitaria selezionata deve essere scelta come target da almeno un gruppo di rendimento e l'ID origine deve essere associato all'app scelta come target, come nell'interfaccia utente di BidMachine.

Cascata

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

Scorri fino a Partner di rendimento e fai clic su Aggiungi partner di mediazione.

Seleziona l'azienda che hai creato per BidMachine nella sezione precedente. Scegli Mediazione SDK mobile come Tipo di integrazione, iOS come Piattaforma e Attivo come Stato.

Inserisci l'ID posizionamento ottenuto nella sezione precedente e il valore CPM predefinito. Fai clic su Salva.

Importante: l'ID origine deve essere associato all'app target come nell'interfaccia utente di BidMachine.

Aggiungi BidMachine all'elenco dei partner pubblicitari ai sensi del GDPR e dei regolamenti statali degli Stati Uniti

Importante: verifica di disporre dell'autorizzazione Gestione account per completare la configurazione per il consenso dell'UE e il GDPR, i regolamenti statali degli Stati Uniti e la piattaforma di messaggistica per gli utenti. Per maggiori dettagli, vedi Gestire l'accesso degli utenti al tuo account.

Segui i passaggi descritti in Impostazioni dei regolamenti europei e Impostazioni dei regolamenti statali degli Stati Uniti per aggiungere BidMachine all'elenco dei partner pubblicitari ai sensi dei regolamenti europei e statali degli Stati Uniti nell'interfaccia utente di Ad Manager.

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

Nota: la mancata integrazione delle versioni compatibili dell'SDK BidMachine e dell'SDK Google Mobile Ads potrebbe causare problemi di build.

Utilizza Swift Package Manager

Prima di continuare, devi avere la versione minima supportata dell'adattatore, ovvero la 3.6.0.0.

Per aggiungere una dipendenza del pacchetto al tuo progetto, segui questi passaggi:

1. In Xcode, vai a File > Add Package Dependencies… (File > Aggiungi dipendenze pacchetto…).

2. Nel prompt visualizzato, cerca il seguente URL del pacchetto:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. In Regola di dipendenza, seleziona Branch.

4. Nel campo di testo, inserisci main.

Utilizzare CocoaPods

• Aggiungi la seguente riga al Podfile del tuo progetto:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• Dalla riga di comando, esegui:

  pod install --repo-update

Integrazione manuale

1. Scarica l'ultima versione dell'SDK BidMachine per iOS e collega tutti i file e i bundle .xcframework nel tuo progetto.

2. Scarica l'ultima versione dell'adattatore BidMachine dal link di download nel log delle modifiche e collega BidMachineAdapter.xcframework nel progetto.

Passaggio 4: implementa le impostazioni della privacy nell'SDK BidMachine

Per rispettare le Norme relative al consenso degli utenti dell'UE di Google, devi fornire determinate informative ai tuoi utenti nello Spazio economico europeo (SEE), nel Regno Unito e in Svizzera e ottenere il loro consenso all'utilizzo di cookie o di altro spazio di archiviazione locale ove richiesto dalla legge e alla raccolta, alla condivisione e all'utilizzo dei dati personali per la personalizzazione degli annunci. Queste norme riflettono i requisiti della direttiva e-Privacy e del Regolamento generale sulla protezione dei dati (GDPR) dell'UE. Sei responsabile della verifica della propagazione del consenso a ogni origine annuncio nella tua catena di mediazione.

BidMachine legge automaticamente il consenso GDPR impostato dalle piattaforme di gestione del consenso, incluso l'SDK UMP. Per saperne di più, consulta GDPR.

Leggi statali sulla privacy degli Stati Uniti

Le leggi statali sulla privacy degli Stati Uniti richiedono di garantire agli utenti la possibilità di opporsi alla "vendita" delle proprie "informazioni personali" (da intendersi secondo la definizione di tale normativa), mediante un link ben visibile e recante la dicitura "Non vendere i miei dati personali" 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 tua catena di mediazione. Pertanto, devi identificare ogni rete pubblicitaria nella tua catena di mediazione che potrebbe partecipare alla vendita di informazioni personali e seguire le indicazioni di ciascuna di queste reti per garantire la conformità.

BidMachine legge automaticamente il consenso GPP impostato dalle piattaforme di gestione del consenso, incluso l'SDK UMP. Per saperne di più, consulta la sezione GPP.

Passaggio 5: aggiungi il codice richiesto

Implementare SKAdNetwork

Segui la documentazione di BidMachine per aggiungere gli identificatori SKAdNetwork al file Info.plist del tuo progetto.

Passaggio 6: testa l'implementazione

Attiva gli annunci di prova

Assicurati di registrare il dispositivo di test per Ad Manager.

Segui le istruzioni riportate nella documentazione di BidMachine per iOS per attivare la modalità di test per BidMachine.

Importante: disattiva la modalità di test per Ad Manager e BidMachine prima di rilasciare l'app.

Verificare gli annunci di test

Per verificare di ricevere annunci di test da BidMachine, attiva i test di singole origini annuncio nello strumento di controllo degli annunci utilizzando le origini annuncio BidMachine (asta).

Passaggi facoltativi

Annunci nativi

Rendering degli annunci

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

Campo	Asset sempre inclusi dall'adattatore BidMachine
Titolo
Immagine
Corpo
Icona
Call to action
Valutazione a stelle
Negozio
Prezzo
Inserzionista

Codici di errore

Se l'adattatore non riesce a ricevere un annuncio da BidMachine, puoi controllare l'errore sottostante dalla risposta all'annuncio utilizzando GADResponseInfo.adNetworkInfoArray nelle seguenti classi:

GADMediationAdapterBidMachine

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

Codice di errore	Dominio	Motivo
101	com.google.mediation.bidmachine	La configurazione del server non include un ID publisher obbligatorio.
102	com.google.mediation.bidmachine	La richiesta di raccolta degli indicatori di offerta non è andata a buon fine perché i parametri RTB non contengono il formato dell'annuncio o il formato specificato non è supportato.
103	com.google.mediation.bidmachine	Configurazione dell'annuncio non valida per il caricamento di un annuncio.
104	com.google.mediation.bidmachine	L'SDK BidMachine ha restituito un annuncio non banner al metodo delegato BidMachineAdProtocol didLoadAd dell'annuncio banner. Non dovrebbe mai accadere.
105	com.google.mediation.bidmachine	L'annuncio a schermo intero non è pronto per la presentazione.
106	com.google.mediation.bidmachine	L'SDK Bid Machine ha restituito un annuncio non nativo al metodo delegato BidMachineAdProtocol didLoadAd dell'annuncio nativo. Non dovrebbe mai accadere.
107	com.google.mediation.bidmachine	Impossibile caricare una delle origini delle immagini degli annunci nativi.
108	com.google.mediation.bidmachine	BidMachine non supporta questa dimensione dell'annuncio banner.

Log delle modifiche dell'adattatore di mediazione BidMachine per iOS

Versione 3.8.2.0 (in corso)

Versione 3.8.1.0

• È stata verificata la compatibilità con la versione 3.8.1 dell'SDK BidMachine.

Creata e testata con:

• SDK Google Mobile Ads versione 13.10.0.
• Versione 3.8.1 dell'SDK BidMachine.

Versione 3.8.0.0

• Compatibilità verificata con la versione 3.8.0 dell'SDK BidMachine.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.9.0.
• Versione 3.8.0 dell'SDK BidMachine.

Versione 3.7.1.1

• La versione minima dell'SDK Google Mobile Ads per iOS è stata aggiornata alla 13.3 per consentire l'utilizzo di versioni secondarie.
• Aggiornamento per trasmettere l'ID posizionamento all'SDK BidMachine durante la raccolta degli indicatori e il caricamento degli annunci.

Creata e testata con:

• SDK Google Mobile Ads versione 13.8.0.
• SDK BidMachine versione 3.7.1.

Versione 3.7.1.0

• È stata verificata la compatibilità con la versione 3.7.1 dell'SDK BidMachine.
• Richieste di annunci banner con offerta fissa che non trasmettono correttamente le dimensioni dell'annuncio.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.4.0.
• Versione 3.7.1 dell'SDK BidMachine.

Versione 3.7.0.0

• Compatibilità verificata con l'SDK BidMachine versione 3.7.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.4.0.
• SDK BidMachine versione 3.7.0.

Versione 3.6.1.1

• L'adattatore ora inoltra il flag dell'SDK Google Mobile Ads ageRestrictedTreatment all'API COPPA dell'SDK BidMachine.
• Esegui l'upgrade dell'adattatore BidMachine e dei test delle unità a Swift 6.

Creata e testata con:

• SDK Google Mobile Ads versione 13.3.0.
• SDK BidMachine versione 3.6.1.

Versione 3.6.1.0

• Compatibilità verificata con l'SDK BidMachine versione 3.6.1.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.2.0.
• Versione 3.6.1 dell'SDK BidMachine.

Versione 3.6.0.0

• Compatibilità verificata con la versione 3.6.0 dell'SDK BidMachine.
• Rifattorizzato il caricamento degli annunci banner BidMachine e la gestione delle immagini degli annunci nativi.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.1.0.
• SDK BidMachine versione 3.6.0.

Versione 3.5.1.2

• È stata aggiornata la dipendenza dell'SDK Google Mobile Ads alla versione 13.0.0.

Creata e testata con:

• SDK Google Mobile Ads versione 13.0.0.
• Versione 3.5.1 dell'SDK BidMachine.

Versione 3.5.1.1

• È stata aggiornata la versione minima di iOS di CocoaPods a 13.0.
• È stato aggiunto il supporto per l'inoltro del parametro dell'SDK Google Mobile Ads tagForUnderAgeOfConsent all'SDK BidMachine.
• Modificate le sezioni di conformità BidMachineAdDelegate per allinearle al comportamento di callback dell'SDK BidMachine.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 13.0.0.
• SDK BidMachine versione 3.5.1.

Versione 3.5.1.0

• Compatibilità verificata con l'SDK BidMachine versione 3.5.1.

Creata e testata con:

• SDK Google Mobile Ads versione 12.14.0.
• SDK BidMachine versione 3.5.1.

Versione 3.5.0.0

• Compatibilità verificata con l'SDK BidMachine versione 3.5.0.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.12.0.
• SDK BidMachine versione 3.5.0.

Versione 3.4.0.2

• Aggiunto il supporto della struttura a cascata per i formati degli annunci banner, interstitial, con premio e nativi.
• È stata rimossa la proprietà statica isTestMode da BidMachineAdapterExtras.
• È stata aggiunta la convalida delle dimensioni degli annunci banner per gli annunci banner con struttura a cascata.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.12.0.
• SDK BidMachine versione 3.4.0.

Versione 3.4.0.1

• La modalità di test è ora disponibile in Objective-C tramite la proprietà GADMediationAdapterBidMachineExtras.isTestMode.

Creata e testata con:

• SDK Google Mobile Ads versione 12.0.0.
• SDK BidMachine versione 3.4.0.

Versione 3.4.0.0

• Release iniziale.
• È stato aggiunto il supporto delle offerte per i formati degli annunci banner, interstitial, con premio e nativi.
• Compatibilità verificata con la versione 3.4.0 dell'SDK BidMachine.

Sviluppato e testato con:

• SDK Google Mobile Ads versione 12.8.0.
• SDK BidMachine versione 3.4.0.