Campagne Shopping

Gli script di Google Ads forniscono alcune funzionalità di gestione delle campagne Shopping. Puoi utilizzare gli script per lavorare con le campagne Shopping esistenti, creare e gestire le gerarchie dei gruppi di prodotti ed eseguire report Shopping. Tuttavia, non puoi utilizzare gli script per creare campagne Shopping, impostare le proprietà Shopping a livello di campagna (ad esempio priorità della campagna, filtri di inventario e così via) o collegare gli account Merchant Center.

Recuperare campagne Shopping e gruppi di annunci

Le campagne Shopping sono disponibili tramite la shoppingCampaigns raccolta di un AdsApp oggetto. Puoi recuperarle come di consueto tramite gli script:

const campaignName = "My first shopping campaign";

const campaignIterator = AdsApp.shoppingCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

Dopo aver recuperato una campagna, puoi ottenere i relativi gruppi di annunci in modo simile. Questa opzione è preferibile solo se devi intervenire sia sulla campagna sia sui relativi gruppi di annunci.

const adGroupIterator = campaign.adGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
    ...
}

Se prevedi di intervenire solo su gruppi di annunci specifici, puoi utilizzare il AdsApp.shoppingAdGroups() metodo per recuperare i gruppi di annunci senza recuperare prima la campagna:

const adGroupIterator = AdsApp.shoppingAdGroups()
    .withCondition(`campaign.name = "${campaignName}"`)
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
    ...
}

Annunci di prodotti

Gli script di Google Ads ti consentono di recuperare i tuoi annunci di prodotti utilizzando il ads() metodo di ShoppingAdGroup. Puoi creare nuovi annunci di prodotti utilizzando il metodo newAdBuilder() di ShoppingAdGroup.

Iterare la gerarchia dei gruppi di prodotti

Puoi accedere alla radice della gerarchia dei gruppi di prodotti utilizzando il rootProductGroup metodo di ShoppingAdGroup. Puoi quindi utilizzare il children metodo per iterare i gruppi di prodotti secondari e attraversare la gerarchia dei gruppi di prodotti. Ogni nodo è un oggetto ProductGroup e puoi utilizzare il metodo getDimension per determinare il tipo effettivo del gruppo di prodotti. Puoi anche eseguirne il cast a un tipo più specifico (ad esempio, ProductBrand) utilizzando il metodo di casting corrispondente (ad esempio, asBrand). Il seguente snippet di codice mostra come attraversare in modo ricorsivo la gerarchia dei gruppi di prodotti.

walkTree(shoppingAdGroup.rootProductGroup(), 1);

function walkTree(root, level) {
  // Logger.log(root.getDimension());
  let description = "";
  switch (root.getDimension()) {
    case "ROOT":
      description = "Root";
      break;

    case "CATEGORY":
      description = root.asCategory().getName();
      break;

    case "BRAND":
      description = root.asBrand().getName();
      break;

    // Handle more types here.
    ...
  }

  if (root.isOtherCase()) {
    description = "Other";
  }

  const padding = new Array(level + 1).join('-');
  console.log("%s, %s, %s, %s, %s, %s",
             padding,
             description,
             root.getDimension(),
             root.getMaxCpc(),
             root.isOtherCase(),
             root.getId().toFixed());
  const children = root.children().get();
  for (const child of children) {
    walkTree(child, level + 1);
  }
}

Selezionare un gruppo di prodotti specifico

Puoi selezionare gruppi di prodotti specifici in una gerarchia di gruppi di prodotti con il productGroups metodo di un'istanza AdsApp, ShoppingCampaign o ShoppingAdGroup. Questo approccio è più semplice rispetto all'attraversamento dell'intera gerarchia dei gruppi di prodotti quando selezioni gruppi di prodotti specifici per la gestione delle offerte. Il seguente snippet di codice mostra come selezionare tutti i gruppi di prodotti con più di cinque clic e un CTR superiore a 0.01 nell'ultimo mese e aumenta l'offerta di 0.01.

