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 : il s'appelait auparavant "CM" (Centre multicomptes). Vous pouvez encore voir ce terme dans l'ancienne documentation ou dans des discussions.
• Objectif : utilisez un compte administrateur lorsque vous souhaitez vous associer à plusieurs comptes et les gérer via une seule hiérarchie.
• Représentation dans l'API : identifié 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 dans l'API : identifié par une ressource Customer où customer.manager est false.

Compte client

Un compte client est un compte (compte d'annonceur ou autre compte administrateur) associé à un compte administrateur 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 non nécessairement à un "client" au sens commercial du terme.
• Représentation dans l'API : interrogez CustomerClient pour inspecter les comptes dans la hiérarchie d'un administrateur et utilisez CustomerClientLink pour gérer les liens entre les comptes administrateur et client.

Client

Dans le contexte de l'API, un client est la ressource représentant n'importe quel 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 Customer ressource, identifiée par un customer_id.
• Rôle : la nature du compte (administrateur ou diffusion) dépend de la ressource spécifique.

Compte test

Les comptes test sont des comptes d'annonceur spéciaux organisés sous un compte administrateur test dédié, spécifiquement destiné à 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. Les comptes test ne peuvent pas être créés sous un compte administrateur de production.

• Objectif : les comptes test vous permettent de tester les appels d'API sans diffuser d'annonces en direct ni générer de coûts. Ils ne diffusent pas d'annonces en direct.
• Représentation dans l'API : identifié 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

Voici un exemple de hiérarchie type :

• 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 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).