Le terze parti non sono utenti diretti di Ad Manager, in quanto potrebbero non avere la 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 sulle integrazioni di terze parti e fornisce 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 documentazione per iniziare.
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 un'ulteriore approvazione da parte di Google, ma tieni presente che accedendo e/o utilizzando l'API Ad Manager, accetti i termini e le 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. Per farlo, non è necessario essere un cliente Ad Manager. Chiunque abbia un Account Google può creare una rete di prova.
Tuttavia, tieni presente le differenze tra reti di test e reti 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 sulle loro reti di produzione. Se devi eseguire un test sulle funzionalità di Ad Manager che non sono disponibili nella tua rete di test, puoi acquistare l'accesso a una rete non di prova tramite un rivenditore Ad Manager.
Inoltre, dovresti chiarire con i tuoi clienti quali funzionalità devono avere a disposizione sulla loro rete di produzione affinché la tua applicazione funzioni correttamente. L'applicazione deve gestire i casi in cui le funzionalità potrebbero non esistere rilevando le eccezioni e non funzionando correttamente o mantenendo un elenco dei client e delle funzionalità di ciascuno. Il cliente dovrebbe avere la responsabilità di collaborare con il proprio contatto di Google per gestire le funzionalità della rete.
Autenticazione: come accedere correttamente alla rete Ad Manager di un cliente
Affinché l'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 l'indirizzo email di un Account Google da utilizzare per accedere alla rete del tuo cliente.
- Chiedi al cliente di aggiungere questo account come utente alla propria rete Ad Manager.
Per il passaggio 1, puoi creare un Account Google separato per ogni cliente o uno principale che utilizzerai per tutti i clienti. La prima opzione è più sicura nel caso in cui uno dei tuoi account sia compromesso. La seconda significa che il passaggio 1 deve essere eseguito una sola volta.
Indipendentemente dalle azioni eseguite nel passaggio 1, nel passaggio 2 dovrai chiedere a ogni nuovo cliente di aggiungere l'Account Google appropriato che hai creato come utente alla propria rete Ad Manager.
1. Creazione di un Account Google
Esistono diversi modi per creare un Account Google da aggiungere a una rete Ad Manager.
Opzione 1: crea un account di servizio OAuth2, che genera per te un indirizzo email di account di servizio che funge da Account Google. Istruzioni per la creazione di un nuovo account di servizio.
Opzione 2: puoi creare un normale Account Google (account "Gmail") registrandoti come nuovo utente. Se hai già un Account Google, completa questa registrazione in una finestra di navigazione in incognito o in una nuova sessione del browser. In alternativa, se la tua azienda usa Google Workspace, puoi creare un Account Google nel dominio aziendale e utilizzarlo. Nell'ambito di questa guida, chiameremo entrambi account Google "normali".
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 l'indirizzo email di un account di servizio OAuth2, chiedi loro di aggiungerlo alla propria rete.
Se fornisci loro un normale Account Google, chiedi all'utente di aggiungere il tuo account come utente alla propria rete.
Indipendentemente dal percorso che adotti, accertati di discutere con il cliente dei ruoli e delle autorizzazioni che deve avere il tuo account in modo che l'applicazione possa accedere ai dati necessari sulla rete del client.
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 su cui stai eseguendo la chiamata API. Tutte le nostre librerie client consentono di impostare questa opzione in modo programmatico. Ad esempio, nella libreria client Java di Google Ads, puoi impostare in modo programmatico il codice di rete quando crei un'istanza DfpSession.
Mantenersi aggiornati con l'API
È importante che tu sia sempre al corrente delle versioni deprecate o del ritiro delle API e del rilascio di nuove versioni. È meglio non farsi cogliere impreparati quando una versione viene dismessa e rischia di danneggiare i client. Non siamo sempre in grado di contattare terze parti in merito a ritiri e ritiri imminenti, come facciamo per i nostri clienti. Pertanto, è tua responsabilità iscriverti a uno dei nostri tre canali principali per gli aggiornamenti dell'API e modificare le tue impostazioni di notifica:
- Il nostro gruppo di annunci sui cessioni dell'API Ad Manager.
- Il nostro blog per gli sviluppatori di annunci.
Sul sito del nostro sviluppatore forniamo anche una pianificazione del ritiro che dovresti monitorare regolarmente.
Richiedere assistenza
In caso di problemi con l'integrazione di Ad Manager, offriamo i seguenti canali di assistenza a seconda del problema. In caso di domande a livello di prodotto, scrivi ai forum del prodotto Ad Manager. In caso di domande specifiche sull'API, scrivi ai forum dell'API di Ad Manager. Consulta questo post del blog per suggerimenti su come capire se si tratta di una domanda a livello di prodotto o di una domanda specifica per l'API.