Komponen wajib Penelusuran

Untuk membuat kampanye Penelusuran baru dari awal, Anda setidaknya harus membuat hal berikut:

Kampanye dan anggaran berguna untuk membuat berbagai jenis kampanye, sementara beberapa setelan dalam iklan grup iklan akan berguna secara khusus untuk membuat kampanye Penelusuran. Buka panduan aset Penelusuran untuk melihat cara aset dapat dibuat menggunakan skrip.

Pastikan Anda memahami strategi mutasi, karena panduan ini hanya akan memberikan objek JavaScript yang akan digunakan dalam mutasi.

Anggaran

Anggaran tidak boleh dibagikan, dan harus memiliki nama yang unik di akun Anda. Gunakan CampaignBudgetOperation untuk membuat anggaran Anda.

const budgetOperation = {
  "campaignBudgetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaignBudgets/${getNextTempId()}`,
      "name": "Search campaign budget",
      "amountMicros": "10000000",
      "deliveryMethod": "STANDARD",
      "explicitlyShared": false
    }
  }
}
operations.push(budgetOperation);

Kampanye

Kampanye harus merujuk ke anggaran, jadi Anda memerlukan nama resource anggaran yang tepat yang Anda buat di langkah sebelumnya untuk mengidentifikasi dan menggunakan objek anggaran tertentu tersebut. Gunakan CampaignOperation. Dalam contoh ini, kita juga menetapkan AiMaxSetting untuk mengaktifkan AI Maksimal untuk Penelusuran, dan NetworkSettings.

const campaignOperation = {
  "campaignOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaigns/${getNextTempId()}`,
      "name": "Search campaign",
      "status": "PAUSED",
      "advertisingChannelType": "SEARCH",
      "campaignBudget": budgetOperation.campaignBudgetOperation.create.resourceName,
      "biddingStrategyType": "MANUAL_CPC",
      "startDate": "20240314",
      "endDate": "20250313",
      "manualCpc": {
        "enhancedCpcEnabled": true
      },
      "aiMaxSetting": {
        "enableAiMax": true
      },
      "networkSettings": {
        "targetGoogleSearch": true,
        "targetSearchNetwork": true
      },
      "containsEuPoliticalAdvertising": "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
    }
  }
}
operations.push(campaignOperation);

Grup iklan

Grup iklan harus merujuk ke kampanye yang dibuat sebelumnya, jadi Anda memerlukan nama resource yang sama persis dengan yang Anda tetapkan di langkah sebelumnya untuk mengidentifikasi kampanye yang dibuat sebelumnya dalam permintaan ini. Anda juga memerlukan ID sementara untuk grup iklan itu sendiri, yang sebaiknya disimpan sebagai variabel baru agar dapat digunakan saat membuat kata kunci dan iklan grup iklan. Gunakan AdGroupOperation.

const adGroupId = getNextTempId();
const adGroupOperation = {
  "adGroupOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroups/${adGroupId}`,
      "name": "Search ad group",
      "status": "PAUSED",
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "type": "SEARCH_STANDARD"
    }
  }
}
operations.push(adGroupOperation);

Kata kunci

Kata kunci diperlukan untuk memicu iklan Anda di hasil penelusuran. Kata kunci ditambahkan sebagai kriteria ke grup iklan menggunakan AdGroupCriterionOperation. Anda harus mereferensikan grup iklan yang dibuat di langkah sebelumnya.

const keywordOperation = {
  "adGroupCriterionOperation": {
    "create": {
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "ENABLED",
      "keyword": {
        "text": "flowers",
        "matchType": "BROAD"
      }
    }
  }
}
operations.push(keywordOperation);

Iklan grup iklan dengan iklan

Langkah ini membuat iklan grup iklan, yang menggabungkan grup iklan dengan iklan. Iklan grup iklan harus merujuk ke grup iklan, jadi Anda memerlukan nama resource yang sama persis dengan yang Anda tetapkan di langkah sebelumnya. Anda dapat membuat iklan dalam operasi yang sama, dan menggunakan aset teks yang dibuat sebelumnya atau membuatnya dalam operasi yang sama juga. Contoh yang ditampilkan di sini membuat Iklan Penelusuran Responsif menggunakan ResponsiveSearchAdInfo. Hal ini mengharuskan aset teks untuk judul dan deskripsi telah dibuat, seperti yang ditunjukkan dalam panduan Aset.

Untuk membuat iklan grup iklan, gunakan AdGroupAdOperation.

const adGroupAdOperation = {
  "adGroupAdOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroupAds/${adGroupId}~${getNextTempId()}`,
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "PAUSED",
      "ad": {
        "name": "Search RSA ad",
        "finalUrls": [
          "http://www.example.com"
        ],
        "responsiveSearchAd": {
          "headlines": [
            {
              "text": textAsset.assetOperation.create.resourceName
            },
            {
              "text": "Headline 2"
            },
            {
              "text": "Headline 3"
            }
          ],
          "descriptions": [
            {
              "text": "Description 1"
            },
            {
              "text": "Description 2"
            }
          ]
        }
      }
    }
  }
}
operations.push(adGroupAdOperation);