Etichette

Le etichette consentono di organizzare gli elementi dell'account in gruppi significativi, in modo da poter filtrare e creare rapidamente report sui dati più interessanti. 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, è possibile utilizzare le etichette per associare dati arbitrari alle entità Google Ads. All'interno degli account amministratore, è possibile utilizzare le etichette 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 l'etichetta plumber_accounts a tutti gli account per gli idraulici e uno script potrà poi inserire le parole chiave correlate agli idraulici (ad esempio "riparazione di docce di emergenza") in tutte le campagne di questi account.
• Elaborare un elenco di entità.
  • Se vuoi attivare un insieme di parole chiave solo durante il fine settimana, puoi applicarle un'etichetta weekend_keywords. Uno script potrebbe quindi attivare tutte le parole chiave con weekend_keywords il venerdì sera e metterle 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 lo script in modo che venga eseguito ogni ora, quindi 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 per 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.
• Offerta flessibile
  • Uno script potrebbe utilizzare le etichette per conservare una cronologia delle modifiche alle offerte. Ad esempio, quando uno script aumenta del 20% un'offerta per parola chiave, può contrassegnare l'account con un'etichetta increased_20%. Il giorno successivo, quando lo script viene eseguito sull'etichetta e si rende conto che in precedenza aveva aumentato l'offerta, 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 periodicamente e creare report sulle parole chiave il cui punteggio di qualità non corrisponde più all'etichetta.

Etichette a livello di account

Gli script Google Ads consentono di creare etichette all'interno degli account amministratore e di applicare etichette agli account Google Ads inclusi in questo account amministratore:

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

Puoi applicare l'etichetta agli account che preferisci utilizzando il metodo 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'uso più comune delle etichette dell'account è l'elaborazione di un gruppo di account che condividono 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 della risorsa dell'etichetta. Se hai già un oggetto etichetta, utilizza invece un filtro customer_client.applied_labels CONTAINS ALL (${label.getResourceName()}). Consulta la sezione dei report di seguito per maggiori dettagli sui nomi delle risorse.

Per ulteriori informazioni sull'elaborazione di più account nell'esecuzione di un singolo script, consulta la guida agli script dell'account amministratore.

Etichette all'interno di un account

Puoi creare e applicare etichette a campagne, gruppi di annunci, annunci e parole chiave di un account. Per 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 utilizzando il metodo removeLabel:

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

Le etichette vengono di solito utilizzate per elaborare un insieme di entità simili raggruppate tramite 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();
}

Report

Puoi utilizzare i nomi delle risorse delle etichette per filtrare in base alle entità quando esegui report sul rendimento per gli account Google Ads. I nomi delle risorse sono un concetto dell'API Google Ads e vengono talvolta utilizzati durante l'esecuzione di report con GAQL. Il nome di una risorsa di 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 sulle campagne 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 gli operatori CONTAINS_ALL, CONTAINS_ANY e CONTAINS_NONE per filtrare in base ai nomi delle risorse delle etichette.