Guida all'implementazione lato server

Questa funzione è disponibile solo per le reti che hanno un gestore di Account Google dedicato e potrebbe non essere attiva per la tua rete. Per ulteriori informazioni, contatta il tuo account manager. Se non hai un gestore dell'account significa che la tua rete non è idonea per questa funzione.

Potresti aver bisogno di inviare richieste di annuncio ad Ad Manager da server proprietari o di terze parti, strumenti di stitching di annunci dinamici o fornitori di inserzioni lato server. Completa quanto segue per inviare richieste di annuncio lato server ad Ad Manager e generare report accurati su impressioni, clic e conversioni attribuite.

1. Condividere le istruzioni di integrazione con il partner tecnologico lato server

Affinché Ad Manager possa autenticare le chiamate lato server da server di terze parti (ad esempio, fornitori di inserimento di annunci dinamici o strumenti di stitching lato server), è necessario che si colleghino ai server Ad Manager utilizzando un certificato SSL emesso da Ad Manager.

Chiedi al tuo partner tecnologico lato server di completare i passaggi dettagliati in questa pagina.

Campaign Manager 360 con richieste di annuncio lato server richiede inoltre l'installazione di un certificato SSL. Il tuo partner tecnologico lato server deve seguire le istruzioni di integrazione di Campaign Manager 360 qualora vengano richieste creatività video tramite le chiamate lato server.

2. Generare un tag annuncio lato server

I publisher che sfruttano i server di terze parti per inviare richieste di annuncio ad Ad Manager sono responsabili per la generazione di un tag video in uno dei seguenti modi:

Nell'interfaccia di Ad Manager

Scopri come generare un tag video da Ad Manager 

Creare manualmente l'URL del tag annuncio video

Scopri i parametri URL supportati sui tag annuncio video VAST obbligatori e facoltativi e i requisiti aggiuntivi per la registrazione di visualizzazioni, conversioni e clic.

Gli URL dei tag annuncio lato server che fanno riferimento a /gampad/ads o /gampad/live/ads devono utilizzare serverside.doubleclick.net (anziché pubads.g.doubleclick.net). Per soddisfare questo requisito, potrebbe essere necessario modificare manualmente gli URL dei tag annuncio.

3. Generare una richiesta di annuncio lato server

Dopo aver generato il tag annuncio, il partner tecnologico responsabile dell'invio della richiesta di annuncio lato server ad Ad Manager deve:

• Trasmettere l'origine di stitching lato server sotto forma di valore del parametro ssss nella richiesta di Ad Manager.

  Il valore del parametro ssss è sensibile alle maiuscole. Se al publisher viene assegnato il valore di examplesource, è corretto trasmettere ssss=examplesource, mentre non lo è trasmettere ssss=ExampleSource.
  I fornitori di tecnologia di stitching video che utilizzano le integrazioni server-server con Google ricevono questo valore da Google e sono in grado di fornirlo a te. Per eventuali domande sul valore da impostare per questo parametro, puoi contattare il tuo account manager Google.

• Trasmettere dinamicamente l'indirizzo IP del dispositivo client tramite l'intestazione X-Forwarded-For oppure come valore del parametro ip nella richiesta di Ad Manager. Trasmetti il valore utilizzando uno solo di questi metodi, non entrambi.

  Se non viene trasmesso correttamente l'indirizzo IP completo del dispositivo client con uno di questi due metodi, potrebbero verificarsi problemi di pubblicazione degli annunci.

• Trasmettere le intestazioni HTTP complete dall'ambiente/dal dispositivo client, tra cui:

  • User-Agent: questa dovrebbe essere la stringa completa, non modificata, riportata nel browser dell'utente.  Per gli annunci mobile visualizzati in WebView o browser mobile nativi, deve essere trasmesso lo user agent utilizzato dalla piattaforma mobile per WebView o dal browser (ad esempio, lo user agent Safari per dispositivi mobili per iOS). Se gli annunci vengono visualizzati nell'app mobile nativa, lo user agent deve seguire le linee guida per le app mobile.

    Le stringhe dello user agent generate dalle classi di connessione URL della piattaforma per il mobile (ad esempio, "Dalvik" su Android o "CFNetwork" su iOS) non sono valide.

  • Accept-Encoding: questo valore dovrebbe essere impostato su gzip,deflate affinché Ad Manager possa comprimere le risposte. Questa operazione è obbligatoria perché le risposte non compresse sono 20 volte più grandi.

L'unica intestazione che non deve essere inoltrata nella richiesta di annuncio lato server è l'intestazione cookie.

Ulteriori requisiti per la registrazione di visualizzazione, conversioni e clic

Ti consigliamo vivamente di inviare tutte le visualizzazioni e conversioni dal client anziché dal server. I publisher dovrebbero inviare impressioni e ping di conversione dal client. In casi limitati, ai publisher potrebbe essere data la possibilità di registrare visualizzazioni, conversioni e clic dal server.

Se la configurazione tecnica richiede l'invio di visualizzazioni, conversioni e clic dal server, devi includere ipe=ssb nelle richieste di annuncio iniziali inviate dall'ambiente lato server.

Altre best practice consigliate per assicurarsi che Ad Manager sia in grado di elaborare richieste di annuncio e conversioni dalle implementazioni lato server misurate:

• Invia tutti gli eventi di visualizzazione, conversione e clic nell'ordine in cui si sono verificati. Ad esempio, non inviare l'evento di clic prima dell'evento di impressione in quanto non è possibile che un utente abbia fatto clic su un evento prima dell'attivazione di un'impressione e della visualizzazione dell'annuncio.
• Non inviare gli eventi in gruppo. Piuttosto, invia gli eventi nel momento in cui vengono registrati.

Questo traffico è valido solo per le domande di prenotazione e non sarà accreditato MRC, a meno che non sia specificato diversamente nelle condizioni di un contratto per la versione beta.