SearchAds360Row

Baris yang ditampilkan dari kueri.

Representasi JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Kolom
adGroup

object (AdGroup)

Grup iklan yang dirujuk dalam kueri.

adGroupAd

object (AdGroupAd)

Iklan yang dirujuk dalam kueri.

adGroupAdLabel

object (AdGroupAdLabel)

Label iklan grup iklan yang dirujuk dalam kueri.

adGroupAsset

object (AdGroupAsset)

Aset grup iklan yang dirujuk dalam kueri.

adGroupAssetSet

object (AdGroupAssetSet)

Kumpulan aset grup iklan yang dirujuk dalam kueri.

adGroupAudienceView

object (AdGroupAudienceView)

Tampilan audiens grup iklan yang dirujuk dalam kueri.

adGroupBidModifier

object (AdGroupBidModifier)

Pengubah bid yang dirujuk dalam kueri.

adGroupCriterion

object (AdGroupCriterion)

Kriteria yang dirujuk dalam kueri.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Label kriteria grup iklan yang dirujuk dalam kueri.

adGroupLabel

object (AdGroupLabel)

Label grup iklan yang dirujuk dalam kueri.

ageRangeView

object (AgeRangeView)

Tampilan rentang usia yang dirujuk dalam kueri.

asset

object (Asset)

Aset yang dirujuk dalam kueri.

assetGroupAsset

object (AssetGroupAsset)

Aset grup aset yang dirujuk dalam kueri.

assetGroupSignal

object (AssetGroupSignal)

Sinyal grup aset yang dirujuk dalam kueri.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Filter grup listingan grup aset yang dirujuk dalam kueri.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Tampilan kombinasi teratas grup aset yang dirujuk dalam kueri.

assetGroup

object (AssetGroup)

Grup aset yang dirujuk dalam kueri.

assetSetAsset

object (AssetSetAsset)

Aset kumpulan aset yang dirujuk dalam kueri.

assetSet

object (AssetSet)

Kumpulan aset yang dirujuk dalam kueri.

biddingStrategy

object (BiddingStrategy)

Strategi bidding yang dirujuk dalam kueri.

campaignBudget

object (CampaignBudget)

Anggaran kampanye yang dirujuk dalam kueri.

campaign

object (Campaign)

Kampanye yang dirujuk dalam kueri.

campaignAsset

object (CampaignAsset)

Aset kampanye yang dirujuk dalam kueri.

campaignAssetSet

object (CampaignAssetSet)

Kumpulan aset kampanye yang dirujuk dalam kueri.

campaignAudienceView

object (CampaignAudienceView)

Tampilan audiens kampanye yang dirujuk dalam kueri.

campaignCriterion

object (CampaignCriterion)

Kriteria kampanye yang dirujuk dalam kueri.

campaignLabel

object (CampaignLabel)

Label kampanye yang dirujuk dalam kueri.

cartDataSalesView

object (CartDataSalesView)

Tampilan penjualan data keranjang yang dirujuk dalam kueri.

audience

object (Audience)

Audiens yang dirujuk dalam kueri.

conversionAction

object (ConversionAction)

Tindakan konversi yang dirujuk dalam kueri.

conversionCustomVariable

object (ConversionCustomVariable)

Variabel kustom konversi yang dirujuk dalam kueri.

customer

object (Customer)

Pelanggan yang dirujuk dalam kueri.

customerAsset

object (CustomerAsset)

Aset pelanggan yang dirujuk dalam kueri.

customerAssetSet

object (CustomerAssetSet)

Kumpulan aset pelanggan yang dirujuk dalam kueri.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Strategi bidding yang dapat diakses yang dirujuk dalam kueri.

customerClient

object (CustomerClient)

CustomerClient yang dirujuk dalam kueri.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Tampilan istilah penelusuran iklan Penelusuran Dinamis yang dirujuk dalam kueri.

genderView

object (GenderView)

Tampilan gender yang dirujuk dalam kueri.

geoTargetConstant

object (GeoTargetConstant)

Konstanta target geografis yang dirujuk dalam kueri.

keywordView

object (KeywordView)

Tampilan kata kunci yang dirujuk dalam kueri.

label

object (Label)

Label yang dirujuk dalam kueri.

languageConstant

object (LanguageConstant)

Konstanta bahasa yang dirujuk dalam kueri.

locationView

object (LocationView)

Tampilan lokasi yang dirujuk dalam kueri.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Kategori Bidding Produk yang dirujuk dalam kueri.

productGroupView

object (ProductGroupView)

Tampilan grup produk yang dirujuk dalam kueri.

shoppingPerformanceView

object (ShoppingPerformanceView)

Tampilan performa shopping yang dirujuk dalam kueri.

userList

object (UserList)

Daftar pengguna yang dirujuk dalam kueri.

webpageView

object (WebpageView)

Tampilan halaman web yang dirujuk dalam kueri.

visit

object (Visit)

Kunjungan tingkat peristiwa yang dirujuk dalam kueri.

conversion

object (Conversion)

Konversi tingkat peristiwa yang dirujuk dalam kueri.

metrics

object (Metrics)

Metrik.

segments

object (Segments)

Segmen.

customColumns[]

object (Value)

Kolom kustom.

AdGroup

Grup iklan.

Representasi JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Kolom
resourceName

string

Nama resource grup iklan. Nama resource grup iklan memiliki bentuk:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

Status grup iklan.

type

enum (AdGroupType)

Jenis grup iklan.

adRotationMode

enum (AdGroupAdRotationMode)

Mode rotasi iklan grup iklan.

creationTime

string

Stempel waktu saat grup iklan ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

targetingSetting

object (TargetingSetting)

Setelan untuk fitur terkait penargetan.

labels[]

string

Nama resource label yang dilampirkan ke grup iklan ini.

engineId

string

ID grup iklan di akun mesin eksternal. Kolom ini hanya untuk akun non-Google Ads, misalnya, Yahoo Japan, Microsoft, Baidu, dll. Untuk entitas Google Ads, gunakan "adGroup.id" sebagai gantinya.

startDate

string

Tanggal saat grup iklan ini mulai menayangkan iklan. Secara default, grup iklan dimulai sekarang atau tanggal mulai grup iklan, mana saja yang lebih akhir. Jika kolom ini ditetapkan, grup iklan akan dimulai di awal tanggal yang ditentukan dalam zona waktu pelanggan. Kolom ini hanya tersedia untuk akun gateway Microsoft Advertising dan Facebook.

Format: YYYY-MM-DD Contoh: 2019-03-14

endDate

string

Tanggal saat grup iklan berakhir menayangkan iklan. Secara default, grup iklan berakhir pada tanggal akhir grup iklan. Jika kolom ini ditetapkan, grup iklan akan berakhir di akhir tanggal yang ditentukan dalam zona waktu pelanggan. Kolom ini hanya tersedia untuk akun gateway Microsoft Advertising dan Facebook.

Format: YYYY-MM-DD Contoh: 2019-03-14

languageCode

string

Bahasa iklan dan kata kunci dalam grup iklan. Kolom ini hanya tersedia untuk akun Microsoft Advertising. Detail selengkapnya: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Tanggal dan waktu saat grup iklan ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

id

string (int64 format)

ID grup iklan.

name

string

Nama grup iklan.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat grup iklan baru.

ID ini harus berisi kurang dari 255 karakter lebar penuh UTF-8.

Parameter ini tidak boleh berisi karakter null (titik kode 0x0), line feed NL (titik kode 0xA), atau enter (titik kode 0xD).

cpcBidMicros

string (int64 format)

Bid CPC (biaya per klik) maksimum.

engineStatus

enum (AdGroupEngineStatus)

Status Mesin untuk grup iklan.

AdGroupStatus

Kemungkinan status grup iklan.

Enum
UNSPECIFIED Status belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

ENABLED Grup iklan diaktifkan.
PAUSED Grup iklan dijeda.
REMOVED Grup iklan akan dihapus.

AdGroupType

Enum yang mencantumkan kemungkinan jenis grup iklan.

Enum
UNSPECIFIED Jenis belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus 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.
SHOPPING_SHOWCASE_ADS Jenis untuk grup iklan yang dibatasi untuk menayangkan iklan Shopping atau Katalog di hasil Shopping.
HOTEL_ADS Jenis grup iklan default untuk kampanye Hotel.
SHOPPING_SMART_ADS Jenis untuk grup iklan di kampanye Shopping Pintar.
VIDEO_BUMPER Iklan video in-stream pendek 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 untuk grup iklan di kampanye Listingan Perbandingan Belanja.
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

Kemungkinan mode rotasi iklan dari grup iklan.

Enum
UNSPECIFIED Mode rotasi iklan belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

OPTIMIZE Optimalkan iklan grup iklan berdasarkan klik atau konversi.
ROTATE_FOREVER Rotasi secara merata selamanya.

AdGroupEngineStatus

Status mesin grup iklan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_GROUP_ELIGIBLE

Tidak digunakan lagi. Jangan gunakan.

AD_GROUP_EXPIRED Tidak ada iklan yang berjalan untuk grup iklan ini karena tanggal akhir grup iklan telah berlalu.
AD_GROUP_REMOVED Grup iklan telah dihapus.
AD_GROUP_DRAFT Tidak ada iklan yang berjalan untuk grup iklan ini karena grup iklan terkait masih dalam bentuk draf.
AD_GROUP_PAUSED Grup iklan telah dijeda.
AD_GROUP_SERVING Grup iklan aktif dan saat ini menayangkan iklan.
AD_GROUP_SUBMITTED Grup iklan telah dikirim (status lama Microsoft Bing Ads).
CAMPAIGN_PAUSED Tidak ada iklan yang berjalan untuk grup iklan ini karena kampanye telah dijeda.
ACCOUNT_PAUSED Tidak ada iklan yang berjalan untuk grup iklan ini karena akun telah dijeda.

TargetingSetting

Setelan untuk fitur terkait penargetan, di tingkat kampanye dan grup iklan. Untuk detail selengkapnya tentang setelan penargetan, kunjungi https://support.google.com/google-ads/answer/7365594

Representasi JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Kolom
targetRestrictions[]

object (TargetRestriction)

Setelan per dimensi penargetan untuk membatasi jangkauan kampanye atau grup iklan.

TargetRestriction

Daftar setelan penargetan per dimensi penargetan.

Representasi JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Kolom
targetingDimension

enum (TargetingDimension)

Dimensi penargetan tempat setelan ini diterapkan.

bidOnly

boolean

Menunjukkan apakah Anda akan membatasi iklan agar ditampilkan hanya untuk kriteria yang telah Anda pilih untuk targetingDimension ini, atau untuk menargetkan semua nilai untuk targetingDimension ini dan menampilkan iklan berdasarkan penargetan Anda di TargetingDimensions lain. Nilai true berarti kriteria ini hanya akan menerapkan pengubah bid, dan tidak memengaruhi penargetan. Nilai false berarti kriteria ini akan membatasi penargetan serta menerapkan pengubah bid.

TargetingDimension

Enum yang menjelaskan kemungkinan dimensi penargetan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
KEYWORD Kriteria kata kunci, misalnya, 'pelayaran mars'. KATA KUNCI dapat digunakan sebagai dimensi tawaran khusus. Kata kunci selalu merupakan dimensi penargetan, sehingga mungkin tidak ditetapkan sebagai target "SEMUA" dengan TargetRestriction.
AUDIENCE Kriteria audiens, yang mencakup daftar pengguna, minat pengguna, minat kustom, dan berniat beli kustom.
TOPIC Kriteria topik untuk menargetkan kategori konten, misalnya, 'kategori::Binatang>Hewan Peliharaan' Digunakan untuk penargetan Display dan Video.
GENDER Kriteria untuk penargetan gender.
AGE_RANGE Kriteria untuk menargetkan rentang usia.
PLACEMENT Kriteria penempatan, yang mencakup situs seperti 'www.flowers4sale.com', serta aplikasi seluler, kategori aplikasi seluler, video YouTube, dan channel YouTube.
PARENTAL_STATUS Kriteria untuk penargetan status keorangtuaan.
INCOME_RANGE Kriteria penargetan rentang pendapatan.

AdGroupAd

Iklan grup iklan.

Representasi JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Kolom
resourceName

string

Nama resource iklan. Nama resource iklan grup iklan memiliki bentuk:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

Status iklan.

ad

object (Ad)

Iklan.

creationTime

string

Stempel waktu saat adGroupAd ini dibuat. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

labels[]

string

Nama resource label yang dilampirkan ke iklan grup iklan ini.

engineId

string

ID iklan di akun mesin eksternal. Kolom ini hanya untuk akun Search Ads 360, misalnya, Yahoo Japan, Microsoft, Baidu, dll. Untuk entitas non-Search Ads 360, gunakan "adGroupAd.ad.id" sebagai gantinya.

engineStatus

enum (AdGroupAdEngineStatus)

Status tambahan iklan di akun mesin eksternal. Kemungkinan status (bergantung pada jenis akun eksternal) mencakup aktif, memenuhi syarat, menunggu peninjauan, dll.

lastModifiedTime

string

Tanggal dan waktu saat iklan grup iklan ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

AdGroupAdStatus

Kemungkinan status AdGroupAd.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

ENABLED Iklan grup iklan diaktifkan.
PAUSED Iklan grup iklan dijeda.
REMOVED Iklan grup iklan dihapus.

AdType

Kemungkinan jenis iklan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

TEXT_AD Iklan berupa iklan teks.
EXPANDED_TEXT_AD Iklan merupakan iklan teks diperpanjang.
CALL_ONLY_AD Iklan tersebut adalah iklan khusus panggilan telepon.
EXPANDED_DYNAMIC_SEARCH_AD Iklan tersebut adalah iklan Penelusuran Dinamis diperluas.
HOTEL_AD Iklannya adalah iklan Hotel.
SHOPPING_SMART_AD Iklan berupa iklan Shopping Pintar.
SHOPPING_PRODUCT_AD Iklannya adalah iklan Shopping standar.
VIDEO_AD Iklan merupakan iklan video.
GMAIL_AD Iklan ini adalah iklan Gmail.
IMAGE_AD Iklan ini adalah Iklan gambar.
RESPONSIVE_SEARCH_AD Iklannya merupakan iklan penelusuran responsif.
LEGACY_RESPONSIVE_DISPLAY_AD Iklannya adalah iklan Display responsif lama.
APP_AD Iklan merupakan iklan aplikasi.
LEGACY_APP_INSTALL_AD Iklan tersebut adalah iklan instal aplikasi lama.
RESPONSIVE_DISPLAY_AD Iklannya merupakan iklan Display responsif.
LOCAL_AD Iklan merupakan iklan lokal.
HTML5_UPLOAD_AD Iklan tersebut adalah iklan upload Display dengan jenis produk HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Iklan tersebut adalah iklan upload display dengan salah satu jenis produk DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Iklan adalah iklan engagement untuk aplikasi.
SHOPPING_COMPARISON_LISTING_AD Iklan tersebut adalah iklan Listingan Perbandingan Belanja.
VIDEO_BUMPER_AD Iklan bumper video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Iklan in-stream video yang tidak dapat dilewati.
VIDEO_OUTSTREAM_AD Iklan outstream video.
VIDEO_TRUEVIEW_DISCOVERY_AD Iklan TrueView dalam-tampilan video.
VIDEO_TRUEVIEW_IN_STREAM_AD Iklan TrueView in-stream video.
VIDEO_RESPONSIVE_AD Iklan responsif video.
SMART_CAMPAIGN_AD Iklan kampanye pintar.
APP_PRE_REGISTRATION_AD Iklan prapendaftaran aplikasi universal.
DISCOVERY_MULTI_ASSET_AD Iklan multi-aset Discovery.
TRAVEL_AD Iklan perjalanan.
DISCOVERY_VIDEO_RESPONSIVE_AD Iklan responsif video Discovery.
MULTIMEDIA_AD Iklan multimedia.

SearchAds360TextAdInfo

Iklan teks Search Ads 360.

Representasi JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Kolom
headline

string

Judul iklan.

description1

string

Baris pertama deskripsi iklan.

description2

string

Baris kedua deskripsi iklan.

displayUrl

string

URL iklan yang ditampilkan.

displayMobileUrl

string

URL seluler yang ditampilkan untuk iklan.

adTrackingId

string (int64 format)

ID pelacakan iklan.

SearchAds360ExpandedTextAdInfo

Iklan teks diperpanjang Search Ads 360.

Representasi JSON
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Kolom
headline

string

Judul iklan.

headline2

string

Judul kedua iklan.

headline3

string

Judul ketiga iklan.

description1

string

Baris pertama deskripsi iklan.

description2

string

Baris kedua deskripsi iklan.

path1

string

Teks yang ditambahkan ke URL terlihat yang dibuat secara otomatis dengan pembatas.

path2

string

Teks yang ditambahkan ke jalur1 dengan pembatas.

adTrackingId

string (int64 format)

ID pelacakan iklan.

SearchAds360ResponsiveSearchAdInfo

Iklan penelusuran responsif Search Ads 360.

Representasi JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Kolom
headlines[]

object (AdTextAsset)

Daftar aset teks untuk judul. Saat iklan ditayangkan, judul akan dipilih dari daftar ini.

descriptions[]

object (AdTextAsset)

Daftar aset teks untuk deskripsi. Saat iklan ditayangkan, deskripsi akan dipilih dari daftar ini.

path1

string

Teks yang ditambahkan ke URL terlihat yang dibuat secara otomatis dengan pembatas.

path2

string

Teks yang ditambahkan ke jalur1 dengan pembatas.

adTrackingId

string (int64 format)

ID pelacakan iklan.

AdTextAsset

Aset teks yang digunakan di dalam iklan.

Representasi JSON
{
  "text": string
}
Kolom
text

string

Teks aset.

SearchAds360ProductAdInfo

Jenis ini tidak memiliki kolom.

Iklan produk Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Iklan Penelusuran Dinamis diperluas.

Representasi JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Kolom
description1

string

Baris pertama deskripsi iklan.

description2

string

Baris kedua deskripsi iklan.

adTrackingId

string (int64 format)

ID pelacakan iklan.

AdGroupAdEngineStatus

Menghitung status mesin AdGroup.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_GROUP_AD_ELIGIBLE

Tidak digunakan lagi. Jangan gunakan.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Materi iklan tidak disetujui.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL seluler sedang dalam proses untuk ditinjau.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Materi iklan tidak valid di perangkat seluler, tetapi valid di desktop.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Materi iklan siap untuk diaktifkan.
AD_GROUP_AD_NOT_REVIEWED Baidu: Materi iklan belum ditinjau.
AD_GROUP_AD_ON_HOLD

Tidak digunakan lagi. Jangan gunakan. Sebelumnya digunakan oleh Gemini

AD_GROUP_AD_PAUSED Materi iklan telah dijeda.
AD_GROUP_AD_REMOVED Materi iklan telah dihapus.
AD_GROUP_AD_PENDING_REVIEW Materi iklan sedang menunggu peninjauan.
AD_GROUP_AD_UNDER_REVIEW Materi iklan sedang dalam peninjauan.
AD_GROUP_AD_APPROVED Materi iklan telah disetujui.
AD_GROUP_AD_DISAPPROVED Materi iklan tidak disetujui.
AD_GROUP_AD_SERVING Materi iklan sedang ditayangkan.
AD_GROUP_AD_ACCOUNT_PAUSED Materi iklan telah dijeda karena akun dijeda.
AD_GROUP_AD_CAMPAIGN_PAUSED Materi iklan telah dijeda karena kampanye dijeda.
AD_GROUP_AD_AD_GROUP_PAUSED Materi iklan telah dijeda karena grup iklan dijeda.

AdGroupAdLabel

Hubungan antara iklan grup iklan dan label.

Representasi JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
Kolom
resourceName

string

Nama resource label iklan grup iklan. Nama resource label iklan grup iklan memiliki bentuk: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Iklan grup iklan yang menyertakan label.

label

string

Label yang ditetapkan untuk iklan grup iklan.

AdGroupAsset

Link antara grup iklan dan aset.

Representasi JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Kolom
resourceName

string

Nama resource aset grup iklan. Nama resource AdGroupAsset memiliki bentuk:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

Wajib. Grup iklan yang ditautkan ke aset.

asset

string

Wajib. Aset yang ditautkan ke grup iklan.

status

enum (AssetLinkStatus)

Status aset grup iklan.

AssetLinkStatus

Enum yang menjelaskan status link aset.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Link aset diaktifkan.
REMOVED Link aset telah dihapus.
PAUSED Link aset dijeda.

AdGroupAssetSet

AdGroupAssetSet adalah penautan antara grup iklan dan kumpulan aset. Membuat AdGroupAssetSet akan menautkan kumpulan aset dengan grup iklan.

Representasi JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Kolom
resourceName

string

Nama resource dari kumpulan aset grup iklan. Nama resource kumpulan aset grup iklan memiliki bentuk:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

Grup iklan yang tertaut dengan kumpulan aset ini.

assetSet

string

Kumpulan aset yang ditautkan ke grup iklan.

status

enum (AssetSetLinkStatus)

Status kumpulan aset grup iklan. Hanya baca.

AssetSetLinkStatus

Kemungkinan status penautan antara kumpulan aset dan penampungnya.

Enum
UNSPECIFIED Status belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini. Ini adalah nilai khusus respons.
ENABLED Penautan antara kumpulan aset dan penampungnya diaktifkan.
REMOVED Keterkaitan antara kumpulan aset dan penampungnya dihapus.

AdGroupAudienceView

Tampilan audiens grup iklan. Mencakup data performa dari minat dan daftar pemasaran ulang untuk iklan Jaringan Display dan Jaringan YouTube, serta daftar pemasaran ulang untuk iklan penelusuran (RLSA), yang digabungkan di tingkat audiens.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan audiens grup iklan. Nama resource tampilan audiens grup iklan memiliki bentuk:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Mewakili pengubah bid grup iklan.

Representasi JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Kolom
resourceName

string

Nama resource pengubah bid grup iklan. Nama resource pengubah bid grup iklan memiliki bentuk:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

Pengubah bid saat kriteria cocok. Pengubah harus dalam rentang: 0.1 - 10.0. Rentangnya adalah 1,0 - 6,0 untuk PreferredContent. Gunakan 0 untuk memilih tidak menyertakan Jenis perangkat.

Kolom union criterion. Kriteria pengubah bid grup iklan ini.

Diperlukan dalam operasi pembuatan yang dimulai pada V5. criterion hanya dapat berupa salah satu dari yang berikut:

device

object (DeviceInfo)

Kriteria perangkat.

DeviceInfo

Kriteria perangkat.

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

enum (Device)

Jenis perangkat.

Perangkat

Menghitung perangkat Google Ads yang tersedia untuk penargetan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
MOBILE Perangkat seluler dengan browser lengkap.
TABLET Tablet dengan browser lengkap.
DESKTOP Komputer.
CONNECTED_TV Smart TV dan konsol game.
OTHER Jenis perangkat lainnya.

AdGroupCriterion

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

Representasi JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Kolom
resourceName

string

Nama resource kriteria grup iklan. Nama resource kriteria grup iklan memiliki bentuk:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

