Les tiers ne sont pas des utilisateurs directs d'Ad Manager, car ils ne disposent pas forcément 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 aborde les bases des intégrations tierces en fournissant 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, suivez simplement les consignes ci-dessous. Aucune approbation supplémentaire de Google n'est requise. Toutefois, notez 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 votre intégration Ad Manager en tant que tiers
En tant que tiers, vous vous demandez peut-être comment tester votre intégration 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 ce faire. 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. De plus, les réseaux de test ne contiennent pas nécessairement toutes les fonctionnalités dont vos clients peuvent disposer sur leurs réseaux de production. Si vous devez effectuer des tests sur 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 autre que celui de test auprès d'un revendeur Ad Manager.
De plus, 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. Votre application doit gérer les cas où des fonctionnalités peuvent ne pas exister, soit en détectant les exceptions et en échouant de manière élégante, soit en conservant une liste de vos clients et des fonctionnalités dont chacun dispose ou non. Il incombe à votre client de contacter son représentant Google pour gérer les fonctionnalités de son réseau.
Authentification : 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.
Pour ce faire, procédez comme suit :
- Créez une adresse e-mail de compte Google que vous utiliserez pour accéder au réseau de votre client.
- Demandez au client d'ajouter ce compte en tant qu'utilisateur à son réseau Ad Manager.
Pour 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 en cas de piratage de l'un de vos comptes. Dans ce cas, vous n'avez besoin d'effectuer l'étape 1 qu'une seule fois.
Quelle que soit la méthode choisie à l'étape 1, vous devrez demander à chaque nouveau client d'ajouter le compte Google approprié que vous avez créé pour lui en tant qu'utilisateur à son réseau Ad Manager.
1. Créer un compte Google
Il existe différentes 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 une adresse e-mail de compte de service pour vous, qui fait 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 possédez déjà un compte Google, effectuez cette inscription dans une fenêtre de navigation privée ou une nouvelle session de navigateur. Si votre entreprise utilise Google Workspace, vous pouvez également créer un compte Google dans le domaine de votre entreprise et l'utiliser à la place. Dans ce guide, nous les désignerons toutes les deux par l'expression "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 d'ajouter le compte en tant que nouvel utilisateur dans son réseau Ad Manager.
Si vous lui fournissez une adresse e-mail de compte de service OAuth2, demandez-lui de l'ajouter à son réseau.
Si vous lui fournissez un compte Google standard, demandez-lui d'ajouter votre compte en tant qu'utilisateur à son réseau.
Quelle que soit la méthode choisie, assurez-vous de discuter avec votre client des rôles et autorisations que votre compte doit avoir 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 à appeler l'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 pour lequel vous effectuez l'appel d'API. Toutes nos bibliothèques clientes permettent de définir ce paramètre de manière programmatique. Par exemple, dans la bibliothèque cliente Java Ads, vous pouvez définir le code réseau de manière programmatique lorsque vous créez une instance DfpSession.
Se tenir informé des nouveautés de l'API
Il est important de vous tenir informé des versions d'API obsolètes ou abandonnées, et de la date de sortie des nouvelles versions. Vous ne voulez pas être pris au dépourvu lorsqu'une version est abandonnée et risquer de casser vos clients. Nous ne sommes pas toujours en mesure de contacter les tiers au sujet des futures abandons et arrêts comme nous le faisons pour nos clients. Il vous incombe donc de vous abonner à l'un de nos trois principaux canaux d'informations sur les mises à jour de l'API et de modifier vos paramètres de notification :
Nous fournissons également un calendrier d'obsolescence sur notre site pour les développeurs, que vous devez consulter régulièrement.