Integrazione con Google Ad Manager come terza parte

Le terze parti non sono utenti diretti di Ad Manager, in quanto potrebbero non avere una propria rete Ad Manager. Invece, creano servizi o integrazioni con Ad Manager per i loro clienti, che sono clienti di Ad Manager. Questa guida illustra le nozioni di base delle integrazioni di terze parti fornendo best practice e suggerimenti utili.

Questa guida presuppone che tu abbia una conoscenza pratica dell'API Ad Manager. Se non hai dimestichezza con l'API Ad Manager, consulta la nostra documentazione introduttiva.

Iniziare a utilizzare Google Ads come terza parte

Per utilizzare l'API Ad Manager per accedere alla rete di un cliente Ad Manager, segui le linee guida riportate di seguito. Non è richiesta alcuna approvazione aggiuntiva da parte di Google, anche se tieni presente che accedendo e/o utilizzando l'API Ad Manager accetti i Termini e condizioni dell'API Ad Manager.

Come testare l'integrazione di Ad Manager come terza parte

In qualità di terza parte, potresti chiederti come testare l'integrazione di Ad Manager prima di eseguirla sulle reti di produzione dei tuoi clienti. L'approccio consigliato è creare una rete di test. Non è necessario essere un cliente Ad Manager per farlo. Chiunque abbia un Account Google può creare una rete di test.

Tuttavia, tieni presente le differenze tra le reti di test e di produzione. Le reti di test non possono pubblicare annunci. Inoltre, le reti di test non conterranno necessariamente tutte le funzionalità che i tuoi clienti potrebbero avere a disposizione nelle loro reti di produzione. Se devi eseguire test con funzionalità di Ad Manager non disponibili nella tua rete di test, un'opzione è acquistare l'accesso a una rete non di test tramite un rivenditore Ad Manager.

Inoltre, devi chiarire ai tuoi clienti quali funzionalità devono avere a disposizione sulla loro rete di produzione affinché la tua applicazione funzioni correttamente. La tua applicazione deve gestire i casi in cui le funzionalità potrebbero non esistere, rilevando le eccezioni e non riuscendo correttamente o mantenendo un elenco dei tuoi client e delle funzionalità di ciascuno. Dovrebbe essere responsabilità del tuo cliente collaborare con il suo contatto Google per gestire le funzionalità sulla sua rete.

Autenticazione: come accedere correttamente alla rete Ad Manager di un cliente

Affinché la tua applicazione possa accedere alla rete Ad Manager del tuo cliente, devi configurare il workflow di autenticazione in modo sicuro.

Ciò comporta due passaggi:

  1. Crea un indirizzo email dell'Account Google che utilizzerai per accedere alla rete del tuo cliente.
  2. Chiedi al cliente di aggiungere questo account come utente alla sua rete Ad Manager.

Per il passaggio 1, puoi creare un Account Google separato per ogni cliente o un account principale da utilizzare per tutti i clienti. La prima opzione è più sicura nel caso in cui uno dei tuoi account venga compromesso. Quest'ultimo significa che devi eseguire il passaggio 1 una sola volta.

Indipendentemente da ciò che fai nel passaggio 1, nel passaggio 2 dovrai chiedere a ogni nuovo cliente di aggiungere l'Account Google appropriato che hai creato per lui come utente alla sua rete Ad Manager.

1. Creazione di un account Google

Esistono vari modi per creare un Account Google che può essere aggiunto a una rete Ad Manager.

  • Opzione 1: crea un service account OAuth2, che genera un indirizzo email del service account che funge da Account Google. Istruzioni per creare un nuovo service account.

  • Opzione 2: puoi creare un normale Account Google (account "Gmail") registrandoti come nuovo utente. Se hai già un Account Google, completa la registrazione in una finestra di navigazione in incognito o in una nuova sessione del browser. In alternativa, se la tua azienda utilizza Google Workspace, puoi creare un Account Google nel dominio della tua azienda e utilizzarlo. Ai fini di questa guida, faremo riferimento a entrambi come Account Google "normale".

2. Chiedi al cliente di aggiungere il tuo Account Google alla sua rete

Dopo aver ottenuto un Account Google per accedere alla rete del cliente, chiedigli di aggiungere l'account come nuovo utente nella sua rete Ad Manager.

Indipendentemente dal percorso scelto, assicurati di discutere con il tuo cliente quali ruoli e autorizzazioni deve avere il tuo account in modo che la tua applicazione possa accedere ai dati di cui ha bisogno sulla rete del tuo cliente.

Ora puoi iniziare a effettuare chiamate API alla rete Ad Manager del tuo cliente. Assicurati di impostare l'intestazione SOAP networkCode sul codice di rete del client per cui stai effettuando la chiamata API. Tutte le nostre librerie client consentono di impostarlo in modo programmatico. Ad esempio, nella libreria client Java di Google Ads, puoi impostare in modo programmatico il codice di rete durante la creazione di un'istanza DfpSession.

Rimani aggiornato sull'API

È importante rimanere aggiornati sulle versioni dell'API ritirate o dismesse e sulle nuove versioni rilasciate. Non farti cogliere alla sprovvista quando una versione viene ritirata, rischiando di compromettere i tuoi client. Non siamo sempre in grado di contattare le terze parti in merito a ritiri e deprecazioni imminenti, come facciamo per i nostri clienti. Pertanto, è tua responsabilità iscriverti a uno dei nostri tre canali principali per gli aggiornamenti delle API e modificare le impostazioni di notifica:

Inoltre, sul nostro sito per sviluppatori forniamo una pianificazione del ritiro che dovresti monitorare regolarmente.