Intégrer Google Ad Manager en tant que tiers

Les tiers ne sont pas des utilisateurs directs d'Ad Manager, car ils ne disposent peut-être pas de leur propre réseau Ad Manager. Au lieu de cela, ils créent des services ou des intégrations avec Ad Manager pour leurs clients, qui sont des clients Ad Manager. Ce guide présente les principes de base des intégrations tierces en vous proposant des bonnes pratiques, des conseils et des astuces.

Ce guide suppose que vous maîtrisez l'API Ad Manager. Si vous ne connaissez pas l'API Ad Manager, consultez notre documentation de démarrage.

Premiers pas en tant que tiers

Pour utiliser l'API Ad Manager afin d'accéder au réseau d'un client Ad Manager, il vous suffit de suivre les consignes ci-dessous. Aucune approbation supplémentaire de Google n'est requise. Notez toutefois qu'en accédant à l'API Ad Manager et/ou en l'utilisant, vous acceptez les Conditions d'utilisation de l'API Ad Manager.

Tester l'intégration d'Ad Manager en tant que tiers

En tant que tiers, vous vous demandez peut-être comment tester l'intégration d'Ad Manager avant de l'exécuter sur les réseaux de production de vos clients. L'approche recommandée consiste à créer un réseau de test. Vous n'avez pas besoin d'être client Ad Manager pour effectuer cette opération. Toute personne disposant d'un compte Google peut créer un réseau de test.

Notez toutefois les différences entre les réseaux de test et de production. Les réseaux de test ne peuvent pas diffuser d'annonces. Les réseaux de test ne contiendront pas nécessairement toutes les fonctionnalités que vos clients peuvent avoir sur leurs réseaux de production. Si vous devez tester des fonctionnalités Ad Manager qui ne sont pas disponibles sur votre réseau de test, vous pouvez acheter l'accès à un réseau non testé auprès d'un revendeur Ad Manager.

En outre, vous devez indiquer clairement à vos clients les fonctionnalités dont ils ont besoin sur leur réseau de production pour que votre application fonctionne correctement. Pour que votre application puisse gérer les cas où il est possible que certaines fonctionnalités n'existent pas, il peut s'agir d'intercepter les exceptions et d'échouer correctement, ou de conserver une liste de vos clients avec les fonctionnalités disponibles ou non. Il appartient à votre client de collaborer avec son contact Google pour gérer les fonctionnalités de son réseau.

Authentification: comment accéder correctement au réseau Ad Manager d'un client.

Pour que votre application puisse accéder au réseau Ad Manager de votre client, vous devez configurer votre workflow d'authentification de manière sécurisée.

Cela implique deux étapes:

  1. Créez une adresse e-mail de compte Google que vous utiliserez pour accéder au réseau de votre client.
  2. Demandez au client d'ajouter ce compte à son réseau Ad Manager en tant qu'utilisateur.

À l'étape 1, vous pouvez créer un compte Google distinct pour chaque client ou un compte principal que vous utiliserez pour tous les clients. La première option est plus sécurisée si l'un de vos comptes est piraté. Dans le second cas, vous n'avez besoin d'effectuer l'étape 1 qu'une seule fois.

Quoi que vous fassiez à l'étape 1, vous devrez demander à chaque nouveau client d'ajouter à son réseau Ad Manager le compte Google approprié que vous avez créé pour lui en tant qu'utilisateur.

1. Créer un compte Google

Il existe plusieurs façons de créer un compte Google pouvant être ajouté à un réseau Ad Manager.

  • Option 1: créez un compte de service OAuth2, qui génère pour vous une adresse e-mail de compte de service faisant office de compte Google. Instructions pour créer un compte de service

  • Option 2: vous pouvez créer un compte Google standard (compte Gmail) en vous inscrivant en tant que nouvel utilisateur. Si vous avez déjà un compte Google, effectuez cette inscription dans une fenêtre de navigation privée ou dans une nouvelle session de navigateur. Si votre entreprise utilise Google Workspace, vous pouvez également créer un compte Google dans son domaine et l'utiliser à la place. Pour les besoins de ce guide, nous désignons ces deux comptes par le terme "compte Google standard".

2. Demandez au client d'ajouter votre compte Google à son réseau

Une fois que vous avez obtenu un compte Google pour accéder au réseau de votre client, demandez-lui de l'ajouter en tant que nouvel utilisateur dans son réseau Ad Manager.

  • Si vous fournissez l'adresse e-mail d'un compte de service OAuth2, demandez-lui de l'ajouter à son réseau.

  • Si vous leur fournissez un compte Google standard, demandez-leur d'ajouter votre compte à leur réseau en tant qu'utilisateur.

Quelle que soit la voie que vous empruntez, veillez à discuter avec votre client des rôles et autorisations dont votre compte doit disposer pour que votre application puisse accéder aux données dont elle a besoin sur le réseau de votre client.

Vous pouvez maintenant commencer à effectuer des appels d'API sur le réseau Ad Manager de votre client. Assurez-vous de définir l'en-tête SOAP NetworkCode sur le code réseau du client à partir duquel vous effectuez l'appel d'API. Toutes nos bibliothèques clientes permettent de définir ce paramètre de manière automatisée. Par exemple, dans la bibliothèque cliente Java pour les annonces, vous pouvez définir de manière programmatique le code du réseau lorsque vous créez une instance DfpSession.

Se tenir informé des nouveautés concernant l'API

Il est important que vous sachiez quelles versions de l'API sont obsolètes ou arrêtées, et quand de nouvelles versions sont publiées. Pour éviter d'être pris au dépourvu lorsqu'une version est arrêtée, vous risquez de ne plus perturber vos clients. Comme c'est le cas pour nos clients, nous ne sommes pas toujours en mesure de contacter des tiers au sujet des abandons et des abandons imminents. Vous êtes donc tenu de vous abonner à l'un de nos trois principaux canaux pour les mises à jour de l'API et de modifier vos paramètres de notification:

Nous proposons également un calendrier d'abandon sur le site de notre développeur que vous devez surveiller régulièrement.

Assistance

Si vous rencontrez des problèmes avec l'intégration d'Ad Manager, nous proposons les canaux d'assistance suivants en fonction de votre problème. Pour toute question au niveau d'un produit, veuillez écrire sur les forums dédiés aux produits Ad Manager. Pour toute question spécifique à l'API, veuillez consulter les forums concernant l'API Ad Manager. Veuillez consulter cet article de blog pour savoir comment déterminer s'il s'agit d'une question au niveau du produit ou d'une question spécifique à l'API.