Stempel waktu saat kriteria grup iklan ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

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 kriteria memenuhi syarat untuk dijalankan. Dalam beberapa kasus, kriteria yang DIHAPUS di API masih dapat ditampilkan sebagai diaktifkan di UI. Misalnya, kampanye secara default ditampilkan kepada pengguna dari semua rentang usia kecuali jika dikecualikan. UI akan menampilkan setiap rentang usia sebagai "diaktifkan", karena mereka memenuhi syarat untuk melihat iklan; tetapi AdGroupCriteria.status akan menampilkan "dihapus", karena tidak ada kriteria positif yang ditambahkan.

qualityInfo

object (QualityInfo)

Informasi tentang kualitas kriteria.

type

enum (CriterionType)

Jenis kriteria.

labels[]

string

Nama resource label yang dilampirkan ke kriteria grup iklan ini.

positionEstimates

object (PositionEstimates)

Estimasi untuk bid kriteria di berbagai posisi.

finalUrls[]

string

Daftar kemungkinan URL final setelah semua pengalihan lintas-domain untuk iklan.

engineId

string

ID kriteria grup iklan di akun mesin eksternal. Kolom ini hanya untuk akun non-Google Ads, misalnya, Yahoo Japan, Microsoft, Baidu, dll. Untuk entitas Google Ads, gunakan "adGroupCriteria.criterion_id" sebagai gantinya.

lastModifiedTime

string

Tanggal dan waktu saat kriteria grup iklan ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

criterionId

string (int64 format)

ID kriteria.

adGroup

string

Grup iklan yang memiliki kriteria tersebut.

negative

boolean

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 bid saat kriteria cocok. Pengubah harus dalam rentang: 0.1 - 10.0. Sebagian besar jenis kriteria yang dapat ditargetkan mendukung pengubah.

cpcBidMicros

string (int64 format)

Bid CPC (biaya per klik).

effectiveCpcBidMicros

string (int64 format)

Bid CPC (biaya per klik) efektif.

engineStatus

enum (AdGroupCriterionEngineStatus)

Status Mesin untuk kriteria grup iklan.

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 harus ditetapkan. criterion hanya dapat berupa salah satu dari yang berikut:

keyword

object (KeywordInfo)

Kata kunci.

listingGroup

object (ListingGroupInfo)

Grup listingan.

ageRange

object (AgeRangeInfo)

Rentang usia.

gender

object (GenderInfo)

Jenis Kelamin.

userList

object (UserListInfo)

Daftar Pengguna.

webpage

object (WebpageInfo)

Halaman

location

object (LocationInfo)

Lokasi.

AdGroupCriterionStatus

Kemungkinan status Kriteria GrupIklan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus 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
{
  "qualityScore": integer
}
Kolom
qualityScore

integer

Skor kualitas.

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

CriterionType

Enum yang menjelaskan kemungkinan jenis kriteria.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
KEYWORD Kata kunci, misalnya, 'pelayaran mars'.
PLACEMENT Penempatan, juga dikenal sebagai Situs, misalnya, 'www.flowers4sale.com'
MOBILE_APP_CATEGORY Kategori aplikasi seluler yang akan ditargetkan.
MOBILE_APPLICATION Aplikasi seluler yang ditargetkan.
DEVICE Perangkat yang ditargetkan.
LOCATION Lokasi yang akan ditargetkan.
LISTING_GROUP Grup listingan yang akan ditargetkan.
AD_SCHEDULE Jadwal Iklan.
AGE_RANGE Rentang usia.
GENDER Jenis Kelamin.
INCOME_RANGE Rentang Pendapatan.
PARENTAL_STATUS Status keorangtuaan.
YOUTUBE_VIDEO Video YouTube.
YOUTUBE_CHANNEL Channel YouTube.
USER_LIST Daftar pengguna.
PROXIMITY Jarak.
TOPIC Target topik di jaringan display (misalnya, "Hewan Peliharaan & Binatang").
LISTING_SCOPE Cakupan listingan yang akan ditargetkan.
LANGUAGE Bahasa.
IP_BLOCK IpBlock.
CONTENT_LABEL Label Konten untuk pengecualian kategori.
CARRIER Operator.
USER_INTEREST Kategori yang diminati pengguna.
WEBPAGE Kriteria halaman web untuk iklan Penelusuran Dinamis.
OPERATING_SYSTEM_VERSION Versi sistem operasi.
APP_PAYMENT_MODEL Model pembayaran aplikasi.
MOBILE_DEVICE Perangkat seluler.
CUSTOM_AFFINITY Minat kustom.
CUSTOM_INTENT Niat kustom.
LOCATION_GROUP Grup lokasi.
CUSTOM_AUDIENCE Audiens kustom
COMBINED_AUDIENCE Audiens gabungan
KEYWORD_THEME Tema kata kunci Kampanye Pintar
AUDIENCE Audiens
LOCAL_SERVICE_ID ID Layanan Iklan Jasa dan Servis.
BRAND Merek
BRAND_LIST Daftar Merek
LIFE_EVENT Peristiwa Kehidupan

PositionEstimates

Estimasi untuk bid kriteria di berbagai posisi.

Representasi JSON
{
  "topOfPageCpcMicros": string
}
Kolom
topOfPageCpcMicros

string (int64 format)

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

AdGroupCriterionEngineStatus

Menghitung status mesin Kriteria GrupIklan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_GROUP_CRITERION_ELIGIBLE

Tidak digunakan lagi. Jangan gunakan.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Bid atau kualitas terlalu rendah untuk ditampilkan.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Dijeda oleh Baidu karena volume penelusuran yang rendah.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL seluler sedang dalam proses untuk ditinjau.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Halaman landing untuk satu perangkat tidak valid, sedangkan halaman landing untuk perangkat lainnya valid.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Kata kunci telah dibuat dan dijeda oleh pengelolaan akun Baidu, dan sekarang siap untuk Anda aktifkan.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Sedang dalam proses untuk ditinjau oleh Baidu. Gemini: Kriteria dalam peninjauan.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: Kriteria yang akan ditinjau.
AD_GROUP_CRITERION_ON_HOLD

Tidak digunakan lagi. Jangan gunakan. Sebelumnya digunakan oleh Gemini

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Kriteria menunggu tinjauan
AD_GROUP_CRITERION_PAUSED Kriteria telah dijeda.
AD_GROUP_CRITERION_REMOVED Kriteria telah dihapus.
AD_GROUP_CRITERION_APPROVED Kriteria telah disetujui.
AD_GROUP_CRITERION_DISAPPROVED Kriteria tidak disetujui.
AD_GROUP_CRITERION_SERVING Kriteria aktif dan ditayangkan.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Kriteria telah dijeda karena akun dijeda.

KeywordInfo

Kriteria kata kunci.

Representasi JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Kolom
matchType

enum (KeywordMatchType)

Jenis pencocokan kata kunci.

text

string

Teks kata kunci (maksimal 80 karakter dan 10 kata).

KeywordMatchType

Kemungkinan jenis pencocokan Kata kunci.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
EXACT Pencocokan persis.
PHRASE Pencocokan frasa.
BROAD Pencocokan luas.

ListingGroupInfo

Kriteria grup listingan.

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

enum (ListingGroupType)

Jenis grup listingan.

ListingGroupType

Jenis grup listingan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SUBDIVISION Subdivisi produk beserta beberapa dimensi listingan. Node ini tidak digunakan dengan menayangkan ke entri listingan target, tetapi semata-mata untuk menentukan struktur hierarki.
UNIT Unit grup listingan yang menentukan bid.

AgeRangeInfo

Kriteria rentang usia.

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

enum (AgeRangeType)

Jenis rentang usia.

AgeRangeType

Jenis rentang usia demografis (misalnya, antara 18 dan 24 tahun).

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AGE_RANGE_18_24 Berusia antara 18 dan 24 tahun.
AGE_RANGE_25_34 Berusia antara 25 dan 34 tahun.
AGE_RANGE_35_44 Berusia antara 35 dan 44 tahun.
AGE_RANGE_45_54 Berusia antara 45 dan 54 tahun.
AGE_RANGE_55_64 Berusia antara 55 dan 64 tahun.
AGE_RANGE_65_UP 65 tahun ke atas.
AGE_RANGE_UNDETERMINED Rentang usia tidak ditentukan.

GenderInfo

Kriteria gender.

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

enum (GenderType)

Jenis gender.

GenderType

Jenis gender demografis (misalnya, perempuan).

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
MALE Pria.
FEMALE Perempuan.
UNDETERMINED Gender belum ditentukan.

UserListInfo

Kriteria Daftar Pengguna. Mewakili daftar pengguna yang ditetapkan oleh pengiklan untuk ditarget.

Representasi JSON
{
  "userList": string
}
Kolom
userList

string

Nama resource Daftar Pengguna.

WebpageInfo

Mewakili kriteria untuk menargetkan halaman web dari situs pengiklan.

Representasi JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Kolom
conditions[]

object (WebpageConditionInfo)

Kondisi, atau ekspresi logis, untuk penargetan halaman web. Daftar kondisi penargetan halaman web akan digabungkan saat dievaluasi untuk penargetan. Daftar kondisi kosong menunjukkan bahwa semua halaman situs kampanye ditargetkan.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

coveragePercentage

number

Persentase cakupan kriteria situs. Rasio ini adalah persentase yang dihitung dari cakupan situs berdasarkan target situs, target situs negatif, dan kata kunci negatif dalam grup iklan dan kampanye. Misalnya, jika cakupan ditampilkan sebagai 1, berarti cakupan tersebut memiliki cakupan 100%. Kolom ini bersifat hanya baca.

criterionName

string

Nama kriteria yang ditentukan oleh parameter ini. Nilai nama akan digunakan untuk mengidentifikasi, menyortir, dan memfilter kriteria dengan jenis parameter ini.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

WebpageConditionInfo

Ekspresi logis untuk menargetkan halaman situs pengiklan.

Representasi JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Kolom
operand

enum (WebpageConditionOperand)

Operand kondisi penargetan halaman web.

operator

enum (WebpageConditionOperator)

Operator kondisi penargetan halaman web.

argument

string

Argumen kondisi penargetan halaman web.

WebpageConditionOperand

Operand kondisi halaman web dalam kriteria halaman web.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
URL Operand yang menunjukkan kondisi penargetan URL halaman.
CATEGORY Operand yang menunjukkan kondisi penargetan kategori halaman web.
PAGE_TITLE Operand yang menunjukkan kondisi penargetan judul halaman web.
PAGE_CONTENT Operand yang menunjukkan kondisi penargetan konten halaman web.
CUSTOM_LABEL Operand yang menunjukkan kondisi penargetan label khusus halaman web.

WebpageConditionOperator

Operator kondisi halaman web di kriteria halaman web.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
EQUALS Kondisi web argumen sama dengan kondisi web yang dibandingkan.
CONTAINS Kondisi web argumen adalah bagian dari kondisi web yang dibandingkan.

LocationInfo

Kriteria lokasi.

Representasi JSON
{
  "geoTargetConstant": string
}
Kolom
geoTargetConstant

string

Nama resource konstanta target geografis.

AdGroupCriterionLabel

Hubungan antara kriteria grup iklan dan label.

Representasi JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
Kolom
resourceName

string

Nama resource label kriteria grup iklan. Nama resource label kriteria grup iklan memiliki bentuk: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Kriteria grup iklan yang ditambahi label.

label

string

Label yang ditetapkan ke kriteria grup iklan.

AdGroupLabel

Hubungan antara grup iklan dan label.

Representasi JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
Kolom
resourceName

string

Nama resource label grup iklan. Nama resource label grup iklan memiliki bentuk: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

Grup iklan yang ditambahi label.

label

string

Label yang ditetapkan untuk grup iklan.

AgeRangeView

Tampilan rentang usia.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan rentang usia. Nama resource tampilan rentang usia memiliki bentuk:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Aset

Aset adalah bagian dari iklan yang dapat dibagikan ke beberapa iklan. Aset dapat berupa gambar (ImageAsset), video (YouTubeVideoAsset), dll. Aset tidak dapat diubah dan tidak dapat dihapus. Untuk menghentikan penayangan aset, hapus aset dari entitas yang menggunakannya.

Representasi JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Kolom
resourceName

string

Nama resource aset. Nama resource aset memiliki bentuk:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Jenis aset.

finalUrls[]

string

Daftar kemungkinan URL final setelah semua pengalihan lintas-domain.

status

enum (AssetStatus)

Status aset.

creationTime

string

Stempel waktu saat aset ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

lastModifiedTime

string

Tanggal dan waktu saat aset ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

id

string (int64 format)

ID aset.

name

string

Nama opsional aset.

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan.

engineStatus

enum (AssetEngineStatus)

Status Mesin untuk aset.

Kolom union asset_data. Jenis aset tertentu. asset_data hanya dapat berupa salah satu dari berikut:
youtubeVideoAsset

object (YoutubeVideoAsset)

Aset video YouTube.

imageAsset

object (ImageAsset)

Aset gambar.

textAsset

object (TextAsset)

Aset teks.

calloutAsset

object (UnifiedCalloutAsset)

Aset info terpadu.

pageFeedAsset

object (UnifiedPageFeedAsset)

Aset feed halaman terpadu.

mobileAppAsset

object (MobileAppAsset)

Aset aplikasi seluler.

callAsset

object (UnifiedCallAsset)

Aset panggilan terpadu.

callToActionAsset

object (CallToActionAsset)

Aset pesan ajakan (CTA).

locationAsset

object (UnifiedLocationAsset)

Aset lokasi terpadu.

AssetType

Enum yang menjelaskan kemungkinan jenis aset.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
YOUTUBE_VIDEO Aset video YouTube.
MEDIA_BUNDLE Aset paket media.
IMAGE Aset gambar.
TEXT Aset teks.
LEAD_FORM Aset formulir prospek.
BOOK_ON_GOOGLE Aset Reservasi di Google.
PROMOTION Aset promosi.
CALLOUT Aset info.
STRUCTURED_SNIPPET Aset Ringkasan Terstruktur.
PAGE_FEED Aset Feed Halaman.
DYNAMIC_EDUCATION Aset Pendidikan Dinamis.
MOBILE_APP Aset aplikasi seluler.
HOTEL_CALLOUT Aset info hotel.
CALL Aset panggilan.
PRICE Aset harga.
CALL_TO_ACTION Aset pesan ajakan (CTA).
DYNAMIC_REAL_ESTATE Aset properti dinamis.
DYNAMIC_CUSTOM Aset kustom dinamis.
DYNAMIC_HOTELS_AND_RENTALS Aset hotel dan rental akomodasi dinamis.
DYNAMIC_FLIGHTS Aset penerbangan dinamis.
DYNAMIC_TRAVEL Aset perjalanan dinamis.
DYNAMIC_LOCAL Aset lokal dinamis.
DYNAMIC_JOBS Aset tugas dinamis.
LOCATION Aset lokasi.
HOTEL_PROPERTY Aset properti hotel.

AssetStatus

Kemungkinan status aset.

Enum
UNSPECIFIED Status belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini. Ini adalah nilai khusus respons.
ENABLED Aset diaktifkan.
REMOVED Aset dihapus.
ARCHIVED Aset diarsipkan.
PENDING_SYSTEM_GENERATED Aset ini dibuat oleh sistem yang menunggu peninjauan pengguna.

AssetEngineStatus

ID Berikutnya = 11

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SERVING Aset aktif.
SERVING_LIMITED Aset aktif dibatasi.
DISAPPROVED Aset tidak disetujui (tidak valid).
DISABLED Aset tidak aktif (tertunda).
REMOVED Aset telah dihapus.

YoutubeVideoAsset

Aset YouTube.

Representasi JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Kolom
youtubeVideoTitle

string

Judul video YouTube.

youtubeVideoId

string

ID video YouTube. Ini adalah nilai string 11 karakter yang digunakan dalam URL video YouTube.

ImageAsset

Aset gambar.

Representasi JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Kolom
mimeType

enum (MimeType)

Jenis MIME dari aset gambar.

fullSize

object (ImageDimension)

Metadata untuk gambar ini dalam ukuran aslinya.

fileSize

string (int64 format)

Ukuran file aset gambar dalam byte.

Jenis Mime

Jenis mime

Enum
UNSPECIFIED Jenis mime belum ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

IMAGE_JPEG Jenis MIME gambar/jpeg.
IMAGE_GIF Jenis MIME gambar/gif.
IMAGE_PNG Jenis MIME gambar/png.
FLASH Jenis MIME aplikasi/x-shockwave-flash.
TEXT_HTML Jenis MIME text/html.
PDF Jenis MIME dari application/pdf.
MSWORD Jenis MIME aplikasi/msword.
MSEXCEL Jenis MIME application/vnd.ms-excel.
RTF Jenis MIME application/rtf.
AUDIO_WAV Jenis MIME audio/wav.
AUDIO_MP3 Jenis MIME audio/mp3.
HTML5_AD_ZIP Jenis MIME application/x-html5-ad-zip.

ImageDimension

Metadata untuk gambar dengan ukuran tertentu, baik asli atau yang diubah ukurannya.

Representasi JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Kolom
heightPixels

string (int64 format)

Tinggi gambar.

widthPixels

string (int64 format)

Lebar gambar.

url

string

URL yang menampilkan gambar dengan tinggi dan lebar ini.

TextAsset

Aset teks.

Representasi JSON
{
  "text": string
}
Kolom
text

string

Konten teks dari aset teks.

UnifiedCalloutAsset

Aset info terpadu.

Representasi JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Kolom
calloutText

string

Teks info. Panjang string ini harus antara 1 dan 25, inklusif.

startDate

string

Tanggal mulai saat aset ini efektif dan dapat mulai ditayangkan, dalam format yyyy-MM-dd.

endDate

string

Tanggal terakhir saat aset ini efektif dan masih ditayangkan, dalam format yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Daftar jadwal yang tidak tumpang-tindih yang menentukan semua interval waktu kapan aset dapat ditayangkan. Anda dapat membuat maksimum 6 jadwal per hari, dengan total 42 jadwal.

useSearcherTimeZone

boolean

Apakah akan menampilkan aset dalam zona waktu pengguna penelusuran. Berlaku untuk Microsoft Ads.

AdScheduleInfo

Mewakili kriteria Jadwal Iklan.

Jadwal Iklan ditetapkan sebagai hari dan interval waktu saat iklan akan ditampilkan.

Tidak lebih dari enam Jadwal Iklan yang dapat ditambahkan untuk hari yang sama.

Representasi JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Kolom
startMinute

enum (MinuteOfHour)

Menit setelah jam mulai saat jadwal ini dimulai.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

endMinute

enum (MinuteOfHour)

Menit setelah jam berakhir saat jadwal ini berakhir. Jadwal ini tidak berlaku untuk menit berakhir.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

dayOfWeek

enum (DayOfWeek)

Hari saat jadwal diterapkan.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

startHour

integer

Jam mulai dalam waktu 24 jam. Kolom ini harus antara 0 dan 23, inklusif.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

endHour

integer

Jam berakhir dalam waktu 24 jam; 24 berarti penghujung hari. Kolom ini harus memiliki nilai antara 0 dan 24, inklusif.

Kolom ini wajib ada untuk operasi CREATE dan dilarang pada operasi UPDATE.

MinuteOfHour

Menghitung per kuartal. Misalnya, "FIFTEEN"

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
ZERO Nol menit dalam satu jam.
FIFTEEN Lima belas menit lewat satu jam.
THIRTY Tiga puluh menit lewat satu jam.
FORTY_FIVE Empat puluh lima menit lewat satu jam.

DayOfWeek

Menghitung hari, misalnya, "Monday".

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
MONDAY Senin.
TUESDAY Selasa.
WEDNESDAY Rabu.
THURSDAY Kamis.
FRIDAY Jumat.
SATURDAY Sabtu.
SUNDAY Minggu.

UnifiedSitelinkAsset

Aset sitelink terpadu.

Representasi JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Kolom
description1

string

Baris pertama deskripsi sitelink. Jika ditetapkan, panjangnya harus antara 1 dan 35, inklusif, dan description2 juga harus ditetapkan.

description2

string

Baris kedua deskripsi sitelink. Jika ditetapkan, panjangnya harus antara 1 dan 35, inklusif, dan description1 juga harus ditetapkan.

startDate

string

Tanggal mulai saat aset ini efektif dan dapat mulai ditayangkan, dalam format yyyy-MM-dd.

endDate

string

Tanggal terakhir saat aset ini efektif dan masih ditayangkan, dalam format yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Daftar jadwal yang tidak tumpang-tindih yang menentukan semua interval waktu kapan aset dapat ditayangkan. Anda dapat membuat maksimum 6 jadwal per hari, dengan total 42 jadwal.

trackingId

string (int64 format)

ID yang digunakan untuk melacak klik untuk aset sitelink. Ini adalah Yahoo! Japan saja.

useSearcherTimeZone

boolean

Apakah akan menampilkan aset sitelink dalam zona waktu pengguna penelusuran. Berlaku untuk Microsoft Ads.

mobilePreferred

boolean

Apakah preferensinya adalah untuk aset sitelink ditampilkan di perangkat seluler. Berlaku untuk Microsoft Ads.

UnifiedPageFeedAsset

Aset Feed Halaman Terpadu.

Representasi JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Kolom
pageUrl

string

Halaman yang ingin ditargetkan pengiklan.

labels[]

string

Label yang digunakan untuk mengelompokkan URL halaman.

MobileAppAsset

Aset yang mewakili aplikasi seluler.

Representasi JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Kolom
appId

string

Wajib. String yang mengidentifikasi aplikasi seluler secara unik. Kolom tersebut hanya boleh berisi ID native platform, seperti "com.android.ebay" untuk Android atau "12345689" untuk iOS.

appStore

enum (MobileAppVendor)

Wajib. App store yang mendistribusikan aplikasi khusus ini.

MobileAppVendor

Jenis vendor aplikasi seluler

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
APPLE_APP_STORE Vendor aplikasi seluler untuk Apple App Store.
GOOGLE_APP_STORE Vendor aplikasi seluler untuk Google App Store.

UnifiedCallAsset

Aset panggilan terpadu.

Representasi JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Kolom
countryCode

string

Kode negara dua huruf dari nomor telepon. Contoh: 'US', 'us'.

phoneNumber

string

Nomor telepon mentah pengiklan. Contoh: '1234567890', '(123)456-7890'

callConversionReportingState

enum (CallConversionReportingState)

Menunjukkan apakah CallAsset ini harus menggunakan setelan konversi panggilannya sendiri, mengikuti setelan tingkat akun, atau menonaktifkan konversi panggilan.

callConversionAction

string

Tindakan konversi yang akan dikaitkan dengan konversi panggilan. Jika tidak disetel, tindakan konversi default akan digunakan. Kolom ini hanya berpengaruh jika callConversionReportingState ditetapkan ke USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Daftar jadwal yang tidak tumpang-tindih yang menentukan semua interval waktu kapan aset dapat ditayangkan. Anda dapat membuat maksimum 6 jadwal per hari, dengan total 42 jadwal.

callOnly

boolean

Apakah panggilan hanya menampilkan nomor telepon tanpa link ke situs. Berlaku untuk Microsoft Ads.

callTrackingEnabled

boolean

Apakah panggilan harus diaktifkan pada pelacakan panggilan. Berlaku untuk Microsoft Ads.

useSearcherTimeZone

boolean

Apakah akan menampilkan ekstensi panggilan dalam zona waktu pengguna penelusuran. Berlaku untuk Microsoft Ads.

startDate

string

