Etichette

Le etichette ti consentono di organizzare gli elementi del tuo account in gruppi significativi puoi filtrare e generare report rapidamente sui dati che più ti interessano. Gli script Google Ads supportano le etichette a livello di account, campagna, gruppo di annunci, annuncio e parola chiave.

Casi d'uso

Negli account Google Ads, le etichette possono essere utilizzate per associare dati arbitrari a Entità Google Ads. All'interno degli account amministratore, le etichette possono essere utilizzate per raggruppare account secondari simili. Le etichette sono utili per una serie di casi d'uso:

• Elaborare un elenco di account
  • Se sei un'agenzia, puoi applicare un'etichetta plumber_accounts a tutti gli account di idraulici, in modo che uno script possa inserire parole chiave correlate agli idraulici (ad es. "riparazione doccia d'emergenza") in tutte le campagne di questi account.
• Elabora un elenco di entità
  • Se hai un insieme di parole chiave che vuoi attivare solo durante nei fine settimana, potresti applicare un'etichetta weekend_keywords. Uno script potrebbe quindi attivare tutte le parole chiave con weekend_keywords venerdì alla sera e li metti in pausa il lunedì mattina.
• Elabora le entità in più esecuzioni
  • Se hai un numero elevato di entità che non possono essere elaborate in meno di 30 minuti, puoi creare un'etichetta processed nello script e applicarla alle entità già elaborate. Pianifica l'esecuzione dello script ogni ora ed elabora solo le entità a cui non è applicata l'etichetta processed.
• Modifiche in due passaggi
  • Anziché fare in modo che lo script esegua una modifica dell'offerta su un numero elevato di parole chiave, puoi etichettare le parole chiave con increase_bid_by_10%, accedere all'interfaccia utente di Google Ads, filtrare le parole chiave corrispondenti all'etichetta, esaminarle e, se il risultato ti soddisfa, modificare le offerte utilizzando le modifiche collettive.
• Offerte flessibili
  • Uno script potrebbe utilizzare le etichette per conservare una cronologia delle modifiche alle offerte. Per caso in cui uno script aumenta l'offerta per parola chiave del 20%, può contrassegnare account con l'etichetta increased_20%. Il giorno successivo, quando lo script viene eseguito sull'etichetta e si rende conto di aver già aumentato l'offerta in precedenza, potrebbe aumentare l'offerta solo del 10%.
• Monitoraggio del punteggio di qualità
  • Uno script potrebbe etichettare le parole chiave importanti con i relativi punteggi di qualità, quindi controllare e generare report periodicamente sulle parole chiave il cui punteggio di qualità non corrisponde più all'etichetta.

Etichette a livello di account

Gli script Google Ads ti consentono di creare etichette all'interno degli account amministratore, nonché di applicarle agli account Google Ads di quell'account amministratore:

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

Puoi applicare l'etichetta agli account di tua scelta utilizzando la applyLabel :

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

Analogamente, puoi rimuovere un'etichetta da un account utilizzando il metodo removeLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

L'utilizzo più comune delle etichette dell'account è per elaborare la condivisione di un gruppo di account la stessa etichetta dell'account:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

Nota: LabelNames è un metodo pratico e richiede una chiamata API aggiuntiva dietro le quinte per cercare il nome risorsa dell'etichetta. Se disponi già di un etichetta, devi utilizzare un filtro di customer_client.applied_labels CONTAINS ALL (${label.getResourceName()}). Per ulteriori dettagli sui nomi delle risorse, consulta la sezione relativa ai report di seguito.

Per saperne di più sull'elaborazione di più account in un'unica esecuzione di script, consulta la nostra guida agli script per gli account amministratore.

Etichette all'interno di un account

Puoi creare e applicare etichette a campagne, gruppi di annunci e annunci e parole chiave. Ecco come applicare un'etichetta a una campagna:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

Analogamente, puoi rimuovere un'etichetta con il metodo removeLabel:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

Le etichette sono comunemente utilizzate per elaborare un insieme di entità simili raggruppate insieme da un'etichetta. Il seguente snippet di codice mostra come mettere in pausa un gruppo di campagne che condividono un'etichetta comune:

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

Rapporti

Puoi utilizzare i nomi delle risorse delle etichette per filtrare le entità durante l'esecuzione report sul rendimento degli account Google Ads. I nomi delle risorse sono un concetto API Google Ads e talvolta utilizzate quando si eseguono report con GAQL. Il nome di una risorsa etichetta è sempre nel formato:

customers/[customer id]/labels/[label id]

Puoi recuperare il nome della risorsa di un'etichetta utilizzando il relativo metodo getResourceName.

Il seguente snippet di codice mostra come eseguire un report sulla campagna per tutte le campagne con l'etichetta "Promozioni di Natale":

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

Tieni presente che puoi utilizzare solo CONTAINS_ALL, CONTAINS_ANY e Operatori CONTAINS_NONE per i filtri in base ai nomi delle risorse delle etichette.