Komponen wajib Penelusuran

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

Kampanye dan anggaran berguna untuk membuat semua jenis kampanye, sementara beberapa setelan dalam iklan grup iklan akan sangat berguna untuk membuat kampanye Penelusuran. Buka Panduan aset penelusuran untuk melihat cara membuat aset 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 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 mereferensikan anggaran, jadi Anda akan 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 ke 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 mereferensikan kampanye yang dibuat sebelumnya, jadi Anda memerlukan nama resource persis 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 sehingga 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. Kriteria ini ditambahkan ke grup iklan menggunakan AdGroupCriterionOperation. Anda perlu mereferensikan grup iklan yang dibuat pada 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 persis 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. 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);