AdGroupCriterion

Kriteria grup iklan. Laporan adGroupKriteria hanya menampilkan kriteria yang secara eksplisit ditambahkan ke grup iklan.

Representasi JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource kriteria grup iklan. Nama resource kriteria grup iklan memiliki bentuk:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Hanya output. Nama tampilan kriteria.

Kolom ini diabaikan untuk mutasi.
status

enum (AdGroupCriterionStatus)

Status kriteria.

Ini adalah status entitas kriteria grup iklan, yang ditetapkan oleh klien. Catatan: Laporan UI dapat menyertakan informasi tambahan yang memengaruhi apakah sebuah kriteria layak dijalankan atau tidak. Dalam beberapa kasus, kriteria yang DIHAPUS di API masih dapat ditampilkan sebagai diaktifkan di UI. Misalnya, kampanye secara default ditampilkan kepada pengguna di semua rentang usia kecuali dikecualikan. UI akan menampilkan setiap rentang usia sebagai "diaktifkan", karena pengguna berhak melihat iklan; tetapi AdGroupKriteria.status akan menampilkan "dihapus", karena tidak ada kriteria positif yang ditambahkan.
qualityInfo

object (QualityInfo)

Hanya output. Informasi mengenai kualitas kriteria.
type

enum (CriterionType)

Hanya output. Jenis kriteria.
systemServingStatus

enum (CriterionSystemServingStatus)

Hanya output. Status penayangan kriteria.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Hanya output. Status persetujuan kriteria.
disapprovalReasons[]

string

Hanya output. Daftar alasan penolakan kriteria.

Berbagai alasan penolakan kriteria dapat ditemukan di sini: https://support.google.com/adspolicy/answer/6008942

Kolom ini bersifat hanya baca.
labels[]

string

Hanya output. Nama resource label yang dilampirkan ke kriteria grup iklan ini.
effectiveCpcBidSource

enum (BiddingSource)

Hanya output. Sumber bid CPC efektif.
effectiveCpmBidSource

enum (BiddingSource)

Hanya output. Sumber bid CPM efektif.
effectiveCpvBidSource

enum (BiddingSource)

Hanya output. Sumber bid CPV efektif.
effectivePercentCpcBidSource

enum (BiddingSource)

Hanya output. Sumber bid CPC Persen yang efektif.
positionEstimates

object (PositionEstimates)

Hanya output. Perkiraan bid kriteria pada berbagai posisi.
finalUrls[]

string

Daftar URL final yang mungkin setelah semua pengalihan lintas-domain untuk iklan.
finalMobileUrls[]

string

Daftar kemungkinan URL final seluler setelah semua pengalihan lintas-domain.
urlCustomParameters[]

object (CustomParameter)

Daftar pemetaan yang digunakan untuk mengganti tag parameter kustom dalam trackingUrlTemplate, finalUrls, atau mobile_final_urls.
criterionId

string (int64 format)

Hanya output. ID kriteria.

Kolom ini diabaikan untuk mutasi.
adGroup

string

Tidak dapat diubah. Grup iklan yang berisi kriteria.
negative

boolean

Tidak dapat diubah. Apakah akan menargetkan (false) atau mengecualikan (true) kriteria.

Kolom ini tidak dapat diubah. Untuk mengubah kriteria dari positif ke negatif, hapus lalu tambahkan kembali.
bidModifier

number

Pengubah untuk bid saat kriteria cocok. Pengubah harus berada dalam rentang: 0,1 - 10,0. Sebagian besar jenis kriteria yang dapat ditargetkan mendukung pengubah.
cpcBidMicros

string (int64 format)

Bid CPC (biaya per klik).
cpmBidMicros

string (int64 format)

Bid CPM (biaya per seribu tayangan iklan terlihat).
cpvBidMicros

string (int64 format)

Bid CPV (biaya per penayangan).
percentCpcBidMicros

string (int64 format)

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].
effectiveCpcBidMicros

string (int64 format)

Hanya output. Bid CPC (biaya per klik) efektif.
effectiveCpmBidMicros

string (int64 format)

Hanya output. Bid CPM (biaya per seribu tayangan iklan terlihat) efektif.
effectiveCpvBidMicros

string (int64 format)

Hanya output. Bid CPV (biaya per tampilan) yang efektif.
effectivePercentCpcBidMicros

string (int64 format)

Hanya output. Jumlah bid CPC Persen efektif.
finalUrlSuffix

string

Template URL untuk menambahkan parameter ke URL final.
trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan.

Kolom union criterion. Kriteria grup iklan.

Hanya satu yang harus ditetapkan. criterion hanya dapat berupa salah satu dari yang berikut:
keyword

object (KeywordInfo)

Tidak dapat diubah. Kata kunci.
placement

object (PlacementInfo)

Tidak dapat diubah. Penempatan.
mobileAppCategory

object (MobileAppCategoryInfo)

Tidak dapat diubah. Kategori aplikasi seluler.
mobileApplication

object (MobileApplicationInfo)

Tidak dapat diubah. Aplikasi seluler.
listingGroup

object (ListingGroupInfo)

Tidak dapat diubah. Grup listingan.
ageRange

object (AgeRangeInfo)

Tidak dapat diubah. Rentang usia.
gender

object (GenderInfo)

Tidak dapat diubah. Jenis Kelamin.
incomeRange

object (IncomeRangeInfo)

Tidak dapat diubah. Rentang pendapatan.
parentalStatus

object (ParentalStatusInfo)

Tidak dapat diubah. Status keorangtuaan.
userList

