Kampanye Shopping

Skrip Google Ads menyediakan beberapa pengelolaan kampanye Shopping kampanye. Anda dapat menggunakan skrip agar berfungsi dengan kampanye Shopping yang ada, serta membuat dan mengelola produk hierarki grup, dan menjalankan laporan belanja. Namun, Anda tidak dapat menggunakan skrip untuk membuat kampanye Shopping, menetapkan properti Shopping di tingkat kampanye (untuk misalnya: prioritas kampanye, filter inventaris, dll.), atau tautkan Merchant Center menggunakan akun layanan.

Pengambilan kampanye Shopping dan grup iklan

Kampanye Shopping tersedia melalui shoppingCampaigns koleksi dari Objek AdsApp. Anda bisa mengambilnya seperti biasa melalui skrip:

const campaignName = "My first shopping campaign";

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

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

Setelah mengambil kampanye, Anda bisa mendapatkan grup iklannya dengan cara. Ini hanya lebih baik jika Anda perlu menindaklanjuti kampanye beserta grup iklan.

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

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

Jika Anda berencana untuk bertindak hanya pada grup iklan tertentu, Anda dapat menggunakan Metode AdsApp.shoppingAdGroups() untuk mengambil grup iklan tanpa mengambil kampanye terlebih dahulu:

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

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

Iklan produk

Skrip Google Ads memungkinkan Anda ambil iklan produk menggunakan tindakan ads() dari ShoppingAdGroup. Anda dapat buat iklan produk baru menggunakan newAdBuilder() dari ShoppingAdGroup

Melakukan iterasi melalui hierarki grup produk

Anda dapat mengakses root hierarki grup produk menggunakan rootProductGroup dari ShoppingAdGroup. Anda kemudian dapat menggunakan children untuk mengulangi grup produk turunan dan menelusuri grup produk hierarki sebelumnya. Setiap {i>node<i} adalah ProductGroup , dan Anda bisa menggunakan getDimension metode untuk mengetahui tipe sebenarnya dari kelompok produk. Anda juga dapat mentransmisikannya ke jenis yang lebih spesifik (misalnya, ProductBrand) dengan menggunakan metode transmisi yang sesuai (misalnya, asBrand) Cuplikan kode berikut menunjukkan cara menelusuri grup produk secara berulang hierarki sebelumnya.

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

Pilih grup produk tertentu

Anda dapat memilih grup produk tertentu dalam hierarki grup produk dengan Metode productGroups dari AdsApp, ShoppingCampaign, atau ShoppingAdGroup di instance Compute Engine. Pendekatan ini lebih sederhana daripada menjelajahi seluruh kelompok produk hierarki saat memilih grup produk tertentu untuk pengelolaan bid tujuan. Cuplikan kode berikut menunjukkan cara memilih semua grup produk dengan lebih dari lima klik dan rasio klik-tayang yang lebih besar dari 0.01 selama bulan lalu, dan meningkatkan bid sebesar 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);
  }
}

Memperbarui hierarki grup produk

Anda dapat menambahkan grup produk turunan ke grup produk yang ada menggunakan newChild . Hal ini memberi Anda ProductGroupBuilderSpace , yang dapat Anda gunakan untuk membuat kelompok produk yang sesuai. Tujuan cuplikan kode berikut menambahkan subdivisi untuk "cardcow" {i>brand <i}yang menjadi dasar, lalu membaginya lagi untuk produk baru dan refurbished.

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

Demikian pula, Anda dapat menghapus subdivisi menggunakan remove dari ProductGroup. Tindakan ini juga akan menghapus seluruh hierarki grup produk di bawah produk grup sedang dihapus.

Skrip akan memastikan bahwa hierarki grup produk berada dalam kondisi yang konsisten setelah membuat setiap grup produk, sehingga Anda tidak perlu membuat atau menghapus grup produk yang sesuai dengan "Lainnya" saat memperbarui produk struktur hierarki grup.

"Lainnya" grup produk

Hierarki grup produk Shopping berisi "Lainnya" ("Lainnya") kelompok produk di setiap tingkat untuk menangani produk yang tidak sesuai dengan kondisi khusus yang Anda buat dalam hierarki grup produk. Anda dapat menggunakan isOtherCase untuk membedakan antara kelompok produk normal yang Anda tambahkan, dan "Lainnya" kelompok produk.

Cuplikan kode berikut mengambil "Lainnya" kelompok produk di bawah {i>root<i} hierarki grup produk, dan mencetak bid-nya.

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

Saat Anda membagi lagi grup produk leaf, skrip akan otomatis membuat "Lainnya" kelompok produk untuk memastikan hierarki grup produk tetap valid. "Lainnya" grup produk mewarisi bid produk induk ras.

Buat grup iklan Shopping baru

Skrip Google Ads memungkinkan Anda membuat grup iklan Shopping baru menggunakan newAdGroupBuilder dari ShoppingCampaign. Setelah Anda membuat ShoppingAdGroup, Anda dapat menggunakan createRootProductGroup untuk membuat hierarki grup produk baru.

Laporan

Skrip Google Ads mendukung product_group_view dan shopping_performance_view untuk membantu melacak performa kampanye Shopping Anda. Anda dapat pelajari lebih lanjut pelaporan di panduan laporan.