Tanggal mulai saat aset ini efektif dan dapat mulai ditayangkan, dalam format yyyy-MM-dd.

endDate

string

Tanggal terakhir saat aset ini efektif dan masih ditayangkan, dalam format yyyy-MM-dd.

CallConversionReportingState

Jenis data yang mungkin untuk status tindakan konversi panggilan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
DISABLED Tindakan konversi panggilan dinonaktifkan.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Tindakan konversi panggilan akan menggunakan jenis konversi panggilan yang ditetapkan di tingkat akun.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Tindakan konversi panggilan akan menggunakan jenis konversi panggilan yang ditetapkan di tingkat sumber daya (iklan khusus panggilan telepon/ekstensi panggilan).

CallToActionAsset

Aset pesan ajakan (CTA).

Representasi JSON
{
  "callToAction": enum (CallToActionType)
}
Kolom
callToAction

enum (CallToActionType)

Pesan ajakan (CTA).

CallToActionType

Enum yang menjelaskan kemungkinan jenis pesan ajakan (CTA).

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
LEARN_MORE Jenis pesan ajakan (CTA) adalah pelajari lebih lanjut.
GET_QUOTE Jenis pesan ajakan (CTA) adalah dapatkan penawaran harga.
APPLY_NOW Jenis pesan ajakan (CTA) diterapkan sekarang.
SIGN_UP Jenis pesan ajakan (CTA) adalah daftar.
CONTACT_US Jenis pesan ajakan (CTA) adalah hubungi kami.
SUBSCRIBE Jenis pesan ajakan (CTA) adalah berlangganan.
DOWNLOAD Jenis pesan ajakan (CTA) adalah download.
BOOK_NOW Jenis pesan ajakan (CTA) adalah pesan sekarang.
SHOP_NOW Jenis pesan ajakan (CTA) adalah belanja sekarang.
BUY_NOW Jenis pesan ajakan (CTA) adalah beli sekarang.
DONATE_NOW Jenis pesan ajakan (CTA) adalah beri donasi sekarang.
ORDER_NOW Jenis pesan ajakan (CTA) adalah pesan sekarang.
PLAY_NOW Jenis pesan ajakan (CTA) adalah putar sekarang.
SEE_MORE Jenis pesan ajakan (CTA) adalah opsi untuk melihat lebih banyak.
START_NOW Jenis pesan ajakan (CTA) dimulai sekarang.
VISIT_SITE Jenis pesan ajakan (CTA) adalah kunjungi situs.
WATCH_NOW Jenis pesan ajakan (CTA) adalah tonton sekarang.

UnifiedLocationAsset

Aset lokasi terpadu.

Representasi JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Kolom
placeId

string

ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Kolom ini bersifat unik untuk ID pelanggan dan jenis aset tertentu. Lihat https://developers.google.com/places/web-service/place-id untuk mempelajari ID Tempat lebih lanjut.

businessProfileLocations[]

object (BusinessProfileLocation)

Daftar lokasi bisnis untuk pelanggan. Informasi ini hanya akan ditampilkan jika Aset Lokasi disinkronkan dari akun Profil Bisnis. Anda dapat memiliki beberapa listingan Profil Bisnis dengan akun yang sama yang mengarah ke ID Tempat yang sama.

locationOwnershipType

enum (LocationOwnershipType)

Jenis kepemilikan lokasi. Jika jenisnya adalah BUSINESS_OWNER, jenis tersebut akan ditayangkan sebagai ekstensi lokasi. Jika jenisnya adalah AFILIASI, jenis tersebut akan ditampilkan sebagai lokasi afiliasi.

BusinessProfileLocation

Data lokasi Profil Bisnis yang disinkronkan dari akun Profil Bisnis tertaut.

Representasi JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Kolom
labels[]

string

Label yang ditentukan pengiklan untuk lokasi di akun Profil Bisnis. Data ini disinkronkan dari akun Profil Bisnis.

storeCode

string

Kode toko Profil Bisnis lokasi ini. Data ini disinkronkan dari akun Profil Bisnis.

listingId

string (int64 format)

ID listingan lokasi Profil Bisnis ini. Akun ini disinkronkan dari akun Profil Bisnis tertaut.

LocationOwnershipType

Kemungkinan jenis kepemilikan lokasi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
BUSINESS_OWNER Pemilik Bisnis lokasi(ekstensi lokasi lama - LE).
AFFILIATE Lokasi afiliasi(Ekstensi lokasi pihak ketiga - ALE).

AssetGroupAsset

AssetGroupAsset adalah penautan antara aset dan grup aset. Menambahkan AssetGroupAsset akan menautkan aset dengan grup aset.

Representasi JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Kolom
resourceName

string

Nama resource aset grup aset. Nama resource aset grup aset memiliki bentuk:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Grup aset yang ditautkan dengan aset grup aset ini.

asset

string

Aset yang ditautkan oleh aset grup aset ini.

fieldType

enum (AssetFieldType)

Deskripsi penempatan aset dalam grup aset. Misalnya: HEADLINE, YOUTUBE_VIDEO, dll.

status

enum (AssetLinkStatus)

Status penautan antara aset dan grup aset.

AssetFieldType

Enum yang menjelaskan kemungkinan penempatan suatu aset.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
HEADLINE Aset ditautkan untuk digunakan sebagai judul.
DESCRIPTION Aset ditautkan untuk digunakan sebagai deskripsi.
MANDATORY_AD_TEXT Aset ditautkan untuk digunakan sebagai teks iklan wajib.
MARKETING_IMAGE Aset ditautkan untuk digunakan sebagai gambar pemasaran.
MEDIA_BUNDLE Aset ditautkan untuk digunakan sebagai paket media.
YOUTUBE_VIDEO Aset ditautkan untuk digunakan sebagai video YouTube.
BOOK_ON_GOOGLE Aset ditautkan untuk menunjukkan bahwa kampanye hotel adalah "Reservasi di Google" mengaktifkan pembuatan versi.
LEAD_FORM Aset ditautkan untuk digunakan sebagai ekstensi Formulir Prospek.
PROMOTION Aset ditautkan untuk digunakan sebagai ekstensi Promosi.
CALLOUT Aset ini ditautkan untuk digunakan sebagai ekstensi Info.
STRUCTURED_SNIPPET Aset ini ditautkan untuk digunakan sebagai ekstensi Ringkasan Terstruktur.
MOBILE_APP Aset ditautkan untuk digunakan sebagai ekstensi Aplikasi Seluler.
HOTEL_CALLOUT Aset ini ditautkan untuk digunakan sebagai ekstensi Info Hotel.
CALL Aset ditautkan untuk digunakan sebagai Ekstensi panggilan.
PRICE Aset ditautkan untuk digunakan sebagai Ekstensi harga.
LONG_HEADLINE Aset ini ditautkan untuk digunakan sebagai judul panjang.
BUSINESS_NAME Aset ditautkan untuk digunakan sebagai nama bisnis.
SQUARE_MARKETING_IMAGE Aset ditautkan untuk digunakan sebagai gambar pemasaran persegi.
PORTRAIT_MARKETING_IMAGE Aset ditautkan untuk digunakan sebagai gambar pemasaran potret.
VIDEO Aset ditautkan untuk digunakan sebagai logo non-YouTube.
CALL_TO_ACTION_SELECTION Aset ditautkan agar dapat digunakan untuk memilih pesan ajakan (CTA).
AD_IMAGE Aset ditautkan agar dapat digunakan untuk memilih gambar iklan.
HOTEL_PROPERTY Aset ini ditautkan untuk digunakan sebagai properti hotel dalam kampanye Performa Maksimal untuk sasaran perjalanan.

AssetGroupSignal

AssetGroupSignal mewakili sinyal di grup aset. Keberadaan sinyal akan memberi tahu kampanye Performa Maksimal yang paling cenderung akan melakukan konversi. Performa Maksimal menggunakan sinyal tersebut untuk mencari orang baru yang memiliki niat yang serupa atau lebih kuat guna menemukan konversi di Penelusuran, Display, Video, dan lainnya.

Representasi JSON
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Kolom
resourceName

string

Nama resource sinyal grup aset. Nama resource sinyal grup aset memiliki bentuk:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Grup aset yang mencakup sinyal grup aset ini.

Kolom union signal. Sinyal grup aset. signal hanya dapat berupa salah satu dari berikut:
audience

object (AudienceInfo)

Sinyal audiens yang akan digunakan oleh kampanye Performa Maksimal.

AudienceInfo

Kriteria audiens.

Representasi JSON
{
  "audience": string
}
Kolom
audience

string

Nama resource Audiens.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter mewakili node hierarki filter grup listingan di grup aset.

Representasi JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Kolom
resourceName

string

Nama resource filter grup listingan grup aset. Nama resource filter grup listingan grup aset memiliki bentuk:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Grup aset yang mencakup filter grup listingan grup aset ini.

id

string (int64 format)

ID ListingGroupFilter.

type

enum (ListingGroupFilterType)

Jenis node filter grup listingan.

vertical

enum (ListingGroupFilterVertical)

Vertikal yang diwakili oleh pohon node saat ini. Semua node pada pohon yang sama harus berada pada vertical yang sama.

caseValue

object (ListingGroupFilterDimension)

Nilai dimensi yang digunakan grup listingan ini untuk menyempurnakan induknya. Tidak ditentukan untuk grup root.

parentListingGroupFilter

string

Nama resource subdivisi grup listingan induk. Null untuk node filter grup listingan root.

path

object (ListingGroupFilterDimensionPath)

Jalur dimensi yang menentukan filter grup listingan ini.

ListingGroupFilterType

Jenis filter grup listingan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SUBDIVISION Subdivisi produk sepanjang beberapa dimensi listingan.
UNIT_INCLUDED Node daun filter grup listingan yang disertakan.
UNIT_EXCLUDED Node daun filter grup listingan yang dikecualikan.

ListingGroupFilterVertical

Jenis filter vertikal grup listingan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SHOPPING Mewakili vertikal belanja. Vertical hanya diizinkan di kampanye Performa Maksimal untuk Retail.

ListingGroupFilterDimension

Dimensi listingan untuk filter grup listingan grup aset.

Representasi JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Kolom
Kolom union dimension. Dimensi dari salah satu jenis di bawah selalu ada. dimension hanya dapat berupa salah satu dari berikut:
productBiddingCategory

object (ProductBiddingCategory)

Kategori bidding dari penawaran produk.

productBrand

object (ProductBrand)

Merek dari penawaran produk.

productChannel

object (ProductChannel)

Lokalitas penawaran produk.

productCondition

object (ProductCondition)

Ketentuan penawaran produk.

productCustomAttribute

object (ProductCustomAttribute)

Atribut khusus dari penawaran produk.

productItemId

object (ProductItemId)

ID item penawaran produk.

productType

object (ProductType)

Jenis penawaran produk.

ProductBiddingCategory

Satu elemen kategori bidding di tingkat tertentu. Kategori tingkat teratas berada di tingkat 1, anak mereka di tingkat 2, dan seterusnya. Saat ini kami mendukung hingga 5 level. Pengguna harus menentukan jenis dimensi yang menunjukkan tingkat kategori. Semua kasus subdivisi yang sama harus memiliki jenis dimensi yang sama (tingkat kategori).

Representasi JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Kolom
level

enum (ListingGroupFilterBiddingCategoryLevel)

Menunjukkan tingkat kategori dalam taksonomi.

id

string (int64 format)

ID kategori bidding produk.

ID ini setara dengan ID google_product_category seperti yang dijelaskan dalam artikel ini: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

Tingkat kategori bidding filter grup listingan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
LEVEL1 Tingkat 1.
LEVEL2 Tingkat 2.
LEVEL3 Tingkat 3.
LEVEL4 Tingkat 4.
LEVEL5 Tingkat 5.

ProductBrand

Merek produk.

Representasi JSON
{
  "value": string
}
Kolom
value

string

Nilai string merek produk.

ProductChannel

Lokalitas penawaran produk.

Representasi JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Kolom
channel

enum (ListingGroupFilterProductChannel)

Nilai lokalitas.

ListingGroupFilterProductChannel

Enum yang menjelaskan lokalitas penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ONLINE Item tersebut dijual secara online.
LOCAL Item dijual di toko lokal.

ProductCondition

Ketentuan penawaran produk.

Representasi JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Kolom
condition

enum (ListingGroupFilterProductCondition)

Nilai kondisi.

ListingGroupFilterProductCondition

Enum yang mendeskripsikan kondisi penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
NEW Kondisi produk baru.
REFURBISHED Kondisi produk adalah refurbished.
USED Kondisi produk digunakan.

ProductCustomAttribute

Atribut khusus dari penawaran produk.

Representasi JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Kolom
index

enum (ListingGroupFilterCustomAttributeIndex)

Menunjukkan indeks atribut khusus.

value

string

Nilai string atribut khusus produk.

ListingGroupFilterCustomAttributeIndex

Indeks atribut pelanggan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
INDEX0 Atribut khusus filter grup listingan pertama.
INDEX1 Atribut khusus filter grup listingan kedua.
INDEX2 Atribut khusus filter grup listingan ketiga.
INDEX3 Atribut khusus filter grup listingan keempat.
INDEX4 Atribut khusus filter grup listingan kelima.

ProductItemId

ID item penawaran produk.

Representasi JSON
{
  "value": string
}
Kolom
value

string

Nilai ID.

ProductType

Jenis penawaran produk.

Representasi JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Kolom
level

enum (ListingGroupFilterProductTypeLevel)

Tingkat jenis.

value

string

Nilai jenis.

ListingGroupFilterProductTypeLevel

Enum yang mendeskripsikan tingkat jenis penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
LEVEL1 Tingkat 1.
LEVEL2 Tingkat 2.
LEVEL3 Tingkat 3.
LEVEL4 Tingkat 4.
LEVEL5 Tingkat 5.

ListingGroupFilterDimensionPath

Jalur yang menentukan dimensi yang menentukan filter grup listingan.

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

object (ListingGroupFilterDimension)

Jalur lengkap dimensi melalui hierarki filter grup listingan (tidak termasuk node root) ke filter grup listingan ini.

AssetGroupTopCombinationView

Tampilan tentang penggunaan kombinasi aset iklan grup iklan.

Representasi JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Kolom
resourceName

string

