Kampanie produktowe

Skrypty Google Ads umożliwiają zarządzanie kampaniami produktowymi. Skryptów możesz używać do pracy z dotychczasowymi kampaniami produktowymi, tworzenia hierarchii grup produktów i zarządzania nimi oraz generowania raportów dotyczących kampanii produktowych. Nie możesz jednak używać skryptów do tworzenia kampanii produktowych, ustawiania właściwości zakupów na poziomie kampanii (np. priorytetu kampanii, filtrów zasobów reklamowych itp.) ani do łączenia kont Merchant Center.

Pobieranie kampanii produktowych i grup reklam

Kampanie produktowe są dostępne w kolekcji shoppingCampaigns obiektu AdsApp. Możesz je pobrać w zwykły sposób za pomocą skryptów:

const campaignName = "My first shopping campaign";

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

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

Po pobraniu kampanii możesz w podobny sposób uzyskać jej grupy reklam. Jest to zalecane tylko wtedy, gdy musisz wykonać działania zarówno w kampanii, jak i w jej grupach reklam.

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

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

Jeśli chcesz wykonywać działania tylko na konkretnych grupach reklam, możesz użyć metody AdsApp.shoppingAdGroups(), aby pobrać grupy reklam bez wcześniejszego pobierania kampanii:

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

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

Reklamy produktów

Skrypty Google Ads umożliwiają pobieranie reklam produktów za pomocą metody ads() obiektu ShoppingAdGroup. Nowe reklamy produktów możesz utworzyć za pomocą metody newAdBuilder() zasobu ShoppingAdGroup.

Iterowanie po hierarchii grup produktów

Dostęp do katalogu głównego hierarchii grup produktów możesz uzyskać za pomocą metody rootProductGroup obiektu ShoppingAdGroup. Następnie możesz użyć metody children, aby przechodzić przez podrzędne grupy produktów i poruszać się po hierarchii grup produktów. Każdy węzeł jest obiektem ProductGroup, a metoda getDimension pozwala określić rzeczywisty typ grupy produktów. Możesz też rzutować go na bardziej szczegółowy typ (np. ProductBrand), używając odpowiedniej metody rzutowania (np. asBrand). Poniższy fragment kodu pokazuje, jak rekurencyjnie przechodzić przez hierarchię grup produktów.

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

Wybierz konkretną grupę produktów

Możesz wybrać konkretne grupy produktów w hierarchii grup produktów za pomocą metody productGroups instancji AdsApp, ShoppingCampaign lub ShoppingAdGroup. To podejście jest prostsze niż przechodzenie przez całą hierarchię grup produktów podczas wybierania konkretnych grup produktów na potrzeby zarządzania stawkami. Poniższy fragment kodu pokazuje, jak wybrać wszystkie grupy produktów, które w ostatnim miesiącu uzyskały więcej niż 5 kliknięć i współczynnik klikalności wyższy niż 0.01, i zwiększyć ich stawkę o 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);
  }
}

Aktualizowanie hierarchii grup produktów

Możesz dodać podrzędną grupę produktów do istniejącej grupy produktów, używając metody newChild. W ten sposób uzyskasz obiekt ProductGroupBuilderSpace, którego możesz użyć do utworzenia odpowiedniej grupy produktów. Poniższy fragment kodu dodaje podział dla marki „cardcow” pod korzeniem, a następnie dzieli go dalej na nowe i odnowione produkty.

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

Podobnie możesz usunąć podział, używając metody remove obiektu ProductGroup. Spowoduje to również usunięcie całej hierarchii grup produktów pod usuwaną grupą produktów.

Skrypty zapewniają spójność hierarchii grup produktów po utworzeniu każdej grupy produktów, więc nie musisz tworzyć ani usuwać grupy produktów odpowiadającej opcji „Wszystkie pozostałe” podczas aktualizowania struktury hierarchii grup produktów.

Grupa produktów „Wszystkie pozostałe”

Hierarchie grup produktów w Zakupach Google zawierają na każdym poziomie grupę produktów „Wszystkie pozostałe” („Inne”), która obejmuje produkty niepasujące do warunku niestandardowego utworzonego w hierarchii grup produktów. Możesz użyć metody isOtherCase, aby odróżnić dodaną przez siebie zwykłą grupę produktów od grupy produktów „Inne”.

Poniższy fragment kodu pobiera grupę produktów „Inne” z głównej hierarchii grup produktów i wyświetla jej stawkę.

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

Gdy dzielisz grupę produktów na podgrupy, skrypty automatycznie tworzą grupę produktów „Inne”, aby zachować prawidłową hierarchię grup produktów. Grupa produktów „Inne” dziedziczy stawkę nadrzędnej grupy produktów.

Tworzenie nowej grupy reklam produktowych

Skrypty Google Ads umożliwiają utworzenie nowej grupy reklam produktowych za pomocą metody newAdGroupBuilder obiektu ShoppingCampaign. Po utworzeniu ShoppingAdGroup możesz użyć metody createRootProductGroup, aby utworzyć nową hierarchię grup produktów.

Raporty

Skrypty Google Ads obsługują raporty product_group_view i shopping_performance_view, które pomagają śledzić skuteczność kampanii produktowych. Więcej informacji o raportowaniu znajdziesz w przewodniku po raportach.