Tipi di account nell'API Google Ads

Questo documento spiega i diversi termini utilizzati per descrivere gli account nell'API Google Ads e la loro relazione.

Panoramica

L'API Google Ads utilizza diversi termini per descrivere gli account, il che a volte può creare confusione. Comprendere queste distinzioni è importante per la gestione degli account e l'interpretazione delle risposte dell'API.

Tipi di account

Le seguenti definizioni chiariscono i diversi tipi di account che incontrerai quando utilizzi l'API Google Ads.

Account amministratore

Un account amministratore è un account principale utilizzato per gestire più account Google Ads.

• Nome precedente: in precedenza era noto come "Centro clienti". Potresti ancora vedere questo termine nella documentazione o nelle discussioni legacy.
• Scopo: utilizza un account amministratore quando vuoi collegare e gestire più account tramite una singola gerarchia.
• Rappresentazione API: identificata da una risorsa Customer dove customer.manager è true.

Account inserzionista (di pubblicazione)

Un account inserzionista (o account di pubblicazione) è un account Google Ads individuale che pubblica campagne pubblicitarie.

• Scopo: è qui che vengono creati e pubblicati campagne, gruppi di annunci, gruppi di asset e annunci.
• Rappresentazione API: identificata da una risorsa Customer dove customer.manager è false.

Account cliente

Un account cliente è un account (un account inserzionista o un altro account amministratore) collegato a un account amministratore di livello superiore e gestito da quest'ultimo all'interno della gerarchia.

• Contesto: il termine "cliente" si riferisce alla relazione nella gerarchia (gestita da un amministratore), non necessariamente a un "cliente" in senso commerciale.
• Rappresentazione API: esegui una query su CustomerClient per esaminare gli account nella gerarchia di un amministratore e utilizza CustomerClientLink per gestire i collegamenti tra gli account amministratore e account cliente.

Cliente

Nel contesto dell'API, un cliente è la risorsa che rappresenta qualsiasi account Google Ads, che si tratti di un account amministratore o di un account inserzionista.

• Rappresentazione: tutti gli account sono rappresentati da una risorsa Customer, identificata da un customer_id.
• Ruolo: la natura dell'account (amministratore o di pubblicazione) dipende dalla risorsa specifica.

Account di prova

Gli account di prova sono account inserzionista speciali organizzati in un account amministratore di prova dedicato, specifico per testare le integrazioni API. Sia l'account amministratore di test sia gli account inserzionista di test al suo interno hanno il campo customer.test_account impostato su true. Non è possibile creare account di prova in un account amministratore di produzione.

• Scopo: gli account di prova ti consentono di testare le chiamate API senza pubblicare annunci pubblicati o sostenere costi. Non pubblicano annunci live.
• Rappresentazione API: identificato da una risorsa Customer dove customer.test_account è true (con customer.manager che distingue un account amministratore di test da un account inserzionista di test).

Esempio di gerarchia

Una gerarchia tipica ha questo aspetto:

• Account amministratore A (livello superiore)
  • Account cliente B (account inserzionista)
  • Account cliente C (un altro account amministratore)
    • Account cliente D (account inserzionista)

In questo esempio:

• L'account A è un account amministratore.
• Gli account B, C e D sono account cliente rispetto ai relativi account principali.
• Gli account B e D sono account inserzionista (di pubblicazione).
• L'account C è sia un account cliente (per A) sia un account amministratore (per D).