Perhatian: Anda sedang melihat dokumentasi untuk antarmuka REST API. Sebagian besar library klien resmi kami menggunakan gRPC. Lihat Pengantar REST untuk mengetahui detailnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

AdGroup

Representasi JSON
AdGroupStatus
AdGroupAdRotationMode
AudienceSetting
- Representasi JSON
AdGroupPrimaryStatus
AdGroupPrimaryStatusReason

Grup iklan.

Representasi JSON

Representasi JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Kolom
`resourceName`	`string` Tidak dapat diubah. Nama resource grup iklan. Nama sumber daya grup iklan memiliki bentuk: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Status grup iklan.
`type`	`enum (AdGroupType)` Tidak dapat diubah. Jenis grup iklan.
`adRotationMode`	`enum (AdGroupAdRotationMode)` Mode rotasi iklan grup iklan.
`urlCustomParameters[]`	`object (CustomParameter)` Daftar pemetaan yang digunakan untuk mengganti tag parameter kustom dalam `trackingUrlTemplate`, `finalUrls`, atau `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` True jika penargetan yang dioptimalkan diaktifkan. Penargetan yang Dioptimalkan adalah pengganti Ekspansi Audiens.
`displayCustomBidDimension`	`enum (TargetingDimension)` Memungkinkan pengiklan menentukan dimensi penargetan untuk menempatkan bid absolut. Hal ini hanya berlaku untuk kampanye yang hanya menargetkan Jaringan Display dan bukan penelusuran.
`targetingSetting`	`object (TargetingSetting)` Setelan untuk fitur terkait penargetan.
`audienceSetting`	`object (AudienceSetting)` Tidak dapat diubah. Setelan untuk fitur terkait audiens.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Hanya output. Sumber target CPA efektif. Kolom ini bersifat hanya baca.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Hanya output. Sumber target ROAS efektif. Kolom ini bersifat hanya baca.
`labels[]`	`string` Hanya output. Nama resource label yang dilampirkan ke grup iklan ini.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Jenis kolom aset yang harus dikecualikan dari grup iklan ini. Link aset dengan jenis kolom ini tidak akan diwarisi oleh grup iklan ini dari tingkat atas.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Jenis kumpulan aset yang harus dikecualikan dari grup iklan ini. Link kumpulan aset dengan jenis ini tidak akan diwarisi oleh grup iklan ini dari tingkat atas. Jenis grup lokasi (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, dan STATIC_LOCATION_GROUP) adalah jenis turunan LOCATION_SYNC. Oleh karena itu, jika LOCATION_SYNC disetel untuk kolom ini, semua kumpulan aset grup lokasi tidak diizinkan untuk ditautkan ke grup iklan ini, dan semua Ekstensi Lokasi (LE) serta Ekstensi Lokasi Afiliasi (ALE) tidak akan ditayangkan dalam grup iklan ini. Hanya LOCATION_SYNC yang saat ini didukung.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` Hanya output. Memberikan tampilan gabungan tentang alasan grup iklan tidak ditayangkan atau tidak ditayangkan secara optimal.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` Hanya output. Memberikan alasan mengapa grup iklan tidak ditayangkan atau tidak ditayangkan secara optimal.
`id`	`string (int64 format)` Hanya output. ID grup iklan.
`name`	`string` Nama grup iklan. Kolom ini wajib diisi dan tidak boleh kosong saat membuat grup iklan baru. Harus berisi kurang dari 255 karakter UTF-8 lebar penuh. Parameter ini tidak boleh berisi karakter null (titik kode 0x0), line feed NL (titik kode 0xA), atau enter (titik kode 0xD).
`baseAdGroup`	`string` Hanya output. Untuk grup iklan draf atau eksperimen, kolom ini adalah nama resource grup iklan dasar tempat grup iklan ini dibuat. Jika grup iklan draf atau eksperimen tidak memiliki grup iklan dasar, kolom ini akan bernilai null. Untuk grup iklan dasar, kolom ini sama dengan nama resource grup iklan. Kolom ini bersifat hanya baca.
`trackingUrlTemplate`	`string` Template URL untuk membuat URL pelacakan.
`campaign`	`string` Tidak dapat diubah. Kampanye yang berisi grup iklan.
`cpcBidMicros`	`string (int64 format)` Bid CPC (biaya per klik) maksimum.
`effectiveCpcBidMicros`	`string (int64 format)` Hanya output. Nilai akan sama dengan nilai bid CPC (biaya per klik) jika strategi bidding adalah salah satu dari cpc manual, enhanced cpc, halaman pertama dipromosikan, atau target melampaui kompetitor, jika tidak, nilainya akan menjadi nol.
`cpmBidMicros`	`string (int64 format)` Bid CPM (biaya per seribu tayangan iklan terlihat) maksimum.
`targetCpaMicros`	`string (int64 format)` Target CPA (biaya per akuisisi). Jika strategi bidding kampanye grup iklan adalah TargetCpa atau MaksimalkanConversions (dengan kolom targetCpa-nya ditetapkan), kolom ini akan menggantikan target CPA yang ditentukan dalam strategi bidding kampanye. Jika tidak, nilai ini akan diabaikan.
`cpvBidMicros`	`string (int64 format)` Bid CPV (biaya per penayangan).
`targetCpmMicros`	`string (int64 format)` Jumlah rata-rata dalam mikro yang bersedia dibayarkan pengiklan untuk setiap seribu tayangan iklan.
`targetRoas`	`number` Penggantian Target ROAS (laba atas belanja iklan). Jika strategi bidding kampanye grup iklan adalah TargetRoas atau MaksimalkanConversionValue (dengan kolom targetRoas ditetapkan), kolom ini akan menggantikan target ROAS yang ditentukan dalam strategi bidding kampanye. Jika tidak, nilai ini akan diabaikan.
`percentCpcBidMicros`	`string (int64 format)` Persentase jumlah bid cpc, yang dinyatakan sebagai pecahan dari harga yang diiklankan untuk beberapa barang atau layanan. Rentang yang valid untuk pecahan adalah [0,1) dan nilai yang disimpan di sini adalah 1.000.000 * [fraksi].
`finalUrlSuffix`	`string` Template URL untuk menambahkan parameter ke URL Final.
`effectiveTargetCpaMicros`	`string (int64 format)` Hanya output. Target CPA (biaya per akuisisi) yang efektif. Kolom ini bersifat hanya baca.
`effectiveTargetRoas`	`number` Hanya output. Target ROAS (laba atas belanja iklan) efektif. Kolom ini bersifat hanya baca.

