Le terze parti non sono utenti diretti di Ad Manager, in quanto potrebbero non avere una propria rete Ad Manager. Creano invece servizi o integrazioni con Ad Manager per i propri clienti, che sono clienti di Ad Manager. Questa guida illustra le nozioni di base delle integrazioni di terze parti fornendo best practice, suggerimenti e trucchi.
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 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 è necessaria 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 nelle reti di produzione dei tuoi clienti. L'approccio consigliato è creare una rete di test. Non devi essere un cliente Ad Manager per farlo. Chiunque abbia un Account Google può creare una rete di test.
Tieni presente, tuttavia, le differenze tra le reti di test e di produzione. Le reti di test non possono pubblicare annunci. Inoltre, le reti di test non contengono necessariamente tutte le funzionalità che i tuoi clienti potrebbero avere a disposizione sulle loro reti di produzione. Se devi eseguire test sulle funzionalità di Ad Manager che non sono disponibili nella tua rete di test, un'opzione è acquistare l'accesso a una rete non di test tramite un rivenditore Ad Manager.
Inoltre, devi indicare chiaramente ai tuoi clienti quali funzionalità devono essere disponibili 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 gestendole in modo appropriato o mantenendo un elenco dei tuoi clienti e delle funzionalità che ciascuno ha o non ha. È responsabilità del tuo cliente collaborare con il suo contatto Google per gestire le funzionalità della 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 flusso di lavoro di autenticazione in modo sicuro.
Questa operazione prevede due passaggi:
- Crea un indirizzo email dell'Account Google che utilizzerai per accedere alla rete del cliente.
- 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 oppure un account principale da utilizzare per tutti i clienti. La prima opzione è più sicura nel caso in cui uno dei tuoi account venga compromesso. Ciò significa che devi eseguire il passaggio 1 una sola volta.
Indipendentemente da ciò che fai nel passaggio 1, nel passaggio 2 devi 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 account di servizio OAuth2, che genera un indirizzo email dell'account di servizio 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, ci riferiremo a entrambi come a un 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.
Se fornisci loro un indirizzo email del service account OAuth2, chiedi loro di aggiungerlo alla loro rete.
Se fornisci loro un Account Google normale, chiedi di aggiungere il tuo account come utente alla loro rete.
Indipendentemente dal percorso che scegli, 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 cliente per cui stai effettuando la chiamata API. Tutte le nostre librerie client consentono di impostare questo valore in modo programmatico. Ad esempio, nella libreria client Java per gli annunci, puoi impostare il codice di rete in modo programmatico durante la creazione di un'istanza DfpSession.
Tieniti aggiornato sull'API
È importante rimanere aggiornato sulle versioni dell'API ritirate o in fase di ritiro e sulle date di rilascio delle nuove versioni. Non vuoi essere colto di sorpresa quando una versione viene ritirata e rischiare di interrompere il funzionamento dei tuoi client. Non sempre siamo in grado di contattare terze parti in merito a ritiri e chiusure imminenti come facciamo per i nostri clienti. Pertanto, è tua responsabilità iscriverti a uno dei nostri tre canali principali per gli aggiornamenti delle API e regolare le impostazioni di notifica:
- Il nostro gruppo Annunci di ritiro dell'API Ad Manager.
- Il nostro blog per sviluppatori di Google Ads.
Forniamo anche un programma di ritiro sul nostro sito per sviluppatori, che ti consigliamo di monitorare regolarmente.