Gerarchia dei nomi
I nomi delle risorse utilizzati nell'API Google Ads sono gerarchici e rispecchiano l'organizzazione delle entità all'interno di Google Ads. Quasi tutte le risorse sono risorse secondarie della risorsa Customer
, il che riflette il fatto che quasi tutte le chiamate API devono avere come target un account Google Ads specifico. Ad esempio, campagne, gruppi di annunci, annunci e parole chiave
sono tutte risorse secondarie di una risorsa cliente radice.
Risorsa | Nome risorsa |
---|---|
Cliente | customers/1234567890
|
Priorità | customers/1234567890/campaigns/8765432109
|
AdGroup | customers/1234567890/adGroups/54321098765
|
AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
ID risorsa
Le entità Google Ads (clienti, campagne e così via) vengono indicate con i nomi delle rispettive risorse nell'API. Tuttavia, è importante notare che i nomi delle risorse possono avere ID risorsa numerici univoci che identificano ciascun oggetto nella gerarchia. In questi casi, può essere utile analizzare il nome della risorsa per estrarre questi ID risorsa e assemblarne uno nuovo.
Ad esempio, esamina il nome della risorsa AdGroupAd
della tabella precedente:
customers/1234567890/adGroupAds/54321098765~2109876543210
Questo può essere suddiviso nei singoli ID risorsa (separati da ID raccolta), come segue:
Componenti del nome della risorsa | |||||||
---|---|---|---|---|---|---|---|
ID risorsa |
|
||||||
ID raccolta |
|
L'analisi dei singoli ID consente di ricavare nuovi nomi di risorse per fare riferimento al cliente dell'annuncio del gruppo di annunci (customers/1234567890
) o al relativo gruppo di annunci (customers/1234567890/adGroupAds/54321098765
).
Identificatori degli oggetti condivisi
La maggior parte degli oggetti nell'API è associata a un singolo cliente Google Ads specifico. Tuttavia, esistono alcuni tipi di oggetti che possono essere condivisi tra più account. In pratica, si tratta di elenchi di parole chiave escluse o azioni di conversione su più account che vengono solitamente creati dagli amministratori e poi condivisi con molti account cliente.
I nomi delle risorse di oggetti come questi saranno diversi, a seconda dell'account a cui stai inviando una chiamata API.
Esempio: azioni di conversione su più account
Supponiamo di avere l'account amministratore 987-654-3210
che condivide un'azione di conversione su più account con uno dei suoi account cliente 123-456-7890
:
Una chiamata API all'account amministratore per aggiornare, ad esempio, la finestra temporale
dell'azione di conversione fa riferimento all'oggetto condiviso utilizzando il nome risorsa:
customers/9876543210/conversionActions/257733534
.
Una chiamata API all'account cliente per attivare l'utilizzo dell'azione di conversione
condivisa consente di fare riferimento utilizzando il nome della risorsa:
customers/1234567890/conversionActions/257733534
.
Questa è la stessa azione di conversione sottostante, ma il nome della risorsa è relativo all'account utilizzato per accedervi.