Campanhas do Shopping

Os scripts do Google AdWords permitem um certo nível de gerenciamento das suas Campanhas do Shopping. Você pode usar os scripts para trabalhar com as Campanhas do Shopping existentes, criar e gerenciar hierarquias de grupos de produtos, além de gerar relatórios do Shopping. No entanto, não é possível usar os scripts para criar Campanhas do Shopping, definir propriedades do Shopping no nível da campanha (por exemplo, prioridade de campanha, filtros de inventário etc.) ou vincular contas do Merchant Center.

Recuperação dos seus grupos de anúncios e Campanhas do Shopping

As Campanhas do Shopping estão disponíveis por meio do conjunto shoppingCampaigns de um objeto AdWordsApp. Você pode recuperá-las da mesma forma que você normalmente recuperaria campanhas em scripts.

var campaignName = "My first shopping campaign";

var campaignIterator = AdWordsApp.shoppingCampaigns()
    .withCondition("CampaignName = '" + campaignName + "'")
    .get();

while (campaignIterator.hasNext()) {
  var campaign = campaignIterator.next();
  ...
}

Depois de recuperar uma campanha, é possível obter os grupos de anúncios dela de modo semelhante:

var adGroupIterator = campaign.adGroups()
    .withCondition("AdGroupName = '" + adGroupName + "'")
    .get();

while (adGroupIterator.hasNext()) {
    var adGroup = adGroupIterator.next();
    ...
}

Se preferir, você pode usar o método AdWordsApp.shoppingAdGroups():

var adGroupIterator = AdWordsApp.shoppingAdGroups()
    .withCondition("CampaignName='" + campaignName +
        "' and AdGroupName = '" + adGroupName + "'")
    .get();

while (adGroupIterator.hasNext()) {
    var adGroup = adGroupIterator.next();
    ...
}

Como trabalhar com os anúncios de produtos

Os scripts do Google AdWords permitem que você recupere seus anúncios de produtos usando o método ads() de ShoppingAdGroup. É possível criar novos anúncios de produto usando o método newAdBuilder() de ShoppingAdGroup.

Iteração da hierarquia do grupo de produtos

Você pode acessar a raiz da hierarquia do grupo de produtos usando o método rootProductGroup de ShoppingAdGroup. Então, você pode usar o método children para iterar os grupos de produtos secundários e aplicar a hierarquia do grupo de produtos. Cada nó é um objeto ProductGroup, e você pode usar o método getDimension para entender o tipo real do grupo de produtos. Você também pode atribuí-lo a um tipo mais específico (por exemplo, ProductBrand) usando o método de atribuição correspondente (por exemplo, asBrand). O seguinte snippet de código mostra como direcionar de maneira recorrente a hierarquia do grupo de produtos.

walkTree(shoppingAdGroup.rootProductGroup(), 1);

function walkTree(root, level) {
  // Logger.log(root.getDimension());
  var 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";
  }

  var padding = new Array(level + 1).join('-');
  Logger.log("%s %s, %s, %s, %s, %s",
             padding,
             description,
             root.getDimension(),
             root.getMaxCpc(),
             root.isOtherCase(),
             root.getId().toFixed());
  var children = root.children().get();
  while (children.hasNext()) {
    var child = children.next();
    walkTree(child, level + 1);
  }
}

Seleção do grupo de produtos

Você pode selecionar grupos de produtos específicos em uma hierarquia de grupo de produtos com o método productGroups de instância de AdWordsApp, ShoppingCampaign ou ShoppingAdGroup. Essa abordagem é mais simples do que analisar toda a hierarquia do grupo de produtos se você quiser selecionar grupos de produtos específicos para fins de gerenciamento de lances. O snippet de código a seguir mostra como selecionar todos os grupos de produtos com mais de cinco cliques e uma taxa de cliques maior do que 0,01 no último mês, além de aumentar seu lance em 0,01.

function main() {
  var productGroups = AdWordsApp.productGroups()
      .withCondition("Clicks > 5")
      .withCondition("Ctr > 0.01")
      .forDateRange("LAST_MONTH")
      .get();
  while (productGroups.hasNext()) {
    var productGroup = productGroups.next();
    productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01);
  }
}

Atualização da hierarquia de um grupo de produtos

Você pode adicionar um grupo de produtos secundário a um grupo já existente usando o método newChild correspondente. Com isso, você tem um objeto ProductGroupBuilderSpace, que pode então usar para criar um grupo de produtos apropriado. O snippet de código a seguir adiciona uma subdivisão da marca "cardcow" na raiz e o subdivide ainda mais para produtos novos e reformulados.

var root = shoppingAdGroup.rootProductGroup();

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

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

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

De forma semelhante, você pode remover uma subdivisão usando o método remove de ProductGroup. Isso também excluirá toda a hierarquia do grupo de produtos abaixo do grupo de produtos sendo removido.

Os scripts garantirão que a hierarquia do grupo de produtos fique consistente depois da criação de cada grupo de produtos. Então, você não precisa criar ou excluir o grupo de produtos que corresponde a "Todo o restante" ao atualizar a estrutura da hierarquia do grupo de produtos.

O grupo de produtos "Todo o restante"

As hierarquias de grupos de produtos do Shopping contêm um grupo de produtos "Todo o restante" (ou "Outros") em todos os níveis para lidar com produtos que não cumprem a condição personalizada criada na hierarquia do grupo de produtos. Você pode usar o método isOtherCase para diferenciar um grupo de produtos normal que adicionou de um grupo de produtos classificado como "Outros".

O seguinte snippet de código recupera o grupo de produtos "Outros" na hierarquia do grupo de produtos raiz e registra o lance dele.

var root = shoppingAdGroup.rootProductGroup();

var childProductGroups = root.children().get();
var everythingElseProductGroupFound = false;

while (childProductGroups.hasNext()) {
  var childProductGroup = childProductGroups.next();
  if (childProductGroup.isOtherCase()) {
    Logger.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) {
  Logger.log("No 'Everything else' product group found under root " +
             "product group.");
}

Quando você subdivide um grupo de produtos folha, o script cria automaticamente um grupo de produtos "Outros" para garantir que a hierarquia continue válida. O grupo de produtos "Outros" herdará o lance do grupo de produtos pai.

Criação de um novo grupo de anúncios do Shopping

Os scripts do Google AdWords permitem que você crie um novo grupo de anúncios do Shopping usando o método newAdGroupBuilder de ShoppingCampaign. Depois de criar o ShoppingAdGroup, você pode usar seu método createRootProductGroup para criar uma nova hierarquia de grupo de produtos.

Geração de relatórios

Os scripts do Google AdWords suportam o Relatório de partição de produtos e o Relatório de desempenho do Shopping para ajudar você a acompanhar o desempenho das suas Campanhas do Shopping. Veja mais informações sobre os relatórios no nosso guia de relatórios.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.