AdGroup

Grup iklan.

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)
  ],
  "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 resource 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, 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. Penautan 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 ditetapkan 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. Saat ini hanya LOCATION_SYNC yang didukung.
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.

Teks harus berisi kurang dari 255 karakter UTF-8 dengan 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 yang dipromosikan, atau target melampaui kompetitor, jika tidak, nilainya akan menjadi null.
cpmBidMicros

string (int64 format)

Bid CPM (biaya per seribu tayangan terlihat) maksimum.
targetCpaMicros

string (int64 format)

Target CPA (biaya per akuisisi). Jika strategi bidding kampanye grup iklan adalah TargetCpa atau MaksimalkanKonversi (dengan kolom targetCpa-nya ditetapkan), kolom ini akan menggantikan target CPA yang ditetapkan dalam strategi bidding kampanye. Jika tidak, nilai ini akan diabaikan.
cpvBidMicros

string (int64 format)

Bid CPV (biaya per tampilan).
targetCpmMicros

string (int64 format)

Jumlah rata-rata dalam mikro yang bersedia dibayar pengiklan untuk setiap seribu kali iklan ditampilkan.
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)

Jumlah bid CPC persentase, yang dinyatakan sebagai pecahan dari harga yang diiklankan untuk beberapa barang atau layanan. Rentang pecahan yang valid 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) efektif. Kolom ini bersifat hanya baca.
effectiveTargetRoas

number

Hanya output. Target ROAS efektif (laba atas belanja iklan). Kolom ini bersifat hanya baca.

AdGroupStatus

Kemungkinan status grup iklan.

Enum
UNSPECIFIED Statusnya belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya merupakan respons.
ENABLED Grup iklan diaktifkan.
PAUSED Grup iklan dijeda.
REMOVED Grup iklan dihapus.

AdGroupType

Enum yang mencantumkan kemungkinan jenis grup iklan.

Enum
UNSPECIFIED Jenis belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya merupakan respons.
SEARCH_STANDARD Jenis grup iklan default untuk kampanye Penelusuran.
DISPLAY_STANDARD Jenis grup iklan default untuk kampanye Display.
SHOPPING_PRODUCT_ADS Jenis grup iklan untuk kampanye Shopping yang menayangkan iklan produk standar.
HOTEL_ADS Jenis grup iklan default untuk kampanye Hotel.
SHOPPING_SMART_ADS Jenis grup iklan di kampanye Shopping Pintar.
VIDEO_BUMPER Iklan video in-stream singkat yang tidak dapat dilewati.
VIDEO_TRUE_VIEW_IN_STREAM Iklan video in-stream TrueView (yang dapat dilewati).
VIDEO_TRUE_VIEW_IN_DISPLAY Iklan video TrueView dalam-tampilan.
VIDEO_NON_SKIPPABLE_IN_STREAM Iklan video in-stream yang tidak dapat dilewati.
VIDEO_OUTSTREAM Iklan video outstream.
SEARCH_DYNAMIC_ADS Jenis grup iklan untuk grup iklan Iklan Penelusuran Dinamis.
SHOPPING_COMPARISON_LISTING_ADS Jenis grup iklan di kampanye Listingan Perbandingan Shopping.
PROMOTED_HOTEL_ADS Jenis grup iklan untuk grup iklan Hotel yang Dipromosikan.
VIDEO_RESPONSIVE Grup iklan responsif video.
VIDEO_EFFICIENT_REACH Grup iklan jangkauan efisien video.
SMART_CAMPAIGN_ADS Jenis grup iklan untuk kampanye Pintar.
TRAVEL_ADS Jenis grup iklan untuk kampanye Perjalanan.

AdGroupAdRotationMode

Mode rotasi iklan yang memungkinkan untuk grup iklan.

Enum
UNSPECIFIED Mode rotasi iklan belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya merupakan 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
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.