Guide d'implémentation côté serveur

Cette fonctionnalité n'est disponible que pour les réseaux qui disposent d'un responsable de compte Google dédié. Il est possible qu'elle ne soit pas activée pour votre réseau. Pour en savoir plus, contactez votre responsable de compte. Si vous n'avez pas de responsable de compte, cette fonctionnalité n'est pas disponible pour votre réseau.

Il se peut que vous ayez besoin d'envoyer des demandes d'annonces à Google Ad Manager depuis des serveurs propriétaires ou tiers, des assembleurs d'annonces dynamiques ou des fournisseurs d'insertion côté serveur. Procédez comme suit pour envoyer des demandes d'annonces côté serveur à Google Ad Manager et générer des rapports précis sur les impressions, les clics et les conversions attribuées.

1. Communiquer les instructions concernant les intégrations au partenaire technologique côté serveur

Pour que Google Ad Manager puisse authentifier des appels côté serveur provenant de serveurs tiers (par exemple, des fournisseurs d'insertion dynamique d'annonces ou des assembleurs côté serveur), ils doivent se connecter aux serveurs Google Ad Manager à l'aide d'un certificat SSL émis par Google Ad Manager.

Demandez à votre partenaire technologique côté serveur de suivre la procédure détaillée sur cette page.

Si vous utilisez des demandes d'annonces côté serveur avec Campaign Manager 360, vous devez également installer un certificat SSL. Votre partenaire technologique côté serveur doit suivre les Instructions d'intégration de Campaign Manager 360 si les créations vidéo sont demandées via des appels côté serveur.

2. Générer un tag d'emplacement publicitaire côté serveur

Les éditeurs qui utilisent des serveurs tiers pour envoyer des demandes d'annonces à Google Ad Manager doivent générer un tag vidéo de l'une des deux manières suivantes :

Dans l'interface Google Ad Manager

Découvrez comment générer un tag vidéo dans Ad Manager. 

Générer manuellement l'URL du tag publicitaire vidéo

Découvrez les paramètres d'URL obligatoires et facultatifs compatibles avec les tags publicitaires vidéo VAST ainsi que les exigences supplémentaires pour enregistrer des vues, des conversions et des clics.

Les URL de tag d'emplacement publicitaire côté serveur qui font référence à /gampad/ads ou /gampad/live/ads doivent utiliser serverside.doubleclick.net (au lieu de pubads.g.doubleclick.net. Pour respecter cette exigence, vous devrez peut-être modifier manuellement les URL de tag d'emplacement publicitaire.

3. Générer une demande d'annonce côté serveur

Une fois le tag d'emplacement publicitaire généré, le partenaire technologique responsable de l'envoi de la demande d'annonce côté serveur à Google Ad Manager doit :

• Transmettre la source d'assemblage côté serveur en tant que valeur du paramètre ssss dans la demande Google Ad Manager.

  La valeur du paramètre ssss est sensible à la casse. Si la valeur examplesource est attribuée à l'éditeur, transmettre ssss=examplesource est correct, alors que ssss=ExampleSource ne l'est pas.
  Google attribue cette valeur aux fournisseurs de technologie d'assemblage vidéo qui utilisent des intégrations de serveur à serveur avec Google, et ils peuvent vous la fournir. Si vous avez des questions sur la valeur à définir pour ce paramètre, vous pouvez contacter votre responsable de compte Google.

• Transmettre dynamiquement l'adresse IP de l'appareil client soit à l'aide de l'en-tête X-Forwarded-For, soit sous la forme d'une valeur du paramètre ip dans la demande Ad Manager. La valeur ne doit être transmise qu'avec l'une de ces méthodes, et non les deux.

  Si vous ne parvenez pas à transmettre correctement l'adresse IP complète de l'appareil client avec l'une de ces deux méthodes, la diffusion des annonces risque d'être perturbée.

• Transmettre les en-têtes HTTP complets de l'environnement/appareil client, y compris :

  • User-Agent : cet en-tête doit correspondre à la chaîne complète et non modifiée communiquée par le navigateur de l'utilisateur.  Pour les annonces pour mobile dans des affichages WebView ou des navigateurs mobiles natifs, le user-agent utilisé par la plate-forme mobile pour les affichages WebView ou le navigateur (par exemple, le user-agent de Safari pour mobile dans le cas d'iOS) doit être transmis. Si les annonces sont affichées dans l'application mobile native, le user-agent doit respecter les consignes relatives aux applications mobiles.

    Les chaînes user-agent générées par les catégories de connexion d'URL de la plate-forme mobile (par exemple, "Dalvik" sur Android ou "CFNetwork" sur iOS) ne sont pas valides.

  • Accept-Encoding : cet en-tête doit être défini sur gzip,deflate pour qu'Ad Manager puisse compresser les réponses. Il s'agit d'une exigence, car les réponses non compressées sont 20 fois plus volumineuses.

Le seul en-tête qui ne doit pas être transféré dans la demande d'annonce côté serveur est l'en-tête de cookie.

Exigences supplémentaires pour enregistrer des vues, des conversions et des clics

Nous recommandons vivement d'envoyer toutes les vues et conversions depuis le client plutôt que depuis le serveur. Les éditeurs doivent envoyer les impressions et les pings de conversion depuis le client. Dans certains cas, il est possible d'offrir aux éditeurs la possibilité d'enregistrer des vues, des conversions et des clics depuis le serveur.

Si votre configuration technique nécessite que vous envoyiez les vues, les conversions et les clics depuis le serveur, vous devez inclure ipe=ssb dans les demandes d'annonces initiales envoyées depuis l'environnement côté serveur.

Autres bonnes pratiques recommandées pour s'assurer qu'Ad Manager est en mesure de traiter les demandes d'annonces et les conversions à partir des implémentations mesurées côté serveur :

• Envoyez tous les événements de vue, de conversion et de clic dans l'ordre dans lequel ils ont eu lieu. Par exemple, n'envoyez pas d'événement de clic avant l'événement d'impression, car un utilisateur ne peut pas déclencher un événement de clic avant l'enregistrement de l'impression et l'affichage de l'annonce.
• N'envoyez pas les événements de manière groupée. Envoyez-les au moment où ils sont enregistrés.

Ce trafic n'est valide que pour une demande de réservation. Il ne sera pas accrédité par le MRC, sauf spécification contraire dans les termes d'un contrat concernant une version bêta.