AdGroupStatus

Kemungkinan status grup iklan.

Enum
`UNSPECIFIED`	Status belum ditentukan.
`UNKNOWN`	Nilai yang diterima tidak diketahui dalam versi ini. Nilai ini hanya berupa respons.
`ENABLED`	Grup iklan diaktifkan.
`PAUSED`	Grup iklan dijeda.
`REMOVED`	Grup iklan akan dihapus.

AdGroupAdRotationMode

Kemungkinan mode rotasi iklan grup iklan.

Enum
`UNSPECIFIED`	Mode rotasi iklan belum ditentukan.
`UNKNOWN`	Nilai yang diterima tidak diketahui dalam versi ini. Nilai ini hanya berupa respons.
`OPTIMIZE`	Mengoptimalkan iklan grup iklan berdasarkan klik atau konversi.
`ROTATE_FOREVER`	Rotasi secara merata selamanya.

AudienceSetting

Setelan untuk penargetan audiens.

Representasi JSON
{ "useAudienceGrouped": boolean }

Kolom

Kolom
`useAudienceGrouped`	`boolean` Tidak dapat diubah. Jika benar, grup iklan ini akan menggunakan resource Audiens untuk penargetan audiens. Jika salah, grup iklan ini dapat menggunakan kriteria segmen audiens sebagai gantinya.

useAudienceGrouped

boolean

Tidak dapat diubah. Jika benar, grup iklan ini akan menggunakan resource Audiens untuk penargetan audiens. Jika salah, grup iklan ini dapat menggunakan kriteria segmen audiens sebagai gantinya.

AdGroupPrimaryStatus

Kemungkinan status dari Grup Iklan.

Enum
`UNSPECIFIED`	Tidak ditentukan.
`UNKNOWN`	Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
`ELIGIBLE`	Grup iklan memenuhi syarat untuk ditayangkan.
`PAUSED`	Grup iklan dijeda.
`REMOVED`	Grup iklan akan dihapus.
`PENDING`	Grup iklan dapat ditayangkan pada masa mendatang.
`NOT_ELIGIBLE`	Grup iklan tidak memenuhi syarat untuk ditayangkan.
`LIMITED`	Grup iklan memiliki kemampuan penayangan terbatas.

AdGroupPrimaryStatusReason

Kemungkinan alasan status grup iklan.

Enum
`UNSPECIFIED`	Tidak ditentukan.
`UNKNOWN`	Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
`CAMPAIGN_REMOVED`	Status kampanye yang ditentukan pengguna dihapus. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`CAMPAIGN_PAUSED`	Status kampanye yang ditentukan pengguna dijeda. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`CAMPAIGN_PENDING`	Waktu yang ditentukan pengguna untuk memulai kampanye ini ada di masa mendatang. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID
`CAMPAIGN_ENDED`	Waktu yang ditentukan pengguna untuk mengakhiri kampanye ini telah berlalu. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`AD_GROUP_PAUSED`	Status grup iklan yang ditetapkan pengguna dijeda. Berkontribusi pada AdGroupPrimaryStatus.PAused.
`AD_GROUP_REMOVED`	Status grup iklan yang ditetapkan pengguna dihapus. Berkontribusi pada AdGroupPrimaryStatus.HAPUS.
`AD_GROUP_INCOMPLETE`	Pembuatan grup iklan ini belum selesai. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`KEYWORDS_PAUSED`	Status kata kunci yang ditetapkan pengguna di grup iklan ini semuanya dijeda. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`NO_KEYWORDS`	Tidak ada kata kunci yang valid di grup iklan ini. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`AD_GROUP_ADS_PAUSED`	Status iklan grup iklan yang ditetapkan pengguna di grup iklan ini semuanya dijeda. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`NO_AD_GROUP_ADS`	Tidak ada iklan grup iklan yang valid dalam grup iklan ini. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`HAS_ADS_DISAPPROVED`	Alasan status kebijakan jika setidaknya satu iklan tidak disetujui. Berkontribusi pada beberapa AdGroupPrimaryStatus.
`HAS_ADS_LIMITED_BY_POLICY`	Alasan status kebijakan jika setidaknya satu iklan dibatasi oleh kebijakan. Berkontribusi pada beberapa AdGroupPrimaryStatus.
`MOST_ADS_UNDER_REVIEW`	Alasan status kebijakan saat sebagian besar iklan menunggu peninjauan. Berkontribusi pada AdGroupPrimaryStatus.PENDING.
`CAMPAIGN_DRAFT`	GrupIklan merupakan bagian dari kampanye Draf. Berkontribusi ke AdGroupPrimaryStatus.NOT_VALID.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	Grup iklan telah dijeda karena lamanya aktivitas penayangan yang rendah. Berkontribusi pada AdGroupPrimaryStatus.PAused.