Nama resource tampilan kombinasi teratas grup aset. Nama resource tampilan Kombinasi Teratas AssetGroup memiliki bentuk: `"customers/{customerId}/assetGroupTopKombinasiViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Kombinasi aset teratas yang ditayangkan bersama.

AssetGroupAssetCombinationData

Data kombinasi aset dalam grup aset

Representasi JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Kolom
assetCombinationServedAssets[]

object (AssetUsage)

Aset yang ditayangkan.

AssetUsage

Berisi informasi penggunaan aset.

Representasi JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Kolom
asset

string

Nama resource aset.

servedAssetFieldType

enum (ServedAssetFieldType)

Jenis kolom aset yang ditayangkan.

ServedAssetFieldType

Jenis kolom aset yang memungkinkan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

HEADLINE_1 Aset digunakan pada judul 1.
HEADLINE_2 Aset digunakan pada judul 2.
HEADLINE_3 Aset digunakan pada judul 3.
DESCRIPTION_1 Aset digunakan dalam deskripsi 1.
DESCRIPTION_2 Aset digunakan dalam deskripsi 2.
HEADLINE Aset digunakan dalam judul. Gunakan ini hanya jika hanya ada satu judul dalam iklan. Jika tidak, gunakan enum HEADLINE_1, HEADLINE_2, atau HEADLINE_3
HEADLINE_IN_PORTRAIT Aset digunakan sebagai judul pada gambar potret.
LONG_HEADLINE Aset digunakan dalam judul panjang (digunakan dalam MultiAssetResponsiveAd).
DESCRIPTION Aset digunakan dalam deskripsi. Gunakan atribut ini hanya jika hanya ada satu deskripsi dalam iklan. Jika tidak, gunakan enum DESCRIPTION_1 atau DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT Aset digunakan sebagai deskripsi dalam gambar potret.
BUSINESS_NAME_IN_PORTRAIT Aset digunakan sebagai nama bisnis dalam gambar potret.
BUSINESS_NAME Aset digunakan sebagai nama bisnis.
MARKETING_IMAGE Aset digunakan sebagai gambar pemasaran.
MARKETING_IMAGE_IN_PORTRAIT Aset digunakan sebagai gambar pemasaran dalam gambar potret.
SQUARE_MARKETING_IMAGE Aset digunakan sebagai gambar pemasaran persegi.
PORTRAIT_MARKETING_IMAGE Aset digunakan sebagai gambar pemasaran potret.
CALL_TO_ACTION Aset digunakan sebagai pesan ajakan (CTA).
YOU_TUBE_VIDEO Aset digunakan sebagai video YouTube.
CALL Aset ini digunakan sebagai panggilan.
MOBILE_APP Aset ini digunakan sebagai aplikasi seluler.
CALLOUT Aset ini digunakan sebagai info.
STRUCTURED_SNIPPET Aset ini digunakan sebagai ringkasan terstruktur.
PRICE Aset ini digunakan sebagai harga.
PROMOTION Aset ini digunakan sebagai promosi.
AD_IMAGE Aset ini digunakan sebagai gambar.
LEAD_FORM Aset digunakan sebagai formulir prospek.

AssetGroup

Grup aset. AssetGroupAsset digunakan untuk menautkan aset ke grup aset. AssetGroupSignal digunakan untuk mengaitkan sinyal ke grup aset.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Kolom
resourceName

string

Nama resource grup aset. Nama resource grup aset memiliki bentuk:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

ID grup aset.

campaign

string

Kampanye yang terkait dengan grup aset ini. Aset yang ditautkan ke grup aset.

name

string

Wajib. Nama grup aset. Wajib. ID harus memiliki panjang minimum 1 dan panjang maksimum 128. ID ini harus unik dalam kampanye.

finalUrls[]

string

Daftar URL final setelah semua pengalihan lintas-domain. Di Performa Maksimal, secara default, URL memenuhi syarat untuk perluasan kecuali jika dinonaktifkan.

finalMobileUrls[]

string

Daftar URL seluler final setelah semua pengalihan lintas domain. Di Performa Maksimal, secara default, URL memenuhi syarat untuk perluasan kecuali jika dinonaktifkan.

status

enum (AssetGroupStatus)

Status grup aset.

path1

string

Bagian pertama teks yang mungkin muncul, ditambahkan ke URL yang ditampilkan di iklan.

path2

string

Bagian kedua dari teks yang mungkin muncul, ditambahkan ke URL yang ditampilkan di iklan. Kolom ini hanya dapat ditetapkan jika jalur1 ditetapkan.

adStrength

enum (AdStrength)

Daya iklan keseluruhan grup aset ini.

AssetGroupStatus

Kemungkinan status grup aset.

Enum
UNSPECIFIED Status belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini.
ENABLED Grup aset diaktifkan.
PAUSED Grup aset dijeda.
REMOVED Grup aset akan dihapus.

AdStrength

Enum yang mencantumkan kemungkinan daya iklan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
PENDING Daya iklan saat ini tertunda.
NO_ADS Tidak ada iklan yang dapat dibuat.
POOR Kekuatan yang buruk.
AVERAGE Kekuatan rata-rata.
GOOD Kekuatan yang bagus.
EXCELLENT Kekuatan luar biasa.

AssetSetAsset

AssetSetAsset adalah link antara aset dan kumpulan aset. Menambahkan AssetSetAsset akan menautkan aset dengan kumpulan aset.

Representasi JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Kolom
resourceName

string

Nama resource dari aset kumpulan aset. Nama resource aset kumpulan aset memiliki bentuk:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

Kumpulan aset yang ditautkan ke aset kumpulan aset ini.

asset

string

Aset yang ditautkan ke aset kumpulan aset ini.

status

enum (AssetSetAssetStatus)

Status aset kumpulan aset. Hanya baca.

AssetSetAssetStatus

Status yang mungkin dari aset kumpulan aset.

Enum
UNSPECIFIED Status belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini. Ini adalah nilai khusus respons.
ENABLED Aset kumpulan aset diaktifkan.
REMOVED Aset kumpulan aset dihapus.

AssetSet

Kumpulan aset yang mewakili sekumpulan aset. Menggunakan AssetSetAsset untuk menautkan aset ke kumpulan aset.

Representasi JSON
{
  "id": string,
  "resourceName": string
}
Kolom
id

string (int64 format)

ID kumpulan aset.

resourceName

string

Nama resource kumpulan aset. Nama resource kumpulan aset memiliki bentuk:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Strategi bidding.

Representasi JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Kolom
resourceName

string

Nama resource strategi bidding. Nama resource strategi bidding memiliki bentuk:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

Status strategi bidding.

Kolom ini bersifat hanya baca.

type

enum (BiddingStrategyType)

Jenis strategi bidding. Buat strategi bidding dengan menetapkan skema bidding.

Kolom ini bersifat hanya baca.

currencyCode

string

Mata uang yang digunakan oleh strategi bidding (kode tiga huruf ISO 4217).

Untuk strategi bidding di pelanggan pengelola, mata uang ini dapat ditetapkan saat pembuatan dan ditetapkan secara default ke mata uang pelanggan pengelola. Untuk melayani pelanggan, kolom ini tidak dapat ditetapkan; semua strategi dalam melayani pelanggan secara implisit menggunakan mata uang pelanggan yang melayani. Dalam semua kasus, kolom effectiveCurrencyCode akan menampilkan mata uang yang digunakan oleh strategi.

id

string (int64 format)

ID strategi bidding.

name

string

Nama strategi bidding. Semua strategi bidding dalam akun harus diberi nama secara berbeda.

Panjang string ini harus antara 1 dan 255, inklusif, dalam UTF-8 byte, (dipangkas).

effectiveCurrencyCode

string

Mata uang yang digunakan oleh strategi bidding (kode tiga huruf ISO 4217).

Untuk strategi bidding pada pelanggan pengelola, ini adalah mata uang yang ditetapkan oleh pengiklan saat membuat strategi. Untuk melayani pelanggan, ini adalah currencyCode pelanggan.

Metrik strategi bidding dilaporkan dalam mata uang ini.

Kolom ini bersifat hanya baca.

campaignCount

string (int64 format)

Jumlah kampanye yang disertakan pada strategi bidding ini.

Kolom ini bersifat hanya baca.

nonRemovedCampaignCount

string (int64 format)

Jumlah kampanye yang tidak dihapus yang disertakan ke strategi bidding ini.

Kolom ini bersifat hanya baca.

Kolom union scheme. Skema bidding.

Hanya satu yang dapat ditetapkan. scheme hanya dapat berupa salah satu dari yang berikut:

enhancedCpc

object (EnhancedCpc)

Strategi bidding yang menaikkan bid untuk klik yang cenderung tidak menghasilkan konversi dan menurunkannya untuk klik yang kemungkinannya kecil.

maximizeConversionValue

object (MaximizeConversionValue)

Strategi bidding otomatis guna membantu mendapatkan nilai konversi sebanyak mungkin untuk kampanye sekaligus membelanjakan anggaran Anda.

maximizeConversions

object (MaximizeConversions)

Strategi bidding otomatis guna membantu mendapatkan konversi terbanyak sekaligus membelanjakan anggaran Anda.

targetCpa

object (TargetCpa)

Strategi bidding yang menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin sesuai target biaya per akuisisi (CPA) yang Anda tetapkan.

targetImpressionShare

object (TargetImpressionShare)

Strategi bidding yang secara otomatis mengoptimalkan persentase tayangan yang dipilih.

targetOutrankShare

object (TargetOutrankShare)

Strategi bidding yang menetapkan bid berdasarkan bagian target lelang di mana pengiklan harus mengungguli pesaing tertentu. Kolom ini tidak lagi digunakan. Pembuatan strategi bidding baru dengan kolom ini atau menyertakan strategi bidding dengan kolom ini ke kampanye akan gagal. Mutasi ke strategi yang telah mengisi skema ini diizinkan.

targetRoas

object (TargetRoas)

Strategi bidding yang membantu Anda memaksimalkan pendapatan sekaligus menghitung rata-rata target Laba Atas Belanja Iklan (ROAS) tertentu.

targetSpend

object (TargetSpend)

Strategi bidding yang menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai anggaran Anda.

BiddingStrategyStatus

Kemungkinan status Strategi Bidding.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

ENABLED Strategi bidding diaktifkan.
REMOVED Strategi bidding dihapus.

BiddingStrategyType

Enum yang menjelaskan kemungkinan jenis strategi bidding.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
COMMISSION Komisi adalah strategi bidding otomatis yang mengharuskan pengiklan membayar sebagian nilai konversi.
ENHANCED_CPC Enhanced CPC adalah strategi bidding yang menaikkan bid untuk klik yang cenderung menghasilkan konversi dan menurunkannya untuk klik yang kemungkinannya kecil.
INVALID Hanya digunakan untuk nilai yang ditampilkan. Menunjukkan bahwa kampanye tidak memiliki strategi bidding. Tindakan ini mencegah kampanye ditayangkan. Misalnya, kampanye dapat dikaitkan ke strategi bidding pengelola dan akun penayangan kemudian dibatalkan tautannya dari akun pengelola. Dalam hal ini, kampanye akan otomatis dilepaskan dari strategi bidding pengelola yang sekarang tidak dapat diakses dan beralih ke jenis strategi bidding TIDAK VALID.
MANUAL_CPA Strategi bidding manual yang memungkinkan pengiklan menetapkan bid per tindakan yang ditentukan pengiklan.
MANUAL_CPC Bidding berbasis klik manual yang mengharuskan pengguna membayar per klik.
MANUAL_CPM Bidding berbasis tayangan manual yang mengharuskan pengguna membayar per seribu tayangan iklan.
MANUAL_CPV Strategi bidding yang membayar jumlah yang dapat dikonfigurasi per jumlah tontonan video.
MAXIMIZE_CONVERSIONS Strategi bidding yang secara otomatis memaksimalkan jumlah konversi sesuai anggaran harian.
MAXIMIZE_CONVERSION_VALUE Strategi bidding otomatis yang secara otomatis menetapkan bid untuk memaksimalkan pendapatan sekaligus membelanjakan anggaran Anda.
PAGE_ONE_PROMOTED Skema bidding Halaman Pertama Dipromosikan, yang menetapkan bid CPC maks untuk menargetkan tayangan iklan di halaman pertama atau halaman pertama slot yang dipromosikan di google.com. Nilai enum ini tidak digunakan lagi.
PERCENT_CPC Persentase CPC adalah strategi bidding yang bid-nya merupakan pecahan dari harga yang diiklankan untuk beberapa barang atau layanan.
TARGET_CPA Target CPA adalah strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin sesuai dengan target biaya per akuisisi (CPA) yang Anda tetapkan.
TARGET_CPM Target CPM adalah strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan tayangan sebanyak mungkin sesuai target biaya per seribu tayangan iklan (CPM) yang Anda tetapkan.
TARGET_IMPRESSION_SHARE Strategi bidding otomatis yang menetapkan bid sehingga persentase iklan penelusuran tertentu ditampilkan di bagian atas halaman pertama (atau target lokasi lainnya).
TARGET_OUTRANK_SHARE Target Melampaui Kompetitor adalah strategi bidding otomatis yang menetapkan bid berdasarkan bagian target lelang di mana pengiklan harus mengungguli pesaing tertentu. Nilai enum ini tidak digunakan lagi.
TARGET_ROAS Target ROAS adalah strategi bidding otomatis yang membantu Anda memaksimalkan pendapatan sekaligus menghitung rata-rata target Laba Atas Belanja Rata-Rata (ROAS) tertentu.
TARGET_SPEND Target Pembelanjaan adalah strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai dengan anggaran Anda.

EnhancedCpc

Jenis ini tidak memiliki kolom.

Strategi bidding otomatis yang menaikkan bid untuk klik yang cenderung menghasilkan konversi dan menurunkannya untuk klik yang cenderung tidak menghasilkan konversi.

Strategi bidding ini tidak digunakan lagi dan tidak dapat dibuat lagi. Gunakan ManualCpc dengan enhancedCpcEnabled yang disetel ke benar (true) untuk fungsi yang setara.

MaximizeConversionValue

Strategi bidding otomatis guna membantu mendapatkan nilai konversi sebanyak mungkin untuk kampanye sekaligus membelanjakan anggaran Anda.

Representasi JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Kolom
cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Hanya dapat diubah untuk strategi bidding portofolio.

cpcBidFloorMicros

string (int64 format)

Batas bid minimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Hanya dapat diubah untuk strategi bidding portofolio.

targetRoas

number

Opsi target laba atas belanja iklan (ROAS). Jika ditetapkan, strategi bidding akan memaksimalkan pendapatan sekaligus menghitung rata-rata target laba atas belanja iklan. Jika target ROAS tinggi, strategi bidding mungkin tidak dapat membelanjakan seluruh anggaran. Jika target ROAS tidak ditetapkan, strategi bidding akan berupaya mencapai ROAS setinggi mungkin sesuai anggaran.

MaximizeConversions

Strategi bidding otomatis guna membantu mendapatkan konversi terbanyak sekaligus membelanjakan anggaran Anda.

Representasi JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Kolom
cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Hanya dapat diubah untuk strategi bidding portofolio.

cpcBidFloorMicros

string (int64 format)

Batas bid minimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Hanya dapat diubah untuk strategi bidding portofolio.

targetCpaMicros

string (int64 format)

Opsi target biaya per tindakan (CPA). Ini adalah jumlah rata-rata yang ingin Anda belanjakan per tindakan konversi yang ditentukan dalam unit mikro mata uang strategi bidding. Jika ditetapkan, strategi bidding akan mendapatkan konversi sebanyak mungkin sesuai atau di bawah target biaya per tindakan. Jika target CPA tidak ditetapkan, strategi bidding akan berupaya mencapai CPA serendah mungkin sesuai anggaran.

TargetCpa

Strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin sesuai dengan target biaya per akuisisi (CPA) yang Anda tetapkan.

Representasi JSON
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Kolom
targetCpaMicros

string (int64 format)

Target CPA rata-rata. Target ini harus lebih besar dari atau sama dengan unit minimum yang dapat ditagih berdasarkan mata uang untuk akun.

cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Kolom ini hanya boleh ditetapkan untuk strategi bidding portofolio.

cpcBidFloorMicros

string (int64 format)

Batas bid minimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Kolom ini hanya boleh ditetapkan untuk strategi bidding portofolio.

TargetImpressionShare

Strategi bidding otomatis yang menetapkan bid sehingga persentase iklan penelusuran tertentu ditampilkan di bagian atas halaman pertama (atau target lokasi lainnya).

Representasi JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Kolom
location

enum (TargetImpressionShareLocation)

Target lokasi pada halaman hasil penelusuran.

locationFractionMicros

string (int64 format)

Bagian iklan yang dipilih untuk ditampilkan di target lokasi dalam mikro. Misalnya, 1% sama dengan 10.000.

cpcBidCeilingMicros

string (int64 format)

Bid CPC tertinggi yang diizinkan untuk ditentukan oleh sistem bidding otomatis. Ini adalah bidang wajib yang dimasukkan oleh pengiklan yang menetapkan batas maksimal dan ditentukan dalam mikro lokal.

TargetImpressionShareLocation

Enum yang menjelaskan kemungkinan sasaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ANYWHERE_ON_PAGE Lokasi mana pun di halaman web.
TOP_OF_PAGE Kotak atas iklan.
ABSOLUTE_TOP_OF_PAGE Slot teratas di kotak iklan bagian atas.

TargetOutrankShare

Strategi bidding otomatis yang menetapkan bid berdasarkan bagian target lelang di mana pengiklan harus mengungguli pesaing tertentu. Strategi ini tidak digunakan lagi.

Representasi JSON
{
  "cpcBidCeilingMicros": string
}
Kolom
cpcBidCeilingMicros

string (Int64Value format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut.

TargetRoas

Strategi bidding otomatis yang membantu Anda memaksimalkan pendapatan sekaligus menghitung rata-rata target laba atas belanja iklan (ROAS) tertentu.

Representasi JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Kolom
targetRoas

number

Wajib. Pendapatan yang dipilih (berdasarkan data konversi) per unit pembelanjaan. Nilai harus antara 0,01 dan 1000,0.

cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Kolom ini hanya boleh ditetapkan untuk strategi bidding portofolio.

cpcBidFloorMicros

string (int64 format)

Batas bid minimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut. Kolom ini hanya boleh ditetapkan untuk strategi bidding portofolio.

TargetSpend

Strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai anggaran Anda.

Representasi JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Kolom
targetSpendMicros
(deprecated)

string (int64 format)

Tidak berlaku lagi: Target pembelanjaan untuk memaksimalkan klik. Bidder TargetSpend akan mencoba membelanjakan jumlah yang lebih kecil dari nilai ini atau jumlah pembelanjaan throttling alami. Jika tidak ditentukan, anggaran digunakan sebagai target pembelanjaan. Kolom ini tidak digunakan lagi dan tidak boleh digunakan lagi. Lihat https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html untuk mengetahui detailnya.

cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut.

CampaignBudget

Anggaran kampanye.

Representasi JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Kolom
resourceName

string

Nama resource anggaran kampanye. Nama resource anggaran kampanye memiliki bentuk:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Metode penayangan yang menentukan tarif yang digunakan untuk membelanjakan anggaran kampanye.

Jika tidak ditentukan dalam operasi pembuatan, setelan defaultnya adalah STANDARD.

period

enum (BudgetPeriod)

Periode waktu untuk membelanjakan anggaran. Jika tidak ditentukan, setelan defaultnya adalah DAILY.

amountMicros

string (int64 format)

Jumlah anggaran, dalam mata uang lokal untuk akun. Jumlah ditentukan dalam mikro, dengan satu juta setara dengan satu unit mata uang. Pembelanjaan bulanan dibatasi sebesar 30,4 kali lipat jumlah ini.

BudgetDeliveryMethod

Kemungkinan metode penayangan Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
STANDARD Server anggaran akan men-throttle penayangan secara merata di seluruh jangka waktu.
ACCELERATED Server anggaran tidak akan men-throttle penayangan, dan iklan akan ditayangkan secepat mungkin.

BudgetPeriod

Kemungkinan periode Anggaran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
DAILY Anggaran harian.
FIXED_DAILY Anggaran harian tetap.
CUSTOM_PERIOD Anggaran khusus dapat digunakan dengan total_amount untuk menentukan batas anggaran sepanjang waktu.

Kampanye

Kampanye.

Representasi JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Kolom
resourceName

string

Nama resource kampanye. Nama resource kampanye memiliki bentuk:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Status kampanye.

Saat kampanye baru ditambahkan, status secara default adalah DIAKTIFKAN.

servingStatus

enum (CampaignServingStatus)

Status penayangan iklan kampanye.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Status sistem strategi bidding kampanye.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Status pengoptimalan penayangan iklan kampanye.

advertisingChannelType

enum (AdvertisingChannelType)

Target penayangan utama untuk iklan dalam kampanye. Opsi penargetan dapat ditingkatkan di networkSettings.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat kampanye baru.

Hanya dapat ditetapkan saat membuat kampanye. Setelah kampanye dibuat, kolom tidak dapat diubah.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Penajaman opsional pada advertisingChannelType. Harus berupa subjenis yang valid dari jenis saluran induk.

Hanya dapat ditetapkan saat membuat kampanye. Setelah kampanye dibuat, kolom tidak dapat diubah.

urlCustomParameters[]

object (CustomParameter)

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

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Setelan untuk Bidding Real-Time, fitur yang hanya tersedia untuk kampanye yang menargetkan jaringan Ad Exchange.

networkSettings

object (NetworkSettings)

Setelan jaringan untuk kampanye.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Setelan untuk mengontrol Iklan Penelusuran Dinamis (DSA).

shoppingSetting

object (ShoppingSetting)

Setelan untuk mengontrol kampanye Shopping.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Setelan untuk penargetan-geo iklan.

labels[]

string

Nama resource label yang disertakan ke kampanye ini.

biddingStrategyType

enum (BiddingStrategyType)

Jenis strategi bidding.

Strategi bidding dapat dibuat dengan menetapkan skema bidding untuk membuat strategi bidding standar atau kolom biddingStrategy untuk membuat strategi bidding portofolio.

Kolom ini bersifat hanya baca.

accessibleBiddingStrategy

string

Nama referensi AccessibleBiddingStrategy, tampilan hanya baca dari atribut yang tidak dibatasi dari strategi bidding portofolio terlampir yang diidentifikasi oleh 'biddingStrategy'. Kosong, jika kampanye tidak menggunakan strategi portofolio. Atribut strategi tidak terbatas tersedia untuk semua pelanggan yang diajak berbagi strategi dan dibaca dari referensi AccessibleBiddingStrategy. Sebaliknya, atribut yang dibatasi hanya tersedia untuk pelanggan pemilik strategi dan pengelolanya. Atribut yang dibatasi hanya dapat dibaca dari referensi BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Daftar yang membatasi frekuensi setiap pengguna akan melihat iklan kampanye ini.

selectiveOptimization

object (SelectiveOptimization)

Setelan pengoptimalan selektif untuk kampanye ini, yang mencakup kumpulan tindakan konversi untuk mengoptimalkan kampanye ini. Fitur ini hanya berlaku untuk kampanye Aplikasi yang menggunakan MULTI_CHANNEL sebagai AdvertisingChannelType dan APP_CAMPAIGN atau APP_CAMPAIGN_FOR_ENGAGEMENT sebagai AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Setelan sasaran pengoptimalan untuk kampanye ini, yang mencakup kumpulan jenis sasaran pengoptimalan.

trackingSetting

object (TrackingSetting)

Setelan tingkat kampanye untuk informasi pelacakan.

engineId

string

ID kampanye di akun mesin eksternal. Kolom ini hanya untuk akun non-Google Ads, misalnya, Yahoo Japan, Microsoft, Baidu, dll. Untuk entitas Google Ads, gunakan "campaign.id" sebagai gantinya.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Jenis kolom aset yang harus dikecualikan dari kampanye ini. Link aset dengan jenis kolom ini tidak akan diwarisi oleh kampanye ini dari tingkat atas.

createTime

string

Stempel waktu saat kampanye ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font. createTime tidak akan digunakan lagi dalam v1. Sebagai gantinya, gunakan creationTime.

creationTime

string

Stempel waktu saat kampanye ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

lastModifiedTime

string

Tanggal dan waktu saat kampanye ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

id

string (int64 format)

ID kampanye.

name

string

Nama kampanye.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat kampanye baru.

Parameter ini tidak boleh berisi karakter null (titik kode 0x0), line feed NL (titik kode 0xA), atau enter (titik kode 0xD).

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan.

campaignBudget

string

Anggaran kampanye.

startDate

string

Tanggal saat kampanye dimulai dalam menayangkan zona waktu pelanggan dalam format YYYY-MM-DD.

endDate

string

Hari terakhir kampanye dalam menayangkan zona waktu pelanggan dalam format YYYY-MM-DD. Saat pembuatan, defaultnya adalah 2037-12-30, yang berarti kampanye akan berjalan tanpa batas. Untuk menetapkan kampanye yang ada agar berjalan tanpa batas waktu, tetapkan kolom ini ke 2037-12-30.

finalUrlSuffix

string

Akhiran yang digunakan untuk menambahkan parameter kueri ke halaman landing yang ditayangkan dengan pelacakan paralel.

urlExpansionOptOut

boolean

Mewakili penonaktifan perluasan URL ke URL yang lebih ditargetkan. Jika memilih tidak ikut (benar), hanya URL final di grup aset atau URL yang ditentukan di feed data bisnis atau Google Merchant Center pengiklan yang akan ditargetkan. Jika diikutsertakan (salah), seluruh domain akan ditargetkan. Kolom ini hanya dapat ditetapkan untuk kampanye Performa Maksimal, yang nilai defaultnya adalah false.

Kolom union campaign_bidding_strategy. Strategi bidding untuk kampanye.

Harus berupa portofolio (dibuat melalui layanan BiddingStrategy) atau standar, yang disematkan ke dalam kampanye. campaign_bidding_strategy hanya dapat berupa salah satu dari yang berikut:

biddingStrategy

string

Strategi bidding portofolio yang digunakan oleh kampanye.

manualCpa

object (ManualCpa)

Strategi bidding CPA Manual standar. Strategi bidding manual yang memungkinkan pengiklan menetapkan bid per tindakan yang ditentukan pengiklan. Hanya didukung untuk kampanye Jasa dan Servis.

manualCpc

object (ManualCpc)

Strategi bidding CPC Manual Standar. Bidding berbasis klik manual yang mengharuskan pengguna membayar per klik.

manualCpm

object (ManualCpm)

Strategi bidding CPM Manual Standar. Bidding berbasis tayangan manual yang mengharuskan pengguna membayar per seribu tayangan iklan.

maximizeConversions

object (MaximizeConversions)

Strategi bidding Maksimalkan Konversi Standar yang secara otomatis memaksimalkan jumlah konversi sekaligus membelanjakan anggaran Anda.

maximizeConversionValue

object (MaximizeConversionValue)

Strategi bidding Maksimalkan Nilai Konversi Standar yang secara otomatis menetapkan bid untuk memaksimalkan pendapatan sekaligus membelanjakan anggaran Anda.

targetCpa

object (TargetCpa)

Strategi bidding Target CPA standar yang secara otomatis menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin dengan target biaya per akuisisi (CPA) yang Anda tetapkan.

targetImpressionShare

object (TargetImpressionShare)

Strategi bidding Target Pangsa Tayangan Iklan. Strategi bidding otomatis yang menetapkan bid untuk mencapai persentase tayangan yang dipilih.

targetRoas

object (TargetRoas)

Strategi bidding Target ROAS standar yang secara otomatis memaksimalkan pendapatan sekaligus menghitung rata-rata target laba atas belanja iklan (ROAS) tertentu.

targetSpend

object (TargetSpend)

Strategi bidding Target Pembelanjaan Standar yang secara otomatis menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai anggaran Anda.

percentCpc

object (PercentCpc)

Strategi bidding CPC Persen Standar dengan bid merupakan pecahan dari harga yang diiklankan untuk beberapa barang atau layanan.

targetCpm

object (TargetCpm)

Strategi bidding yang otomatis mengoptimalkan biaya per seribu tayangan iklan.

CampaignStatus

Kemungkinan status kampanye.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Kampanye aktif dan dapat menampilkan iklan.
PAUSED Kampanye telah dijeda oleh pengguna.
REMOVED Kampanye telah dihapus.

CampaignServingStatus

Kemungkinan status penayangan kampanye.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

SERVING Inferensi.
NONE Tidak ada.
ENDED Berakhir.
PENDING Pending.
SUSPENDED Ditangguhkan.

BiddingStrategySystemStatus

Kemungkinan status sistem Strategi Bidding.

Enum
UNSPECIFIED Sinyal bahwa terjadi error yang tidak terduga, misalnya, jenis strategi bidding tidak ditemukan, atau informasi status tidak ditemukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Strategi penawaran aktif dan AdWords tidak dapat menemukan masalah yang spesifik dengan strategi tersebut.
LEARNING_NEW Strategi bidding berstatus belajar karena baru saja dibuat atau baru saja diaktifkan kembali.
LEARNING_SETTING_CHANGE Strategi bidding belajar karena perubahan setelan baru-baru ini.
LEARNING_BUDGET_CHANGE Strategi bidding belajar karena perubahan anggaran baru-baru ini.
LEARNING_COMPOSITION_CHANGE Strategi bidding belajar karena perubahan baru-baru ini pada jumlah kampanye, grup iklan, atau kata kunci yang disertakan.
LEARNING_CONVERSION_TYPE_CHANGE Strategi bidding bergantung pada pelaporan konversi dan jenis konversi yang baru-baru ini diubah pelanggan yang relevan dengan strategi bidding.
LEARNING_CONVERSION_SETTING_CHANGE Strategi bidding bergantung pada pelaporan konversi dan pelanggan baru-baru ini mengubah setelan konversinya.
LIMITED_BY_CPC_BID_CEILING Strategi bidding dibatasi oleh batas bid-nya.
LIMITED_BY_CPC_BID_FLOOR Strategi bidding dibatasi oleh nilai minimum bid.
LIMITED_BY_DATA Strategi bidding dibatasi karena traffic konversi tidak cukup selama beberapa minggu terakhir.
LIMITED_BY_BUDGET Sebagian besar kata kunci dalam strategi bidding ini dibatasi anggaran.
LIMITED_BY_LOW_PRIORITY_SPEND Strategi bidding tidak dapat mencapai target pembelanjaannya karena pembelanjaannya tidak diprioritaskan.
LIMITED_BY_LOW_QUALITY Sebagian besar kata kunci dalam strategi bidding ini memiliki Skor Kualitas yang rendah.
LIMITED_BY_INVENTORY Strategi bidding tidak dapat membelanjakan seluruh anggarannya karena penargetan yang sempit.
MISCONFIGURED_ZERO_ELIGIBILITY Tracking konversi tidak ada (tidak ada ping) dan/atau daftar pemasaran ulang untuk SSC.
MISCONFIGURED_CONVERSION_TYPES Strategi bidding bergantung pada pelaporan konversi dan pelanggan tidak memiliki jenis konversi yang mungkin dilaporkan terhadap strategi ini.
MISCONFIGURED_CONVERSION_SETTINGS Strategi bidding bergantung pada pelaporan konversi dan setelan konversi pelanggan salah dikonfigurasi.
MISCONFIGURED_SHARED_BUDGET Ada kampanye di luar strategi bidding yang berbagi anggaran dengan kampanye yang disertakan dalam strategi tersebut.
MISCONFIGURED_STRATEGY_TYPE Kampanye memiliki jenis strategi yang tidak valid dan tidak ditayangkan.
PAUSED Strategi bidding tidak aktif. Baik tidak ada kampanye, grup iklan, atau kata kunci aktif yang disertakan ke strategi bidding. Atau, tidak ada anggaran aktif yang terhubung ke strategi bidding.
UNAVAILABLE Strategi bidding ini saat ini tidak mendukung pelaporan status.
MULTIPLE_LEARNING Ada beberapa status sistem LEARNING_* untuk strategi bidding ini selama periode yang dimaksud.
MULTIPLE_LIMITED Ada beberapa status sistem LIMITED_* untuk strategi bidding ini selama waktu yang dimaksud.
MULTIPLE_MISCONFIGURED Ada beberapa status sistem MISCONFIGURED_* untuk strategi bidding ini selama jangka waktu yang dimaksud.
MULTIPLE Ada beberapa status sistem untuk strategi bidding ini selama jangka waktu tersebut.

AdServingOptimizationStatus

Enum yang menjelaskan kemungkinan status penayangan.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

OPTIMIZE Penayangan iklan dioptimalkan berdasarkan CTR untuk kampanye.
CONVERSION_OPTIMIZE Penayangan iklan dioptimalkan berdasarkan CTR * Konversi untuk kampanye. Jika kampanye tidak dalam strategi bidding conversion optimizer, kampanye akan ditetapkan secara default ke OPTIMIZED.
ROTATE Iklan dirotasi secara merata selama 90 hari, lalu dioptimalkan untuk klik.
ROTATE_INDEFINITELY Tampilkan iklan berperforma lebih rendah lebih merata dengan iklan berperforma lebih tinggi, dan jangan optimalkan.
UNAVAILABLE Status pengoptimalan penayangan iklan tidak tersedia.

AdvertisingChannelType

Enum yang menjelaskan berbagai jenis saluran iklan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SEARCH Search Network. Mencakup kampanye display yang dipaketkan dan Penelusuran+.
DISPLAY Jaringan Display Google saja.
SHOPPING Kampanye Shopping ditayangkan di properti Shopping dan di hasil penelusuran google.com.
HOTEL Kampanye Iklan Hotel.
VIDEO Kampanye Video.
MULTI_CHANNEL Kampanye Aplikasi, dan Kampanye Aplikasi untuk Engagement, yang berjalan di beberapa saluran.
LOCAL Kampanye iklan lokal.
SMART Kampanye pintar.
PERFORMANCE_MAX Kampanye Performa Maksimal.
LOCAL_SERVICES Kampanye jasa dan servis.
DISCOVERY Kampanye Discovery.
TRAVEL Kampanye perjalanan.
SOCIAL Kampanye sosial.

AdvertisingChannelSubType

Enum yang mendeskripsikan berbagai subjenis saluran.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan sebagai nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SEARCH_MOBILE_APP Kampanye aplikasi seluler untuk Penelusuran.
DISPLAY_MOBILE_APP Kampanye aplikasi seluler untuk Display.
SEARCH_EXPRESS Kampanye AdWords Express untuk penelusuran.
DISPLAY_EXPRESS Kampanye AdWords Express untuk Display.
SHOPPING_SMART_ADS Kampanye Shopping Pintar.
DISPLAY_GMAIL_AD Kampanye Iklan Gmail.
DISPLAY_SMART_CAMPAIGN Kampanye smart display. Kampanye baru dari subjenis ini tidak dapat dibuat.
VIDEO_OUTSTREAM Kampanye Outstream Video.
VIDEO_ACTION Kampanye TrueView for Action Video.
VIDEO_NON_SKIPPABLE Kampanye Video dengan iklan video yang tidak dapat dilewati.
APP_CAMPAIGN Kampanye Aplikasi yang memungkinkan Anda mempromosikan aplikasi Android atau iOS dengan mudah di properti teratas Google termasuk Penelusuran, Play, YouTube, dan Jaringan Display Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Kampanye Aplikasi untuk engagement, yang berfokus untuk mendorong re-engagement dengan aplikasi di beberapa properti teratas Google termasuk Penelusuran, YouTube, dan Jaringan Display Google.
LOCAL_CAMPAIGN Kampanye khusus untuk iklan lokal.
SHOPPING_COMPARISON_LISTING_ADS Kampanye Listingan Perbandingan Belanja.
SMART_CAMPAIGN Kampanye Pintar Standar.
VIDEO_SEQUENCE Kampanye Video dengan iklan video urutan.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Kampanye Aplikasi untuk prapendaftaran, khusus untuk mengiklankan prapendaftaran aplikasi seluler, yang menargetkan beberapa saluran iklan di Google Play, YouTube, dan Jaringan Display.
VIDEO_REACH_TARGET_FREQUENCY Kampanye jangkauan Video dengan strategi bidding Target Frekuensi.
TRAVEL_ACTIVITIES Kampanye Aktivitas Perjalanan.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook hanya melacak kampanye sosial.

CustomParameter

Pemetaan yang dapat digunakan oleh tag parameter kustom di trackingUrlTemplate, finalUrls, atau mobile_final_urls.

Representasi JSON
{
  "key": string,
  "value": string
}
Kolom
key

string

Kunci yang cocok dengan nama tag parameter.

value

string

Nilai yang akan diganti.

RealTimeBiddingSetting

Setelan untuk Bidding Real-Time, fitur yang hanya tersedia untuk kampanye yang menargetkan jaringan Ad Exchange.

Representasi JSON
{
  "optIn": boolean
}
Kolom
optIn

boolean

Apakah kampanye diikutsertakan dalam bidding real-time.

NetworkSettings

Setelan jaringan untuk kampanye.

Representasi JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Kolom
targetSearchNetwork

boolean

Apakah iklan akan ditayangkan pada situs partner di Jaringan Penelusuran Google (memerlukan targetGoogleSearch juga true).

targetContentNetwork

boolean

Apakah iklan akan ditayangkan pada penempatan tertentu di Jaringan Display Google atau tidak. Penempatan ditetapkan menggunakan kriteria Penempatan.

targetPartnerSearchNetwork

boolean

Apakah iklan akan ditayangkan di Jaringan Partner Google atau tidak. Fitur ini hanya tersedia untuk beberapa akun partner Google tertentu.

DynamicSearchAdsSetting

Setelan untuk mengontrol Iklan Penelusuran Dinamis (DSA).

Representasi JSON
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Kolom
domainName

string

Wajib. Nama domain internet yang diwakili oleh setelan ini, misalnya, "google.com" atau "www.google.com".

languageCode

string

Wajib. Kode bahasa yang menentukan bahasa domain, misalnya, "en".

useSuppliedUrlsOnly

boolean

Apakah kampanye menggunakan URL yang disediakan pengiklan secara eksklusif atau tidak.

ShoppingSetting

Setelan untuk kampanye Shopping. Menentukan produk yang dapat diiklankan oleh kampanye, dan cara kampanye ini berinteraksi dengan kampanye Shopping lainnya.

Representasi JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Kolom
feedLabel

string

Label feed produk yang akan disertakan dalam kampanye. Hanya salah satu dari feedLabel atau salesCountry yang dapat ditetapkan. Jika digunakan, bukan salesCountry, kolom feedLabel menerima kode negara dalam format yang sama, misalnya: 'XX'. Atau, dapat berupa string yang digunakan untuk label feed di Google Merchant Center.

useVehicleInventory

boolean

Apakah akan menargetkan inventaris Listingan Kendaraan.

merchantId

string (int64 format)

ID akun Merchant Center. Kolom ini wajib diisi untuk operasi pembuatan. Kolom ini tidak dapat diubah untuk kampanye Shopping.

salesCountry

string

Negara penjualan produk yang akan disertakan dalam kampanye.

campaignPriority

integer

Prioritas kampanye. Kampanye dengan prioritas yang lebih tinggi secara numerik akan lebih diprioritaskan daripada kampanye dengan prioritas yang lebih rendah. Kolom ini wajib diisi untuk kampanye Shopping, dengan nilai antara 0 dan 2, inklusif. Kolom ini bersifat opsional untuk kampanye Shopping Pintar, tetapi harus sama dengan 3 jika ditetapkan.

enableLocal

boolean

Apakah akan menyertakan produk lokal.

GeoTargetTypeSetting

Mewakili kumpulan setelan yang terkait dengan penargetan-geo iklan.

Representasi JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Kolom
positiveGeoTargetType

enum (PositiveGeoTargetType)

Setelan yang digunakan untuk penargetan-geo positif di kampanye khusus ini.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Setelan yang digunakan untuk penargetan-geo negatif di kampanye khusus ini.

PositiveGeoTargetType

Kemungkinan jenis target geografis positif.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
PRESENCE_OR_INTEREST Menentukan bahwa iklan dipicu jika pengguna berada di, atau menunjukkan minat pada, target lokasi pengiklan.
SEARCH_INTEREST Menentukan bahwa iklan akan dipicu jika pengguna menelusuri target lokasi pengiklan. Fitur ini hanya dapat digunakan dengan kampanye Penelusuran dan Shopping Standar.
PRESENCE Menentukan bahwa iklan akan dipicu jika pengguna berada di atau biasanya berada di target lokasi pengiklan.

NegativeGeoTargetType

Kemungkinan jenis target geografis negatif.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
PRESENCE_OR_INTEREST Menentukan bahwa pengguna dikecualikan agar tidak melihat iklan jika mereka berada di, atau menunjukkan minat pada, lokasi yang dikecualikan pengiklan.
PRESENCE Menentukan bahwa pengguna dikecualikan agar tidak melihat iklan jika berada di lokasi yang dikecualikan pengiklan.

FrequencyCapEntry

Jenis ini tidak memiliki kolom.

Aturan yang menentukan frekuensi maksimum sebuah iklan (atau beberapa kumpulan iklan) dapat ditampilkan kepada pengguna selama jangka waktu tertentu.

SelectiveOptimization

Setelan pengoptimalan selektif untuk kampanye ini, yang mencakup kumpulan tindakan konversi untuk mengoptimalkan kampanye ini. Fitur ini hanya berlaku untuk kampanye Aplikasi yang menggunakan MULTI_CHANNEL sebagai AdvertisingChannelType dan APP_CAMPAIGN atau APP_CAMPAIGN_FOR_ENGAGEMENT sebagai AdvertisingChannelSubType.

Representasi JSON
{
  "conversionActions": [
    string
  ]
}
Kolom
conversionActions[]

string

Kumpulan tindakan konversi yang dipilih untuk mengoptimalkan kampanye ini.

OptimizationGoalSetting

Setelan sasaran pengoptimalan untuk kampanye ini, yang mencakup kumpulan jenis sasaran pengoptimalan.

Representasi JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Kolom
optimizationGoalTypes[]

enum (OptimizationGoalType)

Daftar jenis sasaran pengoptimalan.

OptimizationGoalType

Jenis sasaran pengoptimalan

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan sebagai nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
CALL_CLICKS Optimalkan klik panggilan telepon. Konversi klik panggilan telepon adalah berapa kali orang-orang memilih 'Panggilan' untuk menghubungi toko setelah melihat iklan.
DRIVING_DIRECTIONS Optimalkan rute mobil. Konversi rute mobil adalah waktu orang memilih 'Lihat rute' untuk membuka toko setelah melihat iklan.
APP_PRE_REGISTRATION Optimalkan prapendaftaran. Konversi prapendaftaran adalah jumlah prapendaftaran yang akan menerima notifikasi saat aplikasi dirilis.

TrackingSetting

Setelan tingkat kampanye untuk informasi pelacakan.

Representasi JSON
{
  "trackingUrl": string
}
Kolom
trackingUrl

string

URL yang digunakan untuk pelacakan dinamis.

ManualCpa

Jenis ini tidak memiliki kolom.

Strategi bidding manual yang memungkinkan pengiklan menetapkan bid per tindakan yang ditentukan pengiklan.

ManualCpc

Bidding berbasis klik manual yang mengharuskan pengguna membayar per klik.

Representasi JSON
{
  "enhancedCpcEnabled": boolean
}
Kolom
enhancedCpcEnabled

boolean

Apakah bid akan ditingkatkan berdasarkan data pengoptimal konversi.

ManualCpm

Jenis ini tidak memiliki kolom.

Bidding berbasis tayangan manual yang mengharuskan pengguna membayar per seribu tayangan iklan.

PercentCpc

Strategi bidding yang bid-nya merupakan pecahan dari harga yang diiklankan untuk beberapa barang atau layanan.

Representasi JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Kolom
cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Ini adalah kolom opsional yang dimasukkan oleh pengiklan dan ditentukan dalam mikro lokal. Catatan: Nilai nol ditafsirkan dengan cara yang sama seperti bid_plafon tidak ditentukan.

enhancedCpcEnabled

boolean

Menyesuaikan bid untuk setiap lelang ke atas atau ke bawah, bergantung pada kemungkinan konversi. Setiap bid dapat melebihi cpcBidCeilingMicros, namun jumlah bid rata-rata tidak boleh melebihi cpcBidCeilingMicros.

TargetCpm

Jenis ini tidak memiliki kolom.

Target CPM (biaya per seribu tayangan iklan) adalah strategi bidding otomatis yang menetapkan bid untuk mengoptimalkan performa dengan mempertimbangkan target CPM yang Anda tetapkan.

CampaignAsset

Link antara Kampanye dan Aset.

Representasi JSON
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Kolom
resourceName

string

Nama resource aset kampanye. Nama resource CampaignAsset memiliki bentuk:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

Status aset kampanye.

campaign

string

Kampanye yang ditautkan ke aset.

asset

string

Aset yang ditautkan ke kampanye.

CampaignAssetSet

CampaignAssetSet adalah penautan antara kampanye dan kumpulan aset. Menambahkan CampaignAssetSet akan menautkan kumpulan aset dengan kampanye.

Representasi JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Kolom
resourceName

string

Nama resource kumpulan aset kampanye. Nama resource aset kumpulan aset memiliki bentuk:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Kampanye yang tertaut dengan kumpulan aset ini.

assetSet

string

Kumpulan aset yang ditautkan ke kampanye.

status

enum (AssetSetLinkStatus)

Status aset kumpulan aset kampanye. Hanya baca.

CampaignAudienceView

Tampilan audiens kampanye. Mencakup data performa dari minat dan daftar pemasaran ulang untuk iklan Jaringan Display dan Jaringan YouTube, serta daftar pemasaran ulang untuk iklan penelusuran (RLSA), yang digabungkan menurut kriteria audiens dan kampanye. Tampilan ini hanya menyertakan audiens yang disertakan di tingkat kampanye.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan audiens kampanye. Nama aset tampilan audiens kampanye memiliki bentuk:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Kriteria kampanye.

Representasi JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Kolom
resourceName

string

Nama resource kriteria kampanye. Nama resource kriteria kampanye memiliki bentuk:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

Nama tampilan kriteria.

Kolom ini diabaikan untuk mutate.

type

enum (CriterionType)

Jenis kriteria.

status

enum (CampaignCriterionStatus)

Status kriteria.

lastModifiedTime

string

Tanggal dan waktu saat kriteria kampanye ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

criterionId

string (int64 format)

ID kriteria.

Kolom ini diabaikan selama mutasi.

bidModifier

number

Pengubah untuk bid saat kriteria cocok. Pengubah harus dalam rentang: 0.1 - 10.0. Sebagian besar jenis kriteria yang dapat ditargetkan mendukung pengubah. Gunakan 0 untuk memilih tidak menyertakan Jenis perangkat.

negative

boolean

Apakah akan menargetkan (false) atau mengecualikan (true) kriteria.

Kolom union criterion. Kriteria kampanye.

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

keyword

object (KeywordInfo)

Kata kunci.

location

object (LocationInfo)

Lokasi.

device

object (DeviceInfo)

Perangkat.

ageRange

object (AgeRangeInfo)

Rentang usia.

gender

object (GenderInfo)

Jenis Kelamin.

userList

object (UserListInfo)

Daftar Pengguna.

language

object (LanguageInfo)

Bahasa.

webpage

object (WebpageInfo)

Halaman web.

locationGroup

object (LocationGroupInfo)

Grup Lokasi

CampaignCriterionStatus

Status yang mungkin dari Kriteria Kampanye.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

ENABLED Kriteria kampanye diaktifkan.
PAUSED Kriteria kampanye dijeda.
REMOVED Kriteria kampanye dihapus.

LanguageInfo

Kriteria bahasa.

Representasi JSON
{
  "languageConstant": string
}
Kolom
languageConstant

string

Nama resource konstanta bahasa.

LocationGroupInfo

Radius di sekitar daftar lokasi yang ditentukan melalui feed.

Representasi JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Kolom
geoTargetConstants[]

string

Konstanta target geografis yang membatasi cakupan area geografis dalam feed. Saat ini hanya satu konstanta target geografis yang diizinkan.

radiusUnits

enum (LocationGroupRadiusUnits)

Satuan radius. Mil dan meter didukung untuk konstanta target geografis. Mil dan meter mil dan meter didukung untuk kumpulan item feed. Ini diperlukan dan harus ditetapkan dalam operasi CREATE.

feedItemSets[]

string

FeedItemSets yang FeedItems-nya ditargetkan. Jika beberapa ID ditentukan, semua item yang muncul di setidaknya satu kumpulan akan ditargetkan. Kolom ini tidak dapat digunakan dengan geoTargetConstants. Ini bersifat opsional dan hanya dapat ditetapkan dalam operasi CREATE.

radius

string (int64 format)

Jarak dalam unit yang menentukan radius di sekitar lokasi yang ditargetkan. Ini diperlukan dan harus ditetapkan dalam operasi CREATE.

LocationGroupRadiusUnits

Satuan jarak radius dalam grup lokasi (misalnya, MILES)

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
METERS Meter
MILES Mil
MILLI_MILES Mili Mil

CampaignLabel

Mewakili hubungan antara kampanye dan label.

Representasi JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
Kolom
resourceName

string

Nama resource. Nama resource label kampanye memiliki bentuk: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Kampanye yang menyertakan label.

label

string

Label yang ditetapkan untuk kampanye.

CartDataSalesView

Tampilan penjualan data keranjang.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan penjualan data Keranjang. Nama resource tampilan penjualan data keranjang memiliki bentuk: customers/{customerId}/cartDataSalesView

Audiens

Audiens adalah opsi penargetan efektif yang memungkinkan Anda memadukan berbagai atribut segmen, seperti demografi dan minat terperinci, untuk membuat audiens yang mewakili bagian dari segmen target Anda.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Kolom
resourceName

string

Nama resource audiens. Nama audiens memiliki bentuk:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID audiens.

name

string

Wajib. Nama audiens. Nama harus unik untuk semua audiens. ID harus memiliki panjang minimum 1 dan panjang maksimum 255.

description

string

Deskripsi audiens ini.

ConversionAction

Tindakan konversi.

Representasi JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Kolom
resourceName

string

Nama resource tindakan konversi. Nama resource tindakan konversi memiliki bentuk:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Stempel waktu pembuatan aktivitas Floodlight, yang diformat dalam ISO 8601.

status

enum (ConversionActionStatus)

Status tindakan konversi ini untuk akrual peristiwa konversi.

type

enum (ConversionActionType)

Jenis tindakan konversi ini.

category

enum (ConversionActionCategory)

Kategori konversi yang dilaporkan untuk tindakan konversi ini.

valueSettings

object (ValueSettings)

Setelan yang terkait dengan nilai untuk peristiwa konversi yang dikaitkan dengan tindakan konversi ini.

attributionModelSettings

object (AttributionModelSettings)

Setelan yang terkait dengan model atribusi tindakan konversi ini.

floodlightSettings

object (FloodlightSettings)

Setelan Floodlight untuk jenis konversi Floodlight.

id

string (int64 format)

ID tindakan konversi.

name

string

Nama tindakan konversi.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat tindakan konversi baru.

primaryForGoal

boolean

Jika bit primaryForGoal tindakan konversi salah, tindakan konversi tidak dapat di-bid untuk semua kampanye, terlepas dari sasaran konversi pelanggan atau sasaran konversi kampanye mereka. Namun, sasaran konversi kustom tidak mematuhi primaryForGoal, sehingga jika kampanye memiliki sasaran konversi kustom yang dikonfigurasi dengan tindakan konversi primaryForGoal = false, tindakan konversi tersebut masih dapat di-bid. Secara default, primaryForGoal akan bernilai true jika tidak ditetapkan. Di V9, primaryForGoal hanya dapat ditetapkan ke false setelah pembuatan melalui 'update' karena tidak dideklarasikan sebagai opsional.

ownerCustomer

string

Nama resource pelanggan pemilik tindakan konversi, atau null jika ini adalah tindakan konversi yang ditentukan sistem.

includeInClientAccountConversionsMetric

boolean

Apakah tindakan konversi ini harus disertakan dalam "clientAccountConversions" metrik.

includeInConversionsMetric

boolean

Apakah tindakan konversi ini harus disertakan dalam "konversi" metrik.

clickThroughLookbackWindowDays

string (int64 format)

Jumlah hari maksimum yang mungkin berlalu antara interaksi (misalnya, klik) dan peristiwa konversi.

appId

string

ID aplikasi untuk tindakan konversi aplikasi.

ConversionActionStatus

Kemungkinan status tindakan konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Konversi akan dicatat.
REMOVED Konversi tidak akan dicatat.
HIDDEN Konversi tidak akan dicatat dan tindakan konversi tidak akan muncul di UI.

ConversionActionType

Kemungkinan jenis tindakan konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_CALL Konversi yang terjadi saat pengguna mengklik ekstensi panggilan iklan.
CLICK_TO_CALL Konversi yang terjadi saat pengguna di perangkat seluler mengklik nomor telepon.
GOOGLE_PLAY_DOWNLOAD Konversi yang terjadi saat pengguna mendownload aplikasi seluler dari Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Konversi yang terjadi saat pengguna melakukan pembelian di aplikasi melalui penagihan Android.
UPLOAD_CALLS Konversi panggilan yang dilacak oleh pengiklan dan diupload.
UPLOAD_CLICKS Konversi yang dilacak oleh pengiklan dan diupload dengan klik yang diatribusikan.
WEBPAGE Konversi yang terjadi di halaman web.
WEBSITE_CALL Konversi yang terjadi saat pengguna menelepon nomor telepon yang dibuat secara dinamis dari situs pengiklan.
STORE_SALES_DIRECT_UPLOAD Konversi Penjualan Toko berdasarkan upload data penjual pihak pertama atau pihak ketiga. Hanya pelanggan dalam daftar yang diizinkan yang dapat menggunakan jenis upload langsung penjualan toko.
STORE_SALES Konversi Penjualan Toko berdasarkan upload data penjual pihak pertama atau pihak ketiga dan/atau dari pembelian di toko menggunakan kartu dari jaringan pembayaran. Hanya pelanggan dalam daftar yang diizinkan yang dapat menggunakan jenis penjualan toko. Hanya baca.
FIREBASE_ANDROID_FIRST_OPEN Konversi aplikasi Android yang pertama kali dibuka dilacak melalui Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Konversi pembelian dalam aplikasi Android yang dilacak melalui Firebase.
FIREBASE_ANDROID_CUSTOM Konversi kustom aplikasi Android yang dilacak melalui Firebase.
FIREBASE_IOS_FIRST_OPEN Konversi yang pertama kali dibuka oleh aplikasi iOS dilacak melalui Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Konversi pembelian aplikasi iOS dalam aplikasi dilacak melalui Firebase.
FIREBASE_IOS_CUSTOM Konversi kustom aplikasi iOS yang dilacak melalui Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Konversi pertama kali aplikasi Android dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Konversi pembelian aplikasi Android dalam aplikasi yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Konversi kustom aplikasi Android yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Konversi yang pertama kali dibuka di aplikasi iOS dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Konversi pembelian aplikasi dalam aplikasi iOS yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Konversi kustom aplikasi iOS yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
ANDROID_APP_PRE_REGISTRATION Konversi yang terjadi saat pengguna melakukan prapendaftaran untuk aplikasi seluler dari Google Play Store. Hanya baca.
ANDROID_INSTALLS_ALL_OTHER_APPS Konversi yang melacak semua download Google Play yang tidak dilacak menurut jenis khusus aplikasi. Hanya baca.
FLOODLIGHT_ACTION Aktivitas Floodlight yang menghitung frekuensi pengguna mengunjungi halaman tertentu setelah melihat atau mengklik salah satu iklan pengiklan. Hanya baca.
FLOODLIGHT_TRANSACTION Aktivitas Floodlight yang melacak jumlah penjualan yang dilakukan atau jumlah item yang dibeli. Dapat juga mencatat total nilai dari setiap penjualan. Hanya baca.
GOOGLE_HOSTED Konversi yang melacak tindakan lokal dari produk dan layanan Google setelah berinteraksi dengan iklan. Hanya baca.
LEAD_FORM_SUBMIT Konversi dilaporkan saat pengguna mengirimkan formulir prospek. Hanya baca.
SALESFORCE Konversi yang berasal dari Salesforce. Hanya baca.
SEARCH_ADS_360 Konversi yang diimpor dari data Floodlight Search Ads 360. Hanya baca.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Konversi panggilan yang terjadi di Iklan kampanye Pintar tanpa penyiapan tracking panggilan, menggunakan kriteria kustom kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Pengguna mengklik elemen panggilan dalam Google Maps. Khusus kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_MAP_DIRECTIONS Pengguna meminta rute ke lokasi bisnis dalam Google Maps. Khusus kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_TRACKED_CALLS Konversi panggilan yang terjadi di Iklan kampanye Pintar dengan penyiapan tracking panggilan, menggunakan kriteria kustom kampanye Pintar. Hanya baca.
STORE_VISITS Konversi yang terjadi saat pengguna mengunjungi toko retail pengiklan. Hanya baca.
WEBPAGE_CODELESS Konversi yang dibuat dari peristiwa situs (seperti pengiriman formulir atau pemuatan halaman), yang tidak menggunakan cuplikan peristiwa yang dikodekan satu per satu. Hanya baca.
UNIVERSAL_ANALYTICS_GOAL Konversi yang berasal dari sasaran Universal Analytics tertaut.
UNIVERSAL_ANALYTICS_TRANSACTION Konversi yang berasal dari transaksi Universal Analytics tertaut.
GOOGLE_ANALYTICS_4_CUSTOM Konversi yang berasal dari konversi peristiwa kustom Google Analytics 4 tertaut.
GOOGLE_ANALYTICS_4_PURCHASE Konversi yang berasal dari konversi pembelian Google Analytics 4 tertaut.

ConversionActionCategory

Kategori konversi yang dikaitkan dengan ConversionAction.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
DEFAULT Kategori default.
PAGE_VIEW Pengguna mengunjungi halaman.
PURCHASE Pembelian, penjualan, atau "pesanan dilakukan" peristiwa.
SIGNUP Mendaftar tindakan pengguna.
LEAD Tindakan perolehan prospek.
DOWNLOAD Tindakan download software (seperti untuk aplikasi).
ADD_TO_CART Penambahan item ke keranjang atau tas belanja di situs pengiklan.
BEGIN_CHECKOUT Saat seseorang memasuki alur checkout di situs pengiklan.
SUBSCRIBE_PAID Awal langganan berbayar untuk suatu produk atau layanan.
PHONE_CALL_LEAD Panggilan untuk menunjukkan minat terhadap penawaran pengiklan.
IMPORTED_LEAD Konversi prospek yang diimpor dari sumber eksternal ke Google Ads.
SUBMIT_LEAD_FORM Pengiriman formulir di situs pengiklan yang menunjukkan minat bisnis.
BOOK_APPOINTMENT Pembuatan janji temu dengan bisnis pengiklan.
REQUEST_QUOTE Penawaran harga atau permintaan estimasi harga.
GET_DIRECTIONS Penelusuran lokasi bisnis pengiklan dengan niat untuk berkunjung.
OUTBOUND_CLICK Klik ke situs partner pengiklan.
CONTACT Panggilan telepon, SMS, email, chat, atau jenis kontak lainnya untuk pengiklan.
ENGAGEMENT Peristiwa engagement situs seperti waktu situs yang lama atau Sasaran Pintar Google Analytics (GA). Ditujukan untuk digunakan dalam impor sasaran GA, Firebase, GA Gold.
STORE_VISIT Kunjungan ke lokasi toko fisik.
STORE_SALE Penjualan yang terjadi di toko fisik.
QUALIFIED_LEAD Konversi prospek yang diimpor dari sumber eksternal ke Google Ads, yang telah lebih dikualifikasikan oleh pengiklan (tim pemasaran/penjualan). Dalam perjalanan prospek sampai ke penjualan, pengiklan mendapatkan prospek, lalu menindaklanjutinya dengan menghubungi konsumen. Jika konsumen tertarik dan mungkin akhirnya membeli produknya, pengiklan akan menandai prospek tersebut sebagai "prospek berkualitas".
CONVERTED_LEAD Konversi prospek yang diimpor dari sumber eksternal ke Google Ads, yang telah menyelesaikan tahap yang dipilih lebih lanjut seperti yang ditentukan oleh pengiklan perolehan prospek.

ValueSettings

Setelan yang terkait dengan nilai untuk peristiwa konversi yang dikaitkan dengan tindakan konversi ini.

Representasi JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Kolom
defaultValue

number

Nilai yang akan digunakan saat peristiwa konversi untuk tindakan konversi ini dikirim dengan nilai yang tidak valid, tidak diizinkan, atau tidak ada, atau saat tindakan konversi ini dikonfigurasi untuk selalu menggunakan nilai default.

defaultCurrencyCode

string

Kode mata uang yang akan digunakan saat peristiwa konversi untuk tindakan konversi ini dikirim dengan kode mata uang yang tidak valid atau tidak ada, atau saat tindakan konversi ini dikonfigurasi untuk selalu menggunakan nilai default.

alwaysUseDefaultValue

boolean

Mengontrol apakah nilai default dan kode mata uang default akan digunakan sebagai pengganti nilai dan kode mata uang yang ditentukan dalam peristiwa konversi untuk tindakan konversi ini.

AttributionModelSettings

Setelan yang terkait dengan model atribusi tindakan konversi ini.

Representasi JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Kolom
attributionModel

enum (AttributionModel)

Jenis model atribusi tindakan konversi ini.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Status model atribusi berbasis data untuk tindakan konversi.

AttributionModel

Model atribusi yang menjelaskan cara mendistribusikan kredit untuk konversi tertentu pada kemungkinan berbagai interaksi sebelumnya.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
EXTERNAL Menggunakan atribusi eksternal.
GOOGLE_ADS_LAST_CLICK Mengatribusikan semua kredit untuk konversi ke klik terakhirnya.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Mengatribusikan semua kredit untuk konversi ke klik pertamanya menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Mengatribusikan kredit untuk konversi secara setara di semua kliknya menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Mengatribusikan lebih banyak kredit untuk konversi ke klik terbarunya secara eksponensial menggunakan atribusi Google Penelusuran (waktu paruh adalah 1 minggu).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Mengatribusikan 40% kredit untuk konversi ke klik pertama dan terakhirnya. 20% sisanya akan didistribusikan secara merata di seluruh klik lainnya. Ini menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Model fleksibel yang menggunakan machine learning untuk menentukan distribusi kredit yang tepat di antara klik menggunakan atribusi Google Penelusuran.

DataDrivenModelStatus

Menghitung status model berbasis data.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
AVAILABLE Model berbasis data tersedia.
STALE Model berbasis data sudah usang. Belum diperbarui selama setidaknya 7 hari. Data tersebut masih digunakan, tetapi akan habis masa berlakunya jika tidak diperbarui selama 30 hari.
EXPIRED Model berbasis data sudah tidak berlaku. Perangkat belum diperbarui selama setidaknya 30 hari dan tidak dapat digunakan. Masalah ini paling umum terjadi karena jumlah peristiwa yang diperlukan belum mencapai jumlah yang diperlukan dalam periode 30 hari terakhir.
NEVER_GENERATED Model berbasis data tidak pernah dibuat. Masalah ini paling sering terjadi karena tidak pernah ada jumlah peristiwa yang diperlukan dalam periode 30 hari.

FloodlightSettings

Setelan yang terkait dengan tindakan konversi Floodlight.

Representasi JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Kolom
activityGroupTag

string

String yang digunakan untuk mengidentifikasi grup aktivitas Floodlight saat melaporkan konversi.

activityTag

string

String yang digunakan untuk mengidentifikasi aktivitas Floodlight saat melaporkan konversi.

activityId

string (int64 format)

ID aktivitas Floodlight di DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Variabel khusus konversi. Lihat artikel "Tentang metrik dan dimensi Floodlight kustom di Search Ads 360 versi baru" di https://support.google.com/sa360/answer/13567857

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Kolom
resourceName

string

Nama resource variabel khusus konversi. Nama resource variabel khusus konversi memiliki bentuk:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

ID variabel khusus konversi.

name

string

Wajib. Nama variabel khusus konversi. Nama harus unik. Panjang maksimum nama adalah 100 karakter. Tidak boleh ada spasi tambahan sebelum dan sesudahnya.

tag

string

Wajib. Tag variabel khusus konversi. Tag harus unik dan terdiri dari "u" diikuti langsung dengan angka kurang dari atau sama dengan 100. Misalnya: "u4".

status

enum (ConversionCustomVariableStatus)

Status variabel kustom konversi untuk pengumpulan peristiwa konversi.

ownerCustomer

string

Nama resource pelanggan yang memiliki variabel kustom konversi.

family

enum (ConversionCustomVariableFamily)

Kelompok variabel khusus konversi.

cardinality

enum (ConversionCustomVariableCardinality)

Kardinalitas variabel khusus konversi.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Kolom untuk variabel kustom konversi Floodlight Search Ads 360.

customColumnIds[]

string (int64 format)

ID kolom kustom yang menggunakan variabel kustom konversi ini.

ConversionCustomVariableStatus

Kemungkinan status variabel khusus konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ACTIVATION_NEEDED

Variabel khusus konversi sedang menunggu aktivasi dan tidak akan mengakumulasi statistik hingga ditetapkan ke DIAKTIFKAN.

Status ini tidak dapat digunakan dalam permintaan CREATE dan UPDATE.

ENABLED Variabel khusus konversi diaktifkan dan akan mengakumulasikan statistik.
PAUSED Variabel khusus konversi dijeda dan tidak akan mengakumulasi statistik hingga ditetapkan ke DIAKTIFKAN lagi.

ConversionCustomVariableFamily

Kelompok variabel khusus konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
STANDARD Variabel khusus konversi standar. Pelanggan harus melakukan aktivasi sebelum digunakan.
FLOODLIGHT Variabel kustom konversi diimpor dari variabel Floodlight kustom.

ConversionCustomVariableCardinality

Kardinalitas variabel khusus konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
BELOW_ALL_LIMITS Variabel khusus konversi memiliki kardinalitas di bawah semua batas. Variabel dapat digunakan untuk segmentasi, dan statistik dapat mengakumulasikan nilai baru jika variabel diaktifkan.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Variabel khusus konversi memiliki kardinalitas yang melebihi batas segmentasi, tetapi tidak melebihi batas statistik. Segmentasi akan dinonaktifkan, tetapi statistik dapat mengakumulasikan nilai baru jika variabel diaktifkan.
APPROACHES_STATS_LIMIT Variabel khusus konversi telah melampaui batas segmentasi dan mendekati batas statistik (> 90%). Segmentasi akan dinonaktifkan, tetapi statistik dapat mengakumulasikan nilai baru jika variabel diaktifkan.
EXCEEDS_STATS_LIMIT Variabel khusus konversi telah melampaui batas segmentasi dan batas statistik. Segmentasi akan dinonaktifkan, dan statistik untuk variabel yang diaktifkan dapat bertambah hanya jika nilai yang ada tidak meningkatkan kardinalitas variabel lebih lanjut.

FloodlightConversionCustomVariableInfo

Informasi untuk Variabel Kustom Konversi Floodlight Search Ads 360.

Representasi JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Kolom
floodlightVariableType

enum (FloodlightVariableType)

Jenis variabel Floodlight yang ditentukan di Search Ads 360.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Jenis data variabel Floodlight yang ditentukan di Search Ads 360.

FloodlightVariableType

Jenis variabel Floodlight, seperti yang ditentukan di Search Ads 360. Lihat https://support.google.com/searchads/answer/4397154?hl=en untuk mempelajari lebih lanjut.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
DIMENSION Jenis variabel Floodlight dimensi.
METRIC Jenis variabel Floodlight metrik.
UNSET Jenis variabel Floodlight tidak ditetapkan.

FloodlightVariableDataType

Jenis data variabel Floodlight, seperti yang ditentukan di Search Ads 360. Lihat https://support.google.com/searchads/answer/4397154?hl=en untuk mempelajari lebih lanjut.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
NUMBER Menunjukkan variabel Floodlight "Angka" . Variabel ini dapat ditetapkan ke variabel Floodlight dari jenis DIMENSION atau METRIC.
STRING Mewakili variabel Floodlight "String" . Variabel ini dapat ditetapkan ke variabel Floodlight dari jenis DIMENSION.

Pelanggan

Pelanggan.

Representasi JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Kolom
resourceName

string

Nama resource pelanggan. Nama resource pelanggan memiliki bentuk:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Setelan tracking konversi untuk pelanggan.

accountType

enum (AccountType)

Jenis akun mesin, misalnya, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Pelacakan Mesin, dll.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Setelan DoubleClick Campaign Manager (DCM) untuk pelanggan pengelola.

accountStatus

enum (AccountStatus)

Status akun, misalnya, Diaktifkan, Dijeda, Dihapus, dll.

lastModifiedTime

string

Tanggal dan waktu saat pelanggan ini terakhir diubah. datetime berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss.ssssss" format font.

engineId

string

ID akun di akun mesin eksternal.

status

enum (CustomerStatus)

Status pelanggan.

creationTime

string

Stempel waktu saat pelanggan ini dibuat. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

id

string (int64 format)

ID pelanggan.

descriptiveName

string

Nama pelanggan deskriptif opsional yang tidak unik.

currencyCode

string

Mata uang yang digunakan akun tersebut. Sebagian kode mata uang dari standar ISO 4217 didukung.

timeZone

string

ID zona waktu lokal pelanggan.

trackingUrlTemplate

string

Template URL untuk membuat URL pelacakan dari parameter.

finalUrlSuffix

string

Template URL untuk menambahkan parameter ke URL final.

autoTaggingEnabled

boolean

Apakah pemberian tag otomatis diaktifkan untuk pelanggan atau tidak.

manager

boolean

Apakah pelanggan adalah manajer.

ConversionTrackingSetting

Kumpulan setelan seluruh pelanggan yang terkait dengan Tracking Konversi Search Ads 360.

Representasi JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Kolom
acceptedCustomerDataTerms

boolean

Apakah pelanggan telah menyetujui persyaratan data pelanggan. Jika menggunakan tracking konversi lintas-akun, nilai ini diwarisi dari pengelola. Kolom ini bersifat hanya baca. Untuk informasi selengkapnya, lihat https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Status tracking konversi. Hal ini menunjukkan apakah pelanggan menggunakan tracking konversi, dan siapa pemilik tracking konversi dari pelanggan ini. Jika pelanggan ini menggunakan tracking konversi lintas-akun, nilai yang ditampilkan akan berbeda berdasarkan login-customer-id permintaan.

enhancedConversionsForLeadsEnabled

boolean

Apakah pelanggan memilih ikut serta dalam konversi yang disempurnakan untuk prospek. Jika menggunakan tracking konversi lintas-akun, nilai ini diwarisi dari pengelola. Kolom ini bersifat hanya baca.

googleAdsConversionCustomer

string

Nama resource pelanggan tempat konversi dibuat dan dikelola. Kolom ini bersifat hanya baca.

conversionTrackingId

string (int64 format)

ID tracking konversi yang digunakan untuk akun ini. ID ini tidak menunjukkan apakah pelanggan menggunakan tracking konversi (conversionTrackingStatus melakukannya). Kolom ini bersifat hanya baca.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

ID tracking konversi pengelola pelanggan. Ini ditetapkan saat pelanggan memilih ikut serta dalam tracking konversi, dan mengganti conversionTrackingId. Kolom ini hanya dapat dikelola melalui UI Google Ads. Kolom ini bersifat hanya baca.

crossAccountConversionTrackingId

string (int64 format)

ID tracking konversi pengelola pelanggan. ID ini ditetapkan saat pelanggan memilih untuk menggunakan tracking konversi lintas-akun, dan mengganti conversionTrackingId.

ConversionTrackingStatus

Status Tracking Konversi pelanggan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
NOT_CONVERSION_TRACKED Pelanggan tidak menggunakan tracking konversi apa pun.
CONVERSION_TRACKING_MANAGED_BY_SELF Tindakan konversi dibuat dan dikelola oleh pelanggan ini.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Tindakan konversi dibuat dan dikelola oleh pengelola yang ditentukan dalam login-customer-id permintaan.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Tindakan konversi dibuat dan dikelola oleh pengelola yang berbeda dengan pelanggan atau pengelola yang ditentukan dalam login-customer-id permintaan.

AccountType

Kemungkinan jenis akun mesin.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
BAIDU Akun Baidu.
ENGINE_TRACK Akun pelacakan mesin.
FACEBOOK Akun Facebook.
FACEBOOK_GATEWAY Akun Facebook dikelola melalui gateway.
GOOGLE_ADS Akun Google Ads.
MICROSOFT Akun Microsoft Advertising.
SEARCH_ADS_360 Akun pengelola Search Ads 360.
YAHOO_JAPAN Akun Yahoo Japan.

DoubleClickCampaignManagerSetting

Setelan DoubleClick Campaign Manager (DCM) untuk pelanggan pengelola.

Representasi JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Kolom
advertiserId

string (int64 format)

ID pengiklan Campaign Manager yang terkait dengan pelanggan ini.

networkId

string (int64 format)

ID jaringan Campaign Manager yang terkait dengan pelanggan ini.

timeZone

string

Zona waktu jaringan Campaign Manager yang terkait dengan pelanggan ini dalam format Database Zona Waktu IANA, seperti America/New_York.

AccountStatus

Kemungkinan status akun.

Enum
UNSPECIFIED Nilai default.
UNKNOWN Nilai tidak diketahui.
ENABLED Akun dapat menayangkan iklan.
PAUSED Akun dinonaktifkan oleh pengguna.
SUSPENDED Akun dinonaktifkan oleh proses internal.
REMOVED Akun dinonaktifkan secara permanen.
DRAFT Akun masih dalam proses penyiapan, belum DIAKTIFKAN.

CustomerStatus

Kemungkinan status pelanggan.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Menunjukkan akun aktif yang dapat menayangkan iklan.
CANCELED Mengindikasikan bahwa akun yang dibatalkan tidak dapat menayangkan iklan. Dapat diaktifkan kembali oleh pengguna admin.
SUSPENDED Menunjukkan akun yang ditangguhkan tidak dapat menayangkan iklan. Hanya dapat diaktifkan oleh dukungan Google.
CLOSED Menunjukkan bahwa akun yang ditutup tidak dapat menayangkan iklan. Akun pengujian juga akan memiliki status DITUTUP. Status bersifat permanen dan tidak dapat dibuka kembali.

CustomerAsset

Link antara pelanggan dan aset.

Representasi JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Kolom
resourceName

string

Nama resource aset pelanggan. Nama resource CustomerAsset memiliki bentuk:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Wajib. Aset yang ditautkan ke pelanggan.

status

enum (AssetLinkStatus)

Status aset pelanggan.

CustomerAssetSet

CustomerAssetSet adalah hubungan antara pelanggan dan kumpulan aset. Menambahkan CustomerAssetSet akan menautkan kumpulan aset dengan pelanggan.

Representasi JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Kolom
resourceName

string

Nama resource dari kumpulan aset pelanggan. Nama resource aset kumpulan aset memiliki bentuk:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Kumpulan aset yang ditautkan ke pelanggan.

customer

string

Pelanggan yang ditautkan ke kumpulan aset ini.

status

enum (AssetSetLinkStatus)

Status aset kumpulan aset pelanggan. Hanya baca.

AccessibleBiddingStrategy

Merepresentasikan tampilan Strategi Bidding yang dimiliki oleh dan dibagikan kepada pelanggan.

Berbeda dengan BiddingStrategy, referensi ini mencakup strategi yang dimiliki oleh pengelola pelanggan dan dibagikan kepada pelanggan ini - selain strategi yang dimiliki oleh pelanggan ini. Referensi ini tidak menyediakan metrik dan hanya menampilkan sebagian atribut Strategi Bidding yang terbatas.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Kolom
resourceName

string

Nama resource strategi bidding yang dapat diakses. Nama resource AccessibleBiddingStrategy memiliki bentuk:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

ID strategi bidding.

name

string

Nama strategi bidding.

type

enum (BiddingStrategyType)

Jenis strategi bidding.

ownerCustomerId

string (int64 format)

ID Pelanggan yang memiliki strategi bidding.

ownerDescriptiveName

string

deskriptifNama Pelanggan yang memiliki strategi bidding.

Kolom union scheme. Skema bidding.

Hanya satu yang dapat ditetapkan. scheme hanya dapat berupa salah satu dari yang berikut:

maximizeConversionValue

object (MaximizeConversionValue)

Strategi bidding otomatis guna membantu mendapatkan nilai konversi sebanyak mungkin untuk kampanye sekaligus membelanjakan anggaran Anda.

maximizeConversions

object (MaximizeConversions)

Strategi bidding otomatis guna membantu mendapatkan konversi terbanyak sekaligus membelanjakan anggaran Anda.

targetCpa

object (TargetCpa)

Strategi bidding yang menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin sesuai target biaya per akuisisi (CPA) yang Anda tetapkan.

targetImpressionShare

object (TargetImpressionShare)

Strategi bidding yang secara otomatis mengoptimalkan persentase tayangan yang dipilih.

targetRoas

object (TargetRoas)

Strategi bidding yang membantu Anda memaksimalkan pendapatan sekaligus menghitung rata-rata target Laba Atas Belanja Iklan (ROAS) tertentu.

targetSpend

object (TargetSpend)

Strategi bidding yang menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai anggaran Anda.

MaximizeConversionValue

Strategi bidding otomatis guna membantu mendapatkan nilai konversi sebanyak mungkin untuk kampanye sekaligus membelanjakan anggaran Anda.

Representasi JSON
{
  "targetRoas": number
}
Kolom
targetRoas

number

Opsi target laba atas belanja iklan (ROAS). Jika ditetapkan, strategi bidding akan memaksimalkan pendapatan sekaligus menghitung rata-rata target laba atas belanja iklan. Jika target ROAS tinggi, strategi bidding mungkin tidak dapat membelanjakan seluruh anggaran. Jika target ROAS tidak ditetapkan, strategi bidding akan berupaya mencapai ROAS setinggi mungkin sesuai anggaran.

MaximizeConversions

Strategi bidding otomatis guna membantu mendapatkan konversi terbanyak sekaligus membelanjakan anggaran Anda.

Representasi JSON
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Kolom
targetCpa

string (int64 format)

Opsi target biaya per akuisisi (CPA). Ini adalah jumlah rata-rata yang ingin Anda belanjakan per akuisisi.

targetCpaMicros

string (int64 format)

Opsi target biaya per akuisisi (CPA). Ini adalah jumlah rata-rata yang ingin Anda belanjakan per akuisisi.

TargetCpa

Strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan konversi sebanyak mungkin sesuai dengan target biaya per akuisisi (CPA) yang Anda tetapkan.

Representasi JSON
{
  "targetCpaMicros": string
}
Kolom
targetCpaMicros

string (int64 format)

Target CPA rata-rata. Target ini harus lebih besar dari atau sama dengan unit minimum yang dapat ditagih berdasarkan mata uang untuk akun.

TargetImpressionShare

Strategi bidding otomatis yang menetapkan bid sehingga persentase iklan penelusuran tertentu ditampilkan di bagian atas halaman pertama (atau target lokasi lainnya).

Representasi JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Kolom
location

enum (TargetImpressionShareLocation)

Target lokasi pada halaman hasil penelusuran.

locationFractionMicros

string (int64 format)

Bagian iklan yang dipilih untuk ditampilkan di target lokasi dalam mikro. Misalnya, 1% sama dengan 10.000.

cpcBidCeilingMicros

string (int64 format)

Bid CPC tertinggi yang diizinkan untuk ditentukan oleh sistem bidding otomatis. Ini adalah bidang wajib yang dimasukkan oleh pengiklan yang menetapkan batas maksimal dan ditentukan dalam mikro lokal.

TargetRoas

Strategi bidding otomatis yang membantu Anda memaksimalkan pendapatan sekaligus menghitung rata-rata target laba atas belanja iklan (ROAS) tertentu.

Representasi JSON
{
  "targetRoas": number
}
Kolom
targetRoas

number

Pendapatan yang dipilih (berdasarkan data konversi) per unit pembelanjaan.

TargetSpend

Strategi bidding otomatis yang menetapkan bid untuk membantu mendapatkan klik sebanyak mungkin sesuai anggaran Anda.

Representasi JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Kolom
targetSpendMicros
(deprecated)

string (int64 format)

Target pembelanjaan yang digunakan untuk memaksimalkan klik. Bidder TargetSpend akan mencoba membelanjakan jumlah yang lebih kecil dari nilai ini atau jumlah pembelanjaan throttling alami. Jika tidak ditentukan, anggaran digunakan sebagai target pembelanjaan. Kolom ini tidak digunakan lagi dan tidak boleh digunakan lagi. Lihat https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html untuk mengetahui detailnya.

cpcBidCeilingMicros

string (int64 format)

Batas bid maksimum yang dapat ditetapkan oleh strategi bidding. Batas ini berlaku untuk semua kata kunci yang dikelola oleh strategi tersebut.

ManagerLinkStatus

Kemungkinan status link.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ACTIVE Menunjukkan hubungan yang sedang diterapkan saat ini
INACTIVE Menunjukkan hubungan yang dihentikan
PENDING Menunjukkan hubungan telah diminta oleh manajer, tetapi klien belum menyetujuinya.
REFUSED Hubungan diminta oleh manajer, tetapi klien menolak.
CANCELED Menunjukkan hubungan telah diminta oleh manajer, tapi manajer membatalkannya.

CustomerClient

Tautan antara pelanggan tertentu dan pelanggan klien. KlienPelanggan hanya ada untuk pelanggan pengelola. Semua pelanggan klien langsung dan tidak langsung disertakan, termasuk manajer itu sendiri.

Representasi JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Kolom
resourceName

string

Nama resource klien pelanggan. Nama resource CustomerClient memiliki bentuk: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Nama resource label yang dimiliki oleh pelanggan yang meminta dan diterapkan untuk pelanggan klien. Nama resource label memiliki bentuk:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Status pelanggan klien. Hanya baca.

clientCustomer

string

Nama resource klien-pelanggan yang ditautkan ke pelanggan tertentu. Hanya baca.

hidden

boolean

Menentukan apakah akun ini disembunyikan.

Hanya baca.

level

string (int64 format)

Jarak antara pelanggan dan klien tertentu. Untuk self link, nilai levelnya adalah 0. Hanya baca.

timeZone

string

Representasi string Common Locale Data Repository (CLDR) dari zona waktu klien, misalnya, America/Los_Angeles. Hanya baca.

testAccount

boolean

Mengidentifikasi apakah klien adalah akun pengujian. Hanya baca.

manager

boolean

Mengidentifikasi apakah klien adalah seorang manajer. Hanya baca.

descriptiveName

string

Nama deskriptif untuk klien. Hanya baca.

currencyCode

string

Kode mata uang (misalnya, 'USD', 'EUR') untuk klien. Hanya baca.

id

string (int64 format)

ID pelanggan klien. Hanya baca.

DynamicSearchAdsSearchTermView

Tampilan istilah penelusuran di iklan Penelusuran Dinamis.

Representasi JSON
{
  "resourceName": string,
  "landingPage": string
}
Kolom
resourceName

string

Nama resource tampilan istilah penelusuran iklan Penelusuran Dinamis. Nama resource tampilan istilah penelusuran di iklan Penelusuran Dinamis memiliki bentuk:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

URL halaman landing tayangan yang dipilih secara dinamis.

Kolom ini bersifat hanya baca.

GenderView

Tampilan gender. Resource genderView mencerminkan status penayangan efektif, bukan kriteria yang ditambahkan. Grup iklan tanpa kriteria gender secara default ditampilkan kepada semua gender, sehingga semua gender muncul di genderView dengan statistik.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan gender. Nama resource tampilan gender memiliki bentuk:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Konstanta target geografis.

Representasi JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Kolom
resourceName

string

Nama resource dari konstanta target geografis. Nama resource konstanta target geografis memiliki bentuk:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Status konstanta target geografis.

id

string (int64 format)

ID konstanta target geografis.

name

string

Nama bahasa Inggris konstanta target geografis.

countryCode

string

Kode negara ISO-3166-1 alpha-2 yang terkait dengan target.

targetType

string

Jenis target konstanta target geografis.

canonicalName

string

Nama berbahasa Inggris yang sepenuhnya memenuhi syarat, yang terdiri dari nama target dan nama orang tua serta negara target.

parentGeoTarget

string

Nama resource dari konstanta target geografis induk. Nama resource konstanta target geografis memiliki bentuk:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Kemungkinan status dari konstanta target geografis.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN

Nilai yang diterima tidak diketahui dalam versi ini.

Ini adalah nilai khusus respons.

ENABLED Konstanta target geografis valid.
REMOVAL_PLANNED Konstanta target geografis sudah tidak berlaku dan akan dihapus.

KeywordView

Tampilan kata kunci.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan kata kunci. Nama resource tampilan kata kunci memiliki bentuk:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Label

Label.

Representasi JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Kolom
resourceName

string

Nama resource. Nama resource label memiliki bentuk: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Status label. Hanya baca.

textLabel

object (TextLabel)

Jenis label yang menampilkan teks pada latar belakang berwarna.

id

string (int64 format)

ID label. Hanya baca.

name

string

Nama label.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat label baru.

Panjang string ini harus antara 1 dan 80, inklusif.

LabelStatus

Kemungkinan status label.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Label diaktifkan.
REMOVED Label dihapus.

TextLabel

Jenis label yang menampilkan teks pada latar belakang berwarna.

Representasi JSON
{
  "backgroundColor": string,
  "description": string
}
Kolom
backgroundColor

string

Warna latar belakang label dalam format HEX. String ini harus cocok dengan ekspresi reguler '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Catatan: Warna latar belakang mungkin tidak terlihat untuk akun pengelola.

description

string

Deskripsi singkat tentang label. Panjang tidak boleh lebih dari 200 karakter.

LanguageConstant

Bahasa.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Kolom
resourceName

string

Nama resource konstanta bahasa. Nama resource konstanta bahasa memiliki bentuk:

languageConstants/{criterionId}

id

string (int64 format)

ID konstanta bahasa.

code

string

Kode bahasa, misalnya, "en_US", "en_AU", "es", "fr", dll.

name

string

Nama lengkap bahasa dalam bahasa Inggris, misalnya, "Inggris (AS)", "Spanyol", dll.

targetable

boolean

Apakah bahasa dapat ditargetkan.

LocationView

Tampilan lokasi meringkas performa kampanye berdasarkan Kriteria lokasi.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan lokasi. Nama resource tampilan lokasi memiliki bentuk:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Kategori Bidding Produk.

Representasi JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Kolom
resourceName

string

Nama resource kategori bidding produk. Nama resource kategori bidding produk memiliki bentuk:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Tingkat kategori bidding produk.

status

enum (ProductBiddingCategoryStatus)

Status kategori bidding produk.

id

string (int64 format)

ID kategori bidding produk.

ID ini setara dengan ID google_product_category seperti yang dijelaskan dalam artikel ini: https://support.google.com/merchants/answer/6324436.

countryCode

string

Kode negara dua huruf besar dari kategori bidding produk.

productBiddingCategoryConstantParent

string

Nama resource dari kategori bidding produk induk.

languageCode

string

Kode bahasa dari kategori bidding produk.

localizedName

string

Nilai tampilan kategori bidding produk yang dilokalkan menurut languageCode.

ProductBiddingCategoryLevel

Enum yang mendeskripsikan tingkat kategori bidding produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
LEVEL1 Tingkat 1.
LEVEL2 Tingkat 2.
LEVEL3 Tingkat 3.
LEVEL4 Tingkat 4.
LEVEL5 Tingkat 5.

ProductBiddingCategoryStatus

Enum yang mendeskripsikan status kategori bidding produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ACTIVE Kategori aktif dan dapat digunakan untuk bidding.
OBSOLETE Kategori ini sudah tidak berlaku. Hanya digunakan untuk tujuan pelaporan.

ProductGroupView

Tampilan grup produk.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan grup produk. Nama resource tampilan grup produk memiliki bentuk:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Tampilan performa Shopping. Menyediakan statistik kampanye Shopping yang digabungkan pada beberapa tingkat dimensi produk. Nilai dimensi produk dari Merchant Center seperti merek, kategori, atribut khusus, kondisi produk, dan jenis produk akan mencerminkan status setiap dimensi pada tanggal dan waktu saat peristiwa yang sesuai dicatat.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan performa Shopping. Nama resource tampilan performa Shopping memiliki bentuk: customers/{customerId}/shoppingPerformanceView

UserList

Daftar pengguna. Ini adalah daftar pengguna yang mungkin ditargetkan oleh pelanggan.

Representasi JSON
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Kolom
resourceName

string

Nama resource daftar pengguna. Nama resource daftar pengguna memiliki bentuk:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Jenis daftar ini.

Kolom ini bersifat hanya baca.

id

string (int64 format)

ID daftar pengguna.

name

string

Nama daftar pengguna ini. Bergantung pada access_reason-nya, nama daftar pengguna mungkin tidak unik (misalnya, jika access_reason=SHARED)

UserListType

Enum yang berisi kemungkinan jenis daftar pengguna.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
REMARKETING DaftarPengguna yang direpresentasikan sebagai kumpulan jenis konversi.
LOGICAL Daftar Pengguna direpresentasikan sebagai kombinasi dari daftar/minat pengguna lainnya.
EXTERNAL_REMARKETING DaftarPengguna yang dibuat di platform Google Ad Manager.
RULE_BASED DaftarPengguna yang terkait dengan aturan.
SIMILAR {i>UserList<i} dengan pengguna yang serupa dengan pengguna UserList lain.
CRM_BASED Daftar Pengguna data CRM pihak pertama yang disediakan pengiklan dalam bentuk email atau format lainnya.

WebpageView

Tampilan halaman web.

Representasi JSON
{
  "resourceName": string
}
Kolom
resourceName

string

Nama resource tampilan halaman web. Nama resource tampilan halaman web memiliki bentuk:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Kunjungi

Kunjungan.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Kolom
resourceName

string

Nama resource kunjungan. Nama resource kunjungan memiliki bentuk:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

ID kunjungan.

criterionId

string (int64 format)

ID kata kunci Search Ads 360. Nilai 0 menunjukkan bahwa kata kunci tidak diatribusikan.

merchantId

string (int64 format)

ID akun inventaris Search Ads 360 yang berisi produk yang diklik. Search Ads 360 akan membuat ID ini saat Anda menautkan akun inventaris di Search Ads 360.

adId

string (int64 format)

ID Iklan. Nilai 0 menunjukkan bahwa iklan tidak diatribusikan.

clickId

string

String unik untuk setiap kunjungan yang diteruskan ke halaman landing sebagai parameter URL ID klik.

visitDateTime

string

Stempel waktu peristiwa kunjungan. Stempel waktu berada dalam zona waktu pelanggan dan dalam "yyyy-MM-dd HH:mm:ss" format font.

productId

string

ID produk diklik.

productChannel

enum (ProductChannel)

Saluran penjualan produk yang diklik: Online atau Lokal.

productLanguageCode

string

Bahasa (ISO-639-1) yang telah ditetapkan untuk feed Merchant Center yang berisi data tentang produk.

productStoreId

string

Toko di Iklan Inventaris Lokal yang diklik. Ini harus cocok dengan ID toko yang digunakan di feed produk lokal Anda.

productCountryCode

string

Negara (format ISO-3166) yang terdaftar untuk feed inventaris yang berisi produk yang diklik.

assetId

string (int64 format)

ID aset yang menerima interaksi selama peristiwa kunjungan.

assetFieldType

enum (AssetFieldType)

Jenis kolom aset peristiwa kunjungan.

ProductChannel

Enum yang menjelaskan lokalitas penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ONLINE Item tersebut dijual secara online.
LOCAL Item dijual di toko lokal.

Konversi

Konversi.

Representasi JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Kolom
resourceName

string

Nama resource konversi. Nama resource konversi memiliki bentuk:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

ID konversi

criterionId

string (int64 format)

ID kriteria Search Ads 360. Nilai 0 menunjukkan bahwa kriteria tersebut tidak diatribusikan.

merchantId

string (int64 format)

ID akun inventaris Search Ads 360 yang berisi produk yang diklik. Search Ads 360 akan membuat ID ini saat Anda menautkan akun inventaris di Search Ads 360.

adId

string (int64 format)

ID Iklan. Nilai 0 menunjukkan bahwa iklan tidak diatribusikan.

clickId

string

String unik, untuk kunjungan yang diatribusikan ke konversi, yang diteruskan ke halaman landing sebagai parameter URL ID klik.

visitId

string (int64 format)

ID kunjungan Search Ads 360 yang diatribusikan ke konversi.

advertiserConversionId

string

Untuk konversi offline, ID ini adalah ID yang diberikan oleh pengiklan. Jika pengiklan tidak menentukan ID tersebut, Search Ads 360 akan membuat ID tersebut. Untuk konversi online, nilainya sama dengan kolom id atau kolom FloodlightOrderId, bergantung pada petunjuk Floodlight pengiklan.

productId

string

ID produk diklik.

productChannel

enum (ProductChannel)

Saluran penjualan produk yang diklik: Online atau Lokal.

productLanguageCode

string

Bahasa (ISO-639-1) yang telah ditetapkan untuk feed Merchant Center yang berisi data tentang produk.

productStoreId

string

Toko di Iklan Inventaris Lokal yang diklik. Ini harus cocok dengan ID toko yang digunakan di feed produk lokal Anda.

productCountryCode

string

Negara (format ISO-3166) yang terdaftar untuk feed inventaris yang berisi produk yang diklik.

attributionType

enum (AttributionType)

Konversi ini diatribusikan: Kunjungan atau Kata Kunci+Iklan.

conversionDateTime

string

Stempel waktu peristiwa konversi.

conversionLastModifiedDateTime

string

Stempel waktu saat terakhir kali konversi diubah.

conversionVisitDateTime

string

Stempel waktu kunjungan yang diatribusikan ke konversi.

conversionQuantity

string (int64 format)

Jumlah item yang dicatat oleh konversi, seperti yang ditentukan oleh parameter URL jml. Pengiklan bertanggung jawab untuk mengisi parameter secara dinamis (seperti jumlah item yang terjual dalam konversi), jika tidak, parameter ini ditetapkan secara default ke 1.

conversionRevenueMicros

string (int64 format)

Pendapatan yang disesuaikan dalam mikro untuk peristiwa konversi. Tanggal ini akan selalu menggunakan mata uang akun penayangan.

floodlightOriginalRevenue

string (int64 format)

Pendapatan asli yang tidak berubah yang terkait dengan peristiwa Floodlight (dalam mata uang laporan saat ini), sebelum petunjuk mata uang Floodlight diubah.

floodlightOrderId

string

ID pesanan Floodlight yang diberikan oleh pengiklan untuk konversi.

status

enum (ConversionStatus)

Status konversi, DIAKTIFKAN atau DIHAPUS.

assetId

string (int64 format)

ID aset yang menerima interaksi selama peristiwa konversi.

assetFieldType

enum (AssetFieldType)

Jenis kolom aset peristiwa konversi.

AttributionType

Jenis atribusi konversi di SearchAds360

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
VISIT Konversi diatribusikan ke kunjungan.
CRITERION_AD Konversi diatribusikan ke kriteria dan pasangan iklan.

ConversionStatus

Kemungkinan status konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Konversi diaktifkan.
REMOVED Konversi telah dihapus.

Metrik

Data metrik.

Representasi JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Kolom
allConversionsValueByConversionDate

number

Nilai semua konversi. Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi. Detail untuk kolom by_conversion_date tersedia di https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

Jumlah total konversi. Tindakan ini mencakup semua konversi terlepas dari nilai includeInConversionsMetric. Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi. Detail untuk kolom by_conversion_date tersedia di https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

Metrik kustom konversi.

conversionsValueByConversionDate

number

Jumlah nilai konversi yang dapat di-bid berdasarkan tanggal konversi. Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi.

conversionsByConversionDate

number

Jumlah konversi berdasarkan tanggal konversi untuk jenis konversi yang dapat di-bid. Dapat berupa pecahan karena pemodelan atribusi. Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Skor kualitas historis materi iklan.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Kualitas histori kualitas halaman landing.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Prediksi rasio klik-tayang (CTR) penelusuran historis.

interactionEventTypes[]

enum (InteractionEventType)

Jenis interaksi yang dapat dibayar dan gratis.

rawEventConversionMetrics[]

object (Value)

Metrik konversi peristiwa mentah.

absoluteTopImpressionPercentage

number

Pangsa tayangan iklan teratas absolut Penelusuran adalah persentase tayangan iklan Penelusuran Anda yang ditampilkan di posisi paling terlihat pada Penelusuran.

allConversionsFromInteractionsRate

number

Semua konversi dari interaksi (kebalikan dari konversi lihat-tayang) dibagi dengan jumlah interaksi iklan.

allConversionsValue

number

Nilai semua konversi.

allConversions

number

Jumlah total konversi. Tindakan ini mencakup semua konversi terlepas dari nilai includeInConversionsMetric.

allConversionsValuePerCost

number

Nilai semua konversi dibagi dengan total biaya interaksi iklan (seperti klik untuk iklan teks atau penayangan untuk iklan video).

allConversionsFromClickToCall

number

Frekuensi orang mengklik "Telepon" untuk menghubungi toko selama atau setelah mengklik iklan. Jumlah ini tidak mencakup apakah panggilan tersambung atau tidak, atau durasi panggilan apa pun.

Metrik ini hanya berlaku untuk elemen feed.

allConversionsFromDirections

number

Frekuensi orang mengklik "Dapatkan rute" untuk membuka toko setelah mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

allConversionsFromInteractionsValuePerInteraction

number

Nilai semua konversi dari interaksi dibagi dengan jumlah total interaksi.

allConversionsFromMenu

number

Frekuensi orang mengklik link untuk melihat menu toko setelah mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

allConversionsFromOrder

number

Frekuensi orang melakukan pemesanan di toko setelah mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

allConversionsFromOtherEngagement

number

Jumlah konversi lain (misalnya, memposting ulasan atau menyimpan lokasi untuk toko) yang terjadi setelah orang mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

allConversionsFromStoreVisit

number

Estimasi frekuensi orang mengunjungi toko setelah mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

visits

number

Klik yang berhasil dicatat dan diteruskan oleh Search Ads 360 ke halaman landing pengiklan.

allConversionsFromStoreWebsite

number

Frekuensi orang diarahkan ke URL toko setelah mengklik iklan.

Metrik ini hanya berlaku untuk elemen feed.

averageCost

number

Jumlah rata-rata yang Anda bayar per interaksi. Jumlah ini merupakan total biaya iklan Anda dibagi dengan jumlah total interaksi

averageCpc

number

Biaya total semua klik dibagi dengan jumlah total klik yang diterima. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

Biaya per seribu tayangan (CPM) rata-rata Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string (int64 format)

Jumlah klik.

contentBudgetLostImpressionShare

number

Estimasi persentase frekuensi iklan Anda valid untuk ditampilkan di Jaringan Display, tetapi tidak tampil karena anggaran terlalu rendah. Catatan: Pangsa tayangan iklan yang hilang anggaran konten dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

contentImpressionShare

number

Tayangan iklan yang Anda terima di Jaringan Display dibagi dengan estimasi jumlah tayangan iklan yang valid untuk Anda terima. Catatan: Pangsa tayangan iklan konten dilaporkan dalam rentang 0,1 hingga 1. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

contentRankLostImpressionShare

number

Estimasi persentase tayangan iklan di Jaringan Display yang tidak diterima iklan Anda karena Peringkat Iklan yang buruk. Catatan: Pangsa tayangan iklan yang hilang untuk peringkat konten dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

conversionsFromInteractionsRate

number

Rata-rata konversi yang dapat di-bid (dari interaksi) per interaksi yang memenuhi syarat untuk konversi. Menampilkan frekuensi rata-rata interaksi iklan menghasilkan konversi yang dapat di-bid.

clientAccountConversionsValue

number

Nilai konversi akun klien. Hal ini hanya mencakup tindakan konversi yang atribut includeInClientAccountConversionsMetric ditetapkan ke true. Jika Anda menggunakan bidding berbasis konversi, strategi bidding Anda akan dioptimalkan untuk konversi ini.

conversionsValuePerCost

number

Nilai konversi yang dapat di-bid dibagi dengan total biaya konversi interaksi yang memenuhi syarat.

conversionsFromInteractionsValuePerInteraction

number

Nilai konversi dari interaksi dibagi dengan jumlah interaksi iklan. Hal ini hanya mencakup tindakan konversi yang atribut includeInConversionsMetric ditetapkan ke true. Jika Anda menggunakan bidding berbasis konversi, strategi bidding Anda akan dioptimalkan untuk konversi ini.

clientAccountConversions

number

Jumlah konversi akun klien. Hal ini hanya mencakup tindakan konversi yang atribut includeInClientAccountConversionsMetric ditetapkan ke true. Jika Anda menggunakan bidding berbasis konversi, strategi bidding Anda akan dioptimalkan untuk konversi ini.

costMicros

string (int64 format)

Jumlah biaya untuk biaya per klik (BPK) dan biaya per seribu tayangan (BPS) selama periode ini. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

costPerAllConversions

number

Biaya interaksi iklan dibagi dengan semua konversi.

costPerConversion

number

Biaya per konversi yang dapat di-bid rata-rata konversi rata-rata.

costPerCurrentModelAttributedConversion

number

Biaya interaksi iklan dibagi dengan konversi yang diatribusikan model saat ini. Hal ini hanya mencakup tindakan konversi yang atribut includeInConversionsMetric ditetapkan ke true. Jika Anda menggunakan bidding berbasis konversi, strategi bidding Anda akan dioptimalkan untuk konversi ini.

crossDeviceConversions

number

Konversi dari saat pelanggan mengklik iklan di satu perangkat, kemudian melakukan konversi di perangkat atau browser lain. Konversi lintas-perangkat sudah disertakan dalam allConversions.

crossDeviceConversionsValue

number

Jumlah nilai konversi lintas-perangkat.

ctr

number

Jumlah klik yang diterima iklan (Klik) dibagi dengan frekuensi iklan ditampilkan (Tayangan).

conversions

number

Jumlah konversi. Hal ini hanya mencakup tindakan konversi yang atribut includeInConversionsMetric ditetapkan ke true. Jika Anda menggunakan bidding berbasis konversi, strategi bidding Anda akan dioptimalkan untuk konversi ini.

conversionsValue

number

Jumlah nilai konversi untuk konversi yang disertakan dalam "konversi" kolom tersebut. Metrik ini hanya berguna jika Anda memasukkan nilai untuk tindakan konversi.

averageQualityScore

number

Skor kualitas rata-rata.

historicalQualityScore

string (int64 format)

Histori skor kualitas.

impressions

string (int64 format)

Jumlah frekuensi iklan ditampilkan pada halaman hasil penelusuran atau situs di Jaringan Google.

interactionRate

number

Seberapa sering orang berinteraksi dengan iklan Anda setelah iklan tersebut ditampilkan kepada mereka. Ini adalah jumlah interaksi dibagi dengan frekuensi iklan ditampilkan.

interactions

string (int64 format)

Jumlah interaksi. Interaksi adalah tindakan pengguna utama yang terkait dengan klik format iklan untuk iklan teks dan iklan Shopping, penayangan untuk iklan video, dan sebagainya.

invalidClickRate

number

Persentase klik yang difilter dari jumlah total klik (klik yang difilter + tidak difilter) selama periode pelaporan.

invalidClicks

string (int64 format)

Jumlah klik yang dianggap tidak sah oleh Google dan tidak dikenai biaya kepada Anda.

mobileFriendlyClicksPercentage

number

Persentase klik seluler yang mengarah ke halaman yang mobile-friendly.

searchAbsoluteTopImpressionShare

number

Persentase tayangan iklan Shopping atau Penelusuran pelanggan yang ditampilkan di posisi Shopping yang paling terlihat. Lihat https://support.google.com/sa360/answer/9566729 untuk mengetahui detailnya. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Angka yang memperkirakan seberapa sering iklan Anda tidak menjadi iklan pertama di antara iklan teratas pada hasil penelusuran karena anggaran yang rendah. Catatan: Pangsa tayangan iklan teratas absolut yang hilang untuk anggaran Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchBudgetLostImpressionShare

number

Estimasi persentase frekuensi iklan Anda memenuhi syarat untuk ditampilkan di Jaringan Penelusuran, tetapi tidak ditampilkan karena anggaran terlalu rendah. Catatan: Pangsa tayangan iklan yang hilang untuk anggaran Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchBudgetLostTopImpressionShare

number

Angka yang memperkirakan seberapa sering iklan Anda tidak ditampilkan berdekatan dengan hasil penelusuran organik teratas karena anggaran yang rendah. Catatan: Pangsa tayangan iklan teratas yang hilang untuk anggaran Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchClickShare

number

Jumlah klik yang diterima iklan di Jaringan Penelusuran dibagi dengan estimasi jumlah klik yang valid untuk Anda terima. Catatan: Pangsa klik penelusuran dilaporkan dalam rentang 0,1 hingga 1. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

searchExactMatchImpressionShare

number

Tayangan yang Anda terima dibagi dengan estimasi jumlah tayangan iklan yang valid untuk Anda terima di Jaringan Penelusuran untuk istilah penelusuran yang sama persis dengan kata kunci Anda (atau varian yang mirip dengan kata kunci Anda), terlepas dari jenis pencocokan kata kunci Anda. Catatan: Pangsa tayangan iklan pencocokan persis Penelusuran dilaporkan dalam rentang 0,1 hingga 1. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

searchImpressionShare

number

Tayangan iklan yang Anda terima di Jaringan Penelusuran dibagi dengan estimasi jumlah tayangan iklan yang valid untuk Anda terima. Catatan: Pangsa tayangan iklan Penelusuran dilaporkan dalam rentang 0,1 hingga 1. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Angka yang memperkirakan seberapa sering iklan Anda tidak menjadi iklan pertama di antara iklan teratas di hasil penelusuran karena Peringkat Iklan yang buruk. Catatan: Pangsa tayangan iklan teratas absolut yang hilang dari peringkat Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchRankLostImpressionShare

number

Estimasi persentase tayangan iklan di Jaringan Penelusuran yang tidak diterima iklan Anda karena Peringkat Iklan yang buruk. Catatan: Pangsa tayangan iklan yang hilang untuk peringkat Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchRankLostTopImpressionShare

number

Angka yang memperkirakan seberapa sering iklan Anda tidak ditampilkan berdekatan dengan hasil penelusuran organik teratas karena Peringkat Iklan yang buruk. Catatan: Pangsa tayangan iklan teratas yang hilang peringkat Penelusuran dilaporkan dalam rentang 0 hingga 0,9. Setiap nilai di atas 0,9 dilaporkan sebagai 0,9001.

searchTopImpressionShare

number

Tayangan yang Anda terima di antara iklan teratas dibandingkan dengan estimasi jumlah tayangan yang berhak Anda terima di antara iklan teratas. Catatan: Pangsa tayangan iklan teratas Penelusuran dilaporkan dalam rentang 0,1 hingga 1. Setiap nilai di bawah 0,1 dilaporkan sebagai 0,0999.

Iklan teratas biasanya berada di atas hasil organik teratas, meskipun iklan teratas dapat ditampilkan di bawah hasil organik teratas pada kueri tertentu.

topImpressionPercentage

number

Persentase tayangan iklan yang ditampilkan berdekatan dengan hasil penelusuran organik teratas.

valuePerAllConversions

number

Nilai semua konversi dibagi dengan jumlah semua konversi.

valuePerAllConversionsByConversionDate

number

Nilai semua konversi dibagi dengan jumlah semua konversi. Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi. Detail untuk kolom by_conversion_date tersedia di https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

Nilai konversi yang dapat di-bid dibagi dengan jumlah konversi yang dapat di-bid. Menunjukkan berapa nilai rata-rata masing-masing konversi yang dapat di-bid.

valuePerConversionsByConversionDate

number

Nilai konversi yang dapat di-bid menurut tanggal konversi dibagi dengan konversi yang dapat di-bid dengan tanggal konversi. Menampilkan berapa banyak, rata-rata nilai setiap konversi yang dapat di-bid (berdasarkan tanggal konversi). Jika kolom ini dipilih dengan tanggal, nilai pada kolom tanggal berarti tanggal konversi.

clientAccountViewThroughConversions

string (int64 format)

Total jumlah konversi lihat-tayang. Hal ini terjadi saat pelanggan melihat iklan gambar atau multimedia, lalu menyelesaikan konversi di situs Anda tanpa berinteraksi dengan (misalnya, mengklik) iklan lain.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Harga pokok penjualan cross-sell (COGS) akun klien adalah total biaya produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Harga pokok penjualan cross-sell adalah total biaya produk yang terjual yang tidak diiklankan. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Nilai harga pokok penjualan topi tersebut adalah $3 dan nilai harga pokok penjualan kemeja tersebut adalah $5. Harga pokok penjualan cross-sell untuk pesanan ini adalah $5. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

Harga pokok penjualan cross-sell (COGS) adalah total biaya produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Harga pokok penjualan cross-sell adalah total biaya produk yang terjual yang tidak diiklankan. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Nilai harga pokok penjualan topi tersebut adalah $3 dan nilai harga pokok penjualan kemeja tersebut adalah $5. Harga pokok penjualan cross-sell untuk pesanan ini adalah $5. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Laba kotor cross-sell akun klien adalah laba yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang berbeda, dikurangi harga pokok penjualan (COGS). Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pembelian adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Laba kotor cross-sell adalah pendapatan yang Anda hasilkan dari cross-sell yang diatribusikan ke iklan dikurangi harga pokok penjualan. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Kemeja tersebut dihargai $20 dan memiliki nilai barang yang terjual sebesar $5. Laba kotor cross-sell dari pesanan ini adalah $15 = $20 - $5. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

Laba kotor cross-sell adalah laba yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang berbeda, dikurangi harga pokok penjualan (COGS). Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pembelian adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Laba kotor cross-sell adalah pendapatan yang Anda hasilkan dari cross-sell yang diatribusikan ke iklan dikurangi harga pokok penjualan. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Kemeja tersebut dihargai $20 dan memiliki nilai barang yang terjual sebesar $5. Laba kotor cross-sell dari pesanan ini adalah $15 = $20 - $5. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

Pendapatan cross-sell akun klien adalah jumlah total yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Pendapatan cross-sell adalah total nilai yang dihasilkan dari cross-sell yang diatribusikan ke iklan Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi $10 dan harga kemeja $20. Pendapatan cross-sell dari pesanan ini adalah $20. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

Pendapatan cross-sell adalah jumlah total yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Pendapatan cross-sell adalah total nilai yang dihasilkan dari cross-sell yang diatribusikan ke iklan Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi $10 dan harga kemeja $20. Pendapatan cross-sell dari pesanan ini adalah $20. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

Unit cross-sell akun klien terjual adalah jumlah total produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Unit cross-sell terjual adalah jumlah total produk cross-sell dari semua pesanan yang diatribusikan ke iklan Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut, sebuah kemeja, dan sebuah jaket. Unit cross-sell terjual dalam pesanan ini adalah 2. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang.

crossSellUnitsSold

number

Unit cross-sell terjual adalah jumlah total produk yang terjual karena mengiklankan produk yang berbeda. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk tersebut tidak cocok, maka hal ini dianggap cross-sell. Unit cross-sell terjual adalah jumlah total produk cross-sell dari semua pesanan yang diatribusikan ke iklan Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut, sebuah kemeja, dan sebuah jaket. Unit cross-sell terjual dalam pesanan ini adalah 2. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Harga pokok penjualan prospek (COGS) akun klien adalah total biaya produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang menerima interaksi memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk yang diiklankan dan yang terjual cocok, maka biaya barang tersebut akan dihitung berdasarkan harga pokok penjualan prospek. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Nilai harga pokok penjualan topi tersebut adalah $3 dan nilai harga pokok penjualan kemeja tersebut adalah $5. Harga pokok penjualan prospek untuk pesanan ini adalah $3. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

Harga pokok penjualan prospek (COGS) adalah total biaya produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang menerima interaksi memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk yang diiklankan dan yang terjual cocok, maka biaya barang tersebut akan dihitung berdasarkan harga pokok penjualan prospek. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Nilai harga pokok penjualan topi tersebut adalah $3 dan nilai harga pokok penjualan kemeja tersebut adalah $5. Harga pokok penjualan prospek untuk pesanan ini adalah $3. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

Laba kotor prospek akun klien adalah laba yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang sama, dikurangi harga pokok penjualan (COGS). Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan yang dilakukan pelanggan adalah produk terjual. Jika produk yang diiklankan dan yang terjual cocok, pendapatan yang Anda hasilkan dari penjualan ini dikurangi harga pokok penjualan adalah laba kotor prospek Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi tersebut $10 dan nilai harga pokok penjualannya $3. Laba kotor prospek untuk pesanan ini adalah $7 = $10 - $3. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

Laba kotor prospek adalah laba yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang sama, dikurangi harga pokok penjualan (COGS). Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan yang dilakukan pelanggan adalah produk terjual. Jika produk yang diiklankan dan yang terjual cocok, pendapatan yang Anda hasilkan dari penjualan ini dikurangi harga pokok penjualan adalah laba kotor prospek Anda. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi tersebut $10 dan nilai harga pokok penjualannya $3. Laba kotor prospek untuk pesanan ini adalah $7 = $10 - $3. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

Pendapatan prospek akun klien adalah jumlah total yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan yang dilakukan pelanggan adalah produk terjual. Jika produk yang diiklankan dan yang terjual cocok, nilai total yang Anda hasilkan dari penjualan produk ini ditampilkan di bagian pendapatan prospek. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi $10 dan harga kemeja $20. Pendapatan prospek untuk pesanan ini adalah $10. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

Pendapatan prospek adalah jumlah total yang Anda hasilkan dari produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan yang dilakukan pelanggan adalah produk terjual. Jika produk yang diiklankan dan yang terjual cocok, nilai total yang Anda hasilkan dari penjualan produk ini ditampilkan di bagian pendapatan prospek. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut dan sebuah kemeja. Harga topi $10 dan harga kemeja $20. Pendapatan prospek untuk pesanan ini adalah $10. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang. Metrik ini adalah nilai moneter dan ditampilkan dalam mata uang pelanggan secara default. Lihat parameter metrics_currency di https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

Unit prospek akun klien yang terjual adalah jumlah total produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk yang diiklankan dan yang terjual cocok, jumlah total produk yang terjual akan ditampilkan di bagian unit prospek yang terjual. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut, sebuah kemeja, dan sebuah jaket. Unit prospek yang terjual dalam pesanan ini adalah 1. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang.

leadUnitsSold

number

Unit prospek terjual adalah jumlah total produk yang terjual karena mengiklankan produk yang sama. Cara kerjanya: Anda melaporkan konversi dengan data keranjang untuk pembelian yang diselesaikan di situs. Jika iklan yang berinteraksi sebelum pembelian memiliki produk terkait (lihat Iklan Shopping), produk ini dianggap sebagai produk yang diiklankan. Setiap produk yang dimasukkan dalam pesanan pelanggan adalah produk yang terjual. Jika produk yang diiklankan dan yang terjual cocok, jumlah total produk yang terjual akan ditampilkan di bagian unit prospek yang terjual. Contoh: Seseorang mengklik iklan Shopping untuk sebuah topi, lalu ia membeli topi tersebut, sebuah kemeja, dan sebuah jaket. Unit prospek yang terjual dalam pesanan ini adalah 1. Metrik ini hanya tersedia jika Anda melaporkan konversi dengan data keranjang.

Nilai

Penampung data generik.

Representasi JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Kolom
Kolom union value. Nilai. value hanya dapat berupa salah satu dari berikut:
booleanValue

boolean

Boolean.

int64Value

string (int64 format)

Sebuah int64.

floatValue

number

Float.

doubleValue

number

{i>Double.<i}

stringValue

string

Sebuah {i>string<i}.

QualityScoreBucket

Enum yang mencantumkan kemungkinan bucket skor kualitas.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
BELOW_AVERAGE Kualitas materi iklan berada di bawah rata-rata.
AVERAGE Kualitas materi iklan rata-rata.
ABOVE_AVERAGE Kualitas materi iklan di atas rata-rata.

InteractionEventType

Enum yang menjelaskan kemungkinan jenis interaksi yang dapat dibayar dan gratis.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
CLICK Klik ke situs. Pada umumnya, interaksi ini mengarah ke lokasi eksternal, biasanya halaman landing pengiklan. Ini juga merupakan InteractionEventType default untuk peristiwa klik.
ENGAGEMENT Niat pengguna yang dinyatakan untuk berinteraksi dengan iklan di tempat.
VIDEO_VIEW Pengguna melihat iklan video.
NONE InteractionEventType default untuk peristiwa konversi iklan. Ini digunakan saat baris konversi iklan TIDAK menunjukkan bahwa interaksi gratis (misalnya, konversi iklan) harus 'dipromosikan' dan dilaporkan sebagai bagian dari metrik inti. Ini hanyalah konversi (iklan) lainnya.

Segmen

Kolom khusus segmen.

Representasi JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Kolom
adNetworkType

enum (AdNetworkType)

Jenis jaringan iklan.

conversionActionCategory

enum (ConversionActionCategory)

Kategori tindakan konversi.

conversionCustomDimensions[]

object (Value)

Dimensi kustom konversi.

dayOfWeek

enum (DayOfWeek)

Hari, misalnya, SENIN.

device

enum (Device)

Perangkat tempat metrik diterapkan.

keyword

object (Keyword)

Kriteria kata kunci.

productChannel

enum (ProductChannel)

Saluran produk.

productChannelExclusivity

enum (ProductChannelExclusivity)

Eksklusivitas saluran produk.

productCondition

enum (ProductCondition)

Kondisi produk.

productSoldCondition

enum (ProductCondition)

Kondisi produk yang terjual.

rawEventConversionDimensions[]

object (Value)

Dimensi konversi peristiwa mentah.

conversionAction

string

Nama resource tindakan konversi.

conversionActionName

string

Nama tindakan konversi.

date

string

Tanggal saat metrik menerapkan format yyyy-MM-dd, misalnya, 2018-04-17.

geoTargetCity

string

Nama resource dari konstanta target geografis yang mewakili sebuah kota.

geoTargetCountry

string

Nama resource dari konstanta target geografis yang mewakili sebuah negara.

geoTargetMetro

string

Nama resource dari konstanta target geografis yang mewakili sebuah metro.

geoTargetRegion

string

Nama resource dari konstanta target geografis yang mewakili suatu region.

hour

integer

Jam dalam sehari sebagai angka antara 0 dan 23, inklusif.

month

string

Bulan sebagaimana diwakili oleh tanggal hari pertama dalam sebulan. Diformat sebagai yyyy-MM-dd.

productBiddingCategoryLevel1

string

Kategori bidding (tingkat 1) produk.

productBiddingCategoryLevel2

string

Kategori bidding (tingkat 2) produk.

productBiddingCategoryLevel3

string

Kategori bidding (tingkat 3) produk.

productBiddingCategoryLevel4

string

Kategori bidding (tingkat 4) produk.

productBiddingCategoryLevel5

string

Kategori bidding (tingkat 5) produk.

productBrand

string

Merek produk.

productCountry

string

Nama resource konstanta target geografis untuk negara penjualan produk.

productCustomAttribute0

string

Atribut khusus 0 produk.

productCustomAttribute1

string

Atribut khusus 1 dari produk.

productCustomAttribute2

string

Atribut khusus 2 produk.

productCustomAttribute3

string

Atribut khusus 3 dari produk.

productCustomAttribute4

string

Atribut khusus 4 produk.

productItemId

string

ID item produk.

productLanguage

string

Nama resource konstanta bahasa untuk bahasa produk.

productSoldBiddingCategoryLevel1

string

Kategori bidding (tingkat 1) dari produk yang terjual.

productSoldBiddingCategoryLevel2

string

Kategori bidding (tingkat 2) dari produk yang terjual.

productSoldBiddingCategoryLevel3

string

Kategori bidding (tingkat 3) dari produk yang terjual.

productSoldBiddingCategoryLevel4

string

Kategori bidding (tingkat 4) dari produk yang terjual.

productSoldBiddingCategoryLevel5

string

Kategori bidding (tingkat 5) dari produk yang terjual.

productSoldBrand

string

Merek produk yang terjual.

productSoldCustomAttribute0

string

Atribut khusus 0 dari produk yang terjual.

productSoldCustomAttribute1

string

Atribut khusus 1 dari produk yang terjual.

productSoldCustomAttribute2

string

Atribut khusus 2 dari produk yang terjual.

productSoldCustomAttribute3

string

Atribut khusus 3 dari produk yang terjual.

productSoldCustomAttribute4

string

Atribut khusus 4 dari produk yang terjual.

productSoldItemId

string

ID item produk yang terjual.

productSoldTitle

string

Judul produk yang terjual.

productSoldTypeL1

string

Jenis (tingkat 1) produk yang terjual.

productSoldTypeL2

string

Jenis (tingkat 2) produk yang terjual.

productSoldTypeL3

string

Jenis (tingkat 3) produk yang terjual.

productSoldTypeL4

string

Jenis (tingkat 4) produk yang terjual.

productSoldTypeL5

string

Jenis (tingkat 5) produk yang terjual.

productStoreId

string

ID toko produk.

productTitle

string

Judul produk.

productTypeL1

string

Jenis (tingkat 1) produk.

productTypeL2

string

Jenis (tingkat 2) produk.

productTypeL3

string

Jenis (tingkat 3) produk.

productTypeL4

string

Jenis (tingkat 4) produk.

productTypeL5

string

Jenis (tingkat 5) produk.

quarter

string

Kuartal yang diwakili oleh tanggal hari pertama kuartal. Menggunakan tahun kalender untuk kuartal, misalnya, kuartal kedua 2018 dimulai pada 01-04-2018. Diformat sebagai yyyy-MM-dd.

week

string

Minggu seperti yang didefinisikan sebagai Senin hingga Minggu, dan diwakili oleh tanggal Senin. Diformat sebagai yyyy-MM-dd.

year

integer

Tahun, dengan format yyyy.

assetInteractionTarget

object (AssetInteractionTarget)

Hanya digunakan dengan metrik CustomerAsset, CampaignAsset, dan AdGroupAsset. Menunjukkan apakah metrik interaksi terjadi pada aset itu sendiri atau aset atau unit iklan yang berbeda. Interaksi (misalnya, klik) dihitung di semua bagian iklan yang ditayangkan (misalnya, Iklan itu sendiri dan komponen lain seperti Sitelink) saat ditayangkan secara bersamaan. Jika interaksiOnThisAsset bernilai benar, berarti interaksi ada pada aset spesifik ini dan jika interaksiOnThisAsset bernilai salah, berarti interaksi tidak berada pada aset spesifik ini, tetapi pada bagian lain dari iklan yang ditayangkan dengan aset ini.

AdNetworkType

Menghitung jenis jaringan Google Ads.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Nilai tidak diketahui dalam versi ini.
SEARCH Pencarian Google.
SEARCH_PARTNERS Partner penelusuran.
CONTENT Display Network.
YOUTUBE_WATCH Video YouTube
MIXED Lintas jaringan.

Kata kunci

Segmen kriteria kata kunci.

Representasi JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Kolom
info

object (KeywordInfo)

Info kata kunci.

adGroupCriterion

string

Nama resource Kriteria GrupIklan.

ProductChannelExclusivity

Enum yang menjelaskan ketersediaan penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
SINGLE_CHANNEL Item hanya dijual melalui satu saluran, baik toko lokal maupun online sebagaimana ditunjukkan oleh Saluran Produknya.
MULTI_CHANNEL Item dicocokkan dengan komponen toko online atau lokalnya, yang menunjukkan bahwa item tersebut tersedia untuk dibeli di kedua ShoppingProductChannels.

ProductCondition

Enum yang mendeskripsikan kondisi penawaran produk.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Mewakili nilai yang tidak diketahui dalam versi ini.
OLD Kondisi produk sudah lama.
NEW Kondisi produk baru.
REFURBISHED Kondisi produk adalah refurbished.
USED Kondisi produk digunakan.

AssetInteractionTarget

Segmen AssetInteractionTarget.

Representasi JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Kolom
asset

string

Nama resource aset.

interactionOnThisAsset

boolean

Hanya digunakan dengan metrik CustomerAsset, CampaignAsset, dan AdGroupAsset. Menunjukkan apakah metrik interaksi terjadi pada aset itu sendiri atau aset atau unit iklan yang berbeda.