function main() {
  const productGroups = AdsApp.productGroups()
      .withCondition("metrics.clicks > 5")
      .withCondition("metrics.ctr > 0.01")
      .forDateRange("LAST_MONTH")
      .get();
  for (const productGroup of productGroups) {
    productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01);
  }
}

Aggiornare una gerarchia di gruppi di prodotti

Puoi aggiungere un gruppo di prodotti secondario a un gruppo di prodotti esistente utilizzando il suo newChild metodo. In questo modo, ottieni un ProductGroupBuilderSpace oggetto, che puoi utilizzare per creare un gruppo di prodotti appropriato. Il seguente snippet di codice aggiunge una suddivisione per un brand "cardcow" sotto la radice, quindi la suddivide ulteriormente per i prodotti nuovi e ricondizionati.

const root = shoppingAdGroup.rootProductGroup();

// Add a brand product group for a "cardcow" under root.
const brandProductGroup = root.newChild()
    .brandBuilder()
    .withName("cardcow")
    .withBid(1.2)
    .build()
    .getResult();

// Add new conditions for New and Refurbished cardcow brand items.
const newItems = brandProductGroup.newChild()
    .conditionBuilder()
    .withCondition("New")
    .withBid(1.5)
    .build()
    .getResult();

// Refurbished items will use the bid from "cardcow" product group.
const refurbishedItems = brandProductGroup.newChild()
    .conditionBuilder()
    .withCondition("Refurbished")
    .build()
    .getResult();

Allo stesso modo, puoi rimuovere una suddivisione utilizzando il remove metodo di ProductGroup. In questo modo, viene eliminata anche l'intera gerarchia dei gruppi di prodotti sotto il gruppo di prodotti da rimuovere.

Gli script garantiscono che la gerarchia dei gruppi di prodotti sia in uno stato coerente dopo la creazione di ogni gruppo di prodotti, quindi non è necessario creare o eliminare il gruppo di prodotti corrispondente a "Tutto il resto" quando aggiorni la struttura della gerarchia dei gruppi di prodotti.

Il gruppo di prodotti "Tutto il resto"

Le gerarchie dei gruppi di prodotti Shopping contengono un gruppo di prodotti "Tutto il resto" ("Altro") a ogni livello per gestire i prodotti che non corrispondono alla condizione personalizzata creata nella gerarchia dei gruppi di prodotti. Puoi utilizzare il isOtherCase metodo per distinguere tra un normale gruppo di prodotti che hai aggiunto e il gruppo di prodotti "Altro".

Il seguente snippet di codice recupera il gruppo di prodotti "Altro" nella gerarchia dei gruppi di prodotti radice e ne stampa l'offerta.

const root = shoppingAdGroup.rootProductGroup();

const childProductGroups = root.children().get();
let everythingElseProductGroupFound = false;

for (const childProductGroup of childProductGroups) {
  if (childProductGroup.isOtherCase()) {
    console.log("'Everything else' product group found. Type of the " +
               "product group is %s and bid is %s.",
               childProductGroup.getDimension(),
               childProductGroup.getMaxCpc());
    everythingElseProductGroupFound = true;
    break;
  }
}
if (!everythingElseProductGroupFound) {
  console.log("No 'Everything else' product group found under root " +
             "product group.");
}

Quando suddividi un gruppo di prodotti foglia, gli script creano automaticamente un gruppo di prodotti "Altro" per garantire che la gerarchia dei gruppi di prodotti rimanga valida. Il gruppo di prodotti "Altro" eredita l'offerta del gruppo di prodotti principale.

Creare un nuovo gruppo di annunci Shopping

Gli script di Google Ads ti consentono di creare un nuovo gruppo di annunci Shopping utilizzando il newAdGroupBuilder metodo di ShoppingCampaign. Dopo aver creato ShoppingAdGroup, puoi utilizzare il metodo createRootProductGroup per creare una nuova gerarchia di gruppi di prodotti.

Report

Gli script di Google Ads supportano i report product_group_view e shopping_performance_view per aiutarti a monitorare il rendimento delle tue campagne Shopping. Per saperne di più sui report, consulta la nostra guida ai report.