Komponen wajib Penelusuran

Untuk membuat kampanye Penelusuran baru dari awal, Anda harus membuat minimal 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 mutate, karena panduan ini hanya akan memberikan objek JavaScript yang akan digunakan dalam mutates.

Anggaran

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

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 pada langkah sebelumnya untuk mengidentifikasi dan menggunakan objek anggaran tertentu tersebut. Gunakan CampaignOperation. Dalam contoh ini, kami 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 mereferensikan kampanye yang dibuat sebelumnya, jadi Anda akan memerlukan nama resource yang tepat yang Anda tetapkan pada langkah sebelumnya untuk mengidentifikasi kampanye yang dibuat sebelumnya dalam permintaan ini. Anda juga akan 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 an 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 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 mereferensikan grup iklan, jadi Anda akan memerlukan nama resource yang tepat yang Anda tetapkan pada 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 an 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);