Campagnes Shopping

Les scripts Google Ads vous permettent de gérer vos campagnes Shopping de vos campagnes. Vous pouvez utiliser pour créer et gérer des campagnes Shopping existantes, de regrouper des hiérarchies et de générer des rapports Shopping. Toutefois, vous ne pouvez pas utiliser de scripts pour créez des campagnes Shopping, définissez les propriétés Shopping au niveau de la campagne (par par exemple: priorité de la campagne, filtres d'inventaire, etc.), ou associer un compte Merchant Center Google Cloud.

Récupération des campagnes et des groupes d'annonces Shopping

Les campagnes Shopping sont disponibles shoppingCampaigns d'une objet AdsApp. Toi vous pouvez les récupérer comme d'habitude via des scripts:

const campaignName = "My first shopping campaign";

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

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

Une fois que vous avez récupéré une campagne, vous pouvez regrouper ses groupes d'annonces de façon similaire de la même manière. Cette approche n'est préférable que si vous devez agir à la fois sur la campagne et sur ses groupes d'annonces.

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

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

Si vous prévoyez de ne agir que sur des groupes d'annonces spécifiques, vous pouvez utiliser le AdsApp.shoppingAdGroups() pour récupérer les groupes d'annonces sans récupérer la campagne:

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

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

Annonces pour un produit

Les scripts Google Ads vous permettent récupérer vos annonces produit à l'aide la ads() de la classe ShoppingAdGroup. Vous pouvez créer de nouvelles annonces produit newAdBuilder() méthode de ShoppingAdGroup.

Itérer la hiérarchie du groupe de produits

Vous pouvez accéder à la racine de la hiérarchie du groupe de produits à l'aide des rootProductGroup de la classe ShoppingAdGroup Vous pouvez ensuite utiliser children permettant d'itérer les groupes de produits enfants et de parcourir le groupe de produits. la hiérarchie. Chaque nœud est un ProductGroup et vous pouvez utiliser getDimension pour déterminer le type réel du groupe de produits. Vous pouvez également la caster. à un type plus spécifique (par exemple, ProductBrand) à l'aide de la méthode de diffusion correspondante (par exemple, asBrand). L'extrait de code suivant montre comment balayer de manière récursive le groupe de produits. la hiérarchie.

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);
  }
}

Sélectionner un groupe de produits spécifique

Vous pouvez sélectionner des groupes de produits spécifiques dans une hiérarchie de groupes de produits à l'aide de l'attribut productGroups d'une AdsApp, ShoppingCampaign, ou ShoppingAdGroup Compute Engine. Cette approche est plus simple que de parcourir l'ensemble du groupe de produits. lors de la sélection de groupes de produits spécifiques pour la gestion des enchères objectifs. L'extrait de code suivant montre comment sélectionner tous les groupes de produits ayant enregistré plus de cinq clics et un taux de clics supérieur à 0.01 sur la période le mois dernier et augmente son enchère de 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);
  }
}

Modifier la hiérarchie d'un groupe de produits

Vous pouvez ajouter un groupe de produits enfant à un groupe de produits existant à l'aide de son newChild . Cela vous donne un ProductGroupBuilderSpace , que vous pouvez ensuite utiliser pour créer un groupe de produits approprié. La L'extrait de code suivant ajoute une subdivision pour "cardcow" sous la racine, puis le subdivise pour les produits neufs et reconditionnés.

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();

De même, vous pouvez supprimer une subdivision à l'aide des boutons remove méthode de ProductGroup Cette action supprime également toute la hiérarchie du groupe de produits sous le produit. groupe en cours de suppression.

Les scripts garantissent que la hiérarchie du groupe de produits est cohérente. après avoir créé chaque groupe de produits. Ainsi, vous n'avez pas à créer ni à supprimer groupe de produits correspondant à "Tout le reste" lors de la mise à jour du produit structure hiérarchique des groupes.

La section "Divers" groupe de produits

Les hiérarchies de groupes de produits Shopping contiennent un libellé "Tout le reste" ("Autre") groupe de produits à chaque niveau pour gérer les produits qui ne correspondent pas condition personnalisée que vous avez créée dans la hiérarchie du groupe de produits. Vous pouvez utiliser isOtherCase pour faire la distinction entre un groupe de produits normal que vous avez ajouté et le "Autre" groupe de produits.

L'extrait de code suivant permet d'extraire sous le groupe de produits racine du groupe de produits et imprime son enchère.

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.");
}

Lorsque vous subdivisez un groupe de produits feuilles, les scripts créent automatiquement une autre catégorie groupe de produits pour s'assurer que la hiérarchie du groupe de produits valide. La catégorie "Autre" le groupe de produits hérite de l'enchère du produit parent groupe.

Créer un groupe d'annonces Shopping

Les scripts Google Ads vous permettent de créer un groupe d'annonces Shopping à l'aide des newAdGroupBuilder méthode de ShoppingCampaign Une fois que vous avez créé ShoppingAdGroup, vous pouvez utiliser son createRootProductGroup pour créer une hiérarchie de groupes de produits.

Rapports

Les scripts Google Ads sont compatibles product_group_view et shopping_performance_view rapports pour vous aider à suivre les performances de vos campagnes Shopping. Vous pouvez Pour en savoir plus sur les rapports, consultez notre guide des rapports.