Types de comptes dans l'API Google Ads

Ce document explique les différents termes utilisés pour décrire les comptes dans l'API Google Ads et comment ils sont liés les uns aux autres.

Présentation

L'API Google Ads utilise plusieurs termes pour décrire les comptes, ce qui peut parfois prêter à confusion. Il est important de comprendre ces distinctions pour gérer les comptes et interpréter les réponses de l'API.

Types de comptes

Les définitions suivantes clarifient les différents types de comptes que vous rencontrerez lorsque vous utiliserez l'API Google Ads.

Compte administrateur

Un compte administrateur est un compte principal utilisé pour gérer plusieurs comptes Google Ads.

• Ancien nom : auparavant appelé "CM" (Centre multicompte). Vous pouvez toujours voir ce terme dans l'ancienne documentation ou dans les discussions.
• Objectif : utilisez un compte administrateur lorsque vous souhaitez associer et gérer plusieurs comptes via une seule hiérarchie.
• Représentation de l'API : identifiée par une ressource Customer où customer.manager est true.

Compte d'annonceur (de diffusion)

Un compte d'annonceur (ou compte de diffusion) est un compte Google Ads individuel qui diffuse des campagnes publicitaires.

• Objectif : c'est là que les campagnes, les groupes d'annonces, les groupes de composants et les annonces sont créés et diffusés.
• Représentation de l'API : identifiée par une ressource Customer où customer.manager est false.

Compte client

Un compte client est un compte (un compte d'annonceur ou un autre compte administrateur) associé à un compte administrateur de niveau supérieur dans la hiérarchie et géré par celui-ci.

• Contexte : Le terme "client" fait référence à la relation dans la hiérarchie (gérée par un administrateur), et pas nécessairement à un "client" au sens commercial.
• Représentation de l'API : interrogez CustomerClient pour inspecter les comptes de la hiérarchie d'un administrateur, et utilisez CustomerClientLink pour gérer les associations entre les comptes administrateur et client.

Client

Dans le contexte de l'API, un client est la ressource représentant tout compte Google Ads, qu'il s'agisse d'un compte administrateur ou d'un compte d'annonceur.

• Représentation : tous les comptes sont représentés par une ressource Customer, identifiée par un customer_id.
• Rôle : la nature du compte (administrateur ou de diffusion) dépend de la ressource spécifique.

Compte test

Les comptes de test sont des comptes d'annonceur spéciaux organisés sous un compte administrateur de test dédié, spécifiquement conçu pour tester les intégrations d'API. Le champ customer.test_account du compte administrateur test et des comptes d'annonceur test qui lui sont associés est défini sur true. Vous ne pouvez pas créer de comptes de test sous un compte administrateur de production.

• Objectif : les comptes de test vous permettent de tester les appels d'API sans diffuser d'annonces réelles ni générer de frais. Ils ne diffusent pas d'annonces en direct.
• Représentation de l'API : identifiée par une ressource Customer où customer.test_account est true (avec customer.manager qui distingue un compte administrateur test d'un compte d'annonceur test).

Exemple de hiérarchie

Une hiérarchie type se présente comme suit :

• Compte administrateur A (niveau supérieur)
  • Compte client B (compte d'annonceur)
  • Compte client C (autre compte administrateur)
    • Compte client D (compte d'annonceur)

Dans cet exemple :

• Le compte A est un compte administrateur.
• Les comptes B, C et D sont des comptes client par rapport à leurs comptes parents.
• Les comptes B et D sont des comptes d'annonceur (de diffusion).
• Le compte C est à la fois un compte client (pour A) et un compte administrateur (pour D).