object (UserListInfo)

Tidak dapat diubah. Daftar Pengguna.
youtubeVideo

object (YouTubeVideoInfo)

Tidak dapat diubah. Video YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Tidak dapat diubah. Channel YouTube.
topic

object (TopicInfo)

Tidak dapat diubah. Topik.
userInterest

object (UserInterestInfo)

Tidak dapat diubah. Minat Pengguna.
webpage

object (WebpageInfo)

Tidak dapat diubah. Halaman
appPaymentModel

object (AppPaymentModelInfo)

Tidak dapat diubah. Model Pembayaran Aplikasi.
customAffinity

object (CustomAffinityInfo)

Tidak dapat diubah. Minat Kustom.
customIntent

object (CustomIntentInfo)

Tidak dapat diubah. Niat Kustom.
customAudience

object (CustomAudienceInfo)

Tidak dapat diubah. Audiens Kustom.
combinedAudience

object (CombinedAudienceInfo)

Tidak dapat diubah. Audiens Gabungan.
audience

object (AudienceInfo)

Tidak dapat diubah. Audiens.
location

object (LocationInfo)

Tidak dapat diubah. Lokasi.
language

object (LanguageInfo)

Tidak dapat diubah. Bahasa.

AdGroupCriterionStatus

Status yang mungkin dari Kriteria GrupIklan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Nilai ini hanya berupa respons.
ENABLED Kriteria grup iklan diaktifkan.
PAUSED Kriteria grup iklan dijeda.
REMOVED Kriteria grup iklan dihapus.

QualityInfo

Penampung untuk informasi kualitas kriteria grup iklan.

Representasi JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Kolom
creativeQualityScore

enum (QualityScoreBucket)

Hanya output. Performa iklan dibandingkan dengan pengiklan lain.
postClickQualityScore

enum (QualityScoreBucket)

Hanya output. Skor kualitas halaman landing.
searchPredictedCtr

enum (QualityScoreBucket)

Hanya output. Rasio klik-tayang dibandingkan dengan pengiklan lain.
qualityScore

integer

Hanya output. Skor kualitas.

Kolom ini mungkin tidak diisi jika Google tidak memiliki cukup informasi untuk menentukan nilai.

CriterionSystemServingStatus

Menghitung status penayangan sistem kriteria.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
ELIGIBLE Valid.
RARELY_SERVED Volume penelusuran rendah.

AdGroupCriterionApprovalStatus

Menghitung status persetujuan Kriteria GrupIklan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai dalam versi ini tidak diketahui.
APPROVED Disetujui.
DISAPPROVED Tidak disetujui.
PENDING_REVIEW Menunggu Peninjauan.
UNDER_REVIEW Dalam peninjauan.

PositionEstimates

Perkiraan bid kriteria pada berbagai posisi.

Representasi JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Kolom
firstPageCpcMicros

string (int64 format)

Hanya output. Estimasi bid CPC yang diperlukan agar iklan tampil pada halaman pertama hasil penelusuran.
firstPositionCpcMicros

string (int64 format)

Hanya output. Estimasi bid CPC yang diperlukan agar iklan ditampilkan di posisi pertama, di bagian atas halaman pertama hasil penelusuran.
topOfPageCpcMicros

string (int64 format)

Hanya output. Estimasi bid CPC yang diperlukan agar iklan ditampilkan di bagian atas halaman pertama hasil penelusuran.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Hanya output. Perkirakan jumlah klik per minggu yang mungkin Anda dapatkan dengan mengubah bid kata kunci ke nilai di firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Hanya output. Perkirakan bagaimana biaya per minggu dapat berubah bila mengubah bid kata kunci ke nilai di firstPositionCpcMicros.

ListingGroupInfo

Kriteria grup listingan.

Representasi JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Kolom
type

enum (ListingGroupType)

Jenis grup listingan.
caseValue

object (ListingDimensionInfo)

Nilai dimensi yang digunakan untuk menyaring induk grup listingan ini. Tidak ditentukan untuk grup root.
parentAdGroupCriterion

string

Nama resource kriteria grup iklan yang merupakan subdivisi grup listingan induk. Null untuk grup root.
path

object (ListingDimensionPath)

Jalur dimensi yang menentukan grup listingan ini.

ListingGroupType

Jenis grup listingan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
SUBDIVISION Subdivisi produk bersama beberapa dimensi listingan. Node ini tidak digunakan dengan berfungsi untuk menargetkan entri listingan, tetapi hanya digunakan untuk menentukan struktur hierarki.
UNIT Unit grup listingan yang menentukan bid.

ListingDimensionPath

Jalur dimensi yang menentukan grup listingan.

Representasi JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Kolom
dimensions[]

object (ListingDimensionInfo)

Jalur lengkap dimensi melalui hierarki grup listingan, dari root (tidak termasuk root itu sendiri) hingga grup listingan ini.

AppPaymentModelInfo

Kriteria model pembayaran aplikasi.

Representasi JSON 
{
  "type": enum (AppPaymentModelType)
}
Kolom
type

enum (AppPaymentModelType)

Jenis model pembayaran aplikasi.

AppPaymentModelType

Enum yang menjelaskan kemungkinan model pembayaran aplikasi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
PAID Mewakili aplikasi berbayar.

CustomIntentInfo

Kriteria niat kustom. Kriteria jenis ini hanya dapat ditargetkan.

Representasi JSON 
{
  "customIntent": string
}
Kolom
customIntent

string

Nama resource Minat Kustom.