Package google.ads.searchads360.v0.resources

ดัชนี

AccessibleBiddingStrategy

หมายถึงมุมมองกลยุทธ์การเสนอราคาที่ลูกค้าเป็นเจ้าของและแชร์กับลูกค้า

ทรัพยากรนี้แตกต่างจากกลยุทธ์การเสนอราคา ทรัพยากรนี้มีกลยุทธ์ที่ผู้จัดการของลูกค้าเป็นเจ้าของและแชร์กับลูกค้ารายนี้ นอกเหนือจากกลยุทธ์ที่ลูกค้ารายนี้เป็นเจ้าของ ทรัพยากรนี้ไม่ได้ให้เมตริกและแสดงเฉพาะแอตทริบิวต์กลยุทธ์การเสนอราคาเพียงบางส่วนเท่านั้น

ช่อง
resource_name

string

ชื่อทรัพยากรของกลยุทธ์การเสนอราคาที่เข้าถึงได้ ชื่อทรัพยากร AccessibleการเสนอราคาตอบStrategy มีรูปแบบดังนี้

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id

int64

รหัสของกลยุทธ์การเสนอราคา
name

string

ชื่อของกลยุทธ์การเสนอราคา
type

BiddingStrategyType

ประเภทของกลยุทธ์การเสนอราคา
owner_customer_id

int64

รหัสของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา
owner_descriptive_name

string

description_name ของลูกค้าซึ่งเป็นเจ้าของกลยุทธ์การเสนอราคา

ฟิลด์สหภาพ scheme รูปแบบการเสนอราคา

ตั้งค่าได้เพียงรายการเดียว scheme ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
maximize_conversion_value

MaximizeConversionValue

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับมูลค่า Conversion สูงที่สุดโดยอยู่ภายในงบประมาณที่กำหนดไว้
maximize_conversions

MaximizeConversions

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับ Conversion มากที่สุดภายในงบประมาณที่กำหนดไว้
target_cpa

TargetCpa

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับ Conversion มากที่สุดที่ราคาต่อหนึ่งการกระทำ (CPA) เป้าหมายที่คุณตั้งไว้
target_impression_share

TargetImpressionShare

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพตามเปอร์เซ็นต์การแสดงผลที่เลือกโดยอัตโนมัติ
target_roas

TargetRoas

กลยุทธ์การเสนอราคาที่ช่วยให้คุณเพิ่มรายได้สูงสุด ในขณะเดียวกันก็เฉลี่ยผลตอบแทนจากค่าโฆษณา (ROAS) เป้าหมายที่ต้องการ
target_spend

TargetSpend

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับคลิกมากที่สุดภายในงบประมาณของคุณ

MaximizeConversionValue

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับมูลค่า Conversion สูงที่สุดโดยอยู่ภายในงบประมาณที่กำหนดไว้

ช่อง
target_roas

double

ตัวเลือกผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) หากตั้งค่า กลยุทธ์การเสนอราคาจะเพิ่มรายได้สูงสุด พร้อมทั้งเฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา หากมี ROAS เป้าหมายสูง กลยุทธ์การเสนอราคาอาจใช้งบประมาณทั้งหมดไม่ได้ หากไม่ได้กำหนด ROAS เป้าหมาย กลยุทธ์การเสนอราคาจะมุ่งให้ได้รับ ROAS สูงสุดเท่าที่จะเป็นไปได้ภายในงบประมาณ

MaximizeConversions

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับ Conversion มากที่สุดภายในงบประมาณที่กำหนดไว้

ช่อง
target_cpa

int64

ตัวเลือกต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมาย นี่เป็นจำนวนเงินเฉลี่ยที่คุณต้องการใช้จ่ายต่อการกระทำ
target_cpa_micros

int64

ตัวเลือกต้นทุนต่อการกระทำหนึ่งครั้ง (CPA) เป้าหมาย นี่เป็นจำนวนเงินเฉลี่ยที่คุณต้องการใช้จ่ายต่อการกระทำ

TargetCpa

กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอเพื่อช่วยให้คุณได้รับ Conversion มากที่สุดเท่าที่จะเป็นไปได้ที่ราคาต่อหนึ่งการกระทำ (CPA) เป้าหมายที่คุณตั้งไว้

ช่อง
target_cpa_micros

int64

เป้าหมาย CPA เฉลี่ย เป้าหมายนี้ควรมากกว่าหรือเท่ากับหน่วยที่เรียกเก็บเงินได้ขั้นต่ำ โดยขึ้นอยู่กับสกุลเงินของบัญชี

TargetImpressionShare

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณาบนเครือข่ายการค้นหาตามจำนวนเปอร์เซ็นต์แสดงที่ด้านบนของหน้าแรก (หรือสถานที่เป้าหมายอื่นๆ)

ช่อง
location

TargetImpressionShareLocation

สถานที่เป้าหมายในหน้าผลการค้นหา
location_fraction_micros

int64

สัดส่วนของโฆษณาที่เลือกให้แสดงในสถานที่เป้าหมายในระดับไมโคร เช่น 1% เท่ากับ 10,000
cpc_bid_ceiling_micros

int64

ราคาเสนอ CPC สูงสุดที่ระบบการเสนอราคาอัตโนมัติได้รับอนุญาตให้ระบุ ช่องนี้เป็นช่องที่ต้องกรอกซึ่งผู้ลงโฆษณาเป็นผู้กำหนดเพดานและระบุไว้ในไมโครภายใน

TargetRoas

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณเพิ่มรายได้ได้สูงสุด ขณะเดียวกันก็เฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง

ช่อง
target_roas

double

รายได้ที่เลือก (ตามข้อมูล Conversion) ต่อหน่วยการใช้จ่าย

TargetSpend

กลยุทธ์การเสนอราคาอัตโนมัติที่กำหนดราคาเสนอเพื่อให้คุณได้รับคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณของคุณ

ช่อง
target_spend_micros
(deprecated)

int64

เป้าหมายการใช้จ่ายที่จะเพิ่มจำนวนคลิกให้สูงสุด ผู้เสนอราคา "ยอดใช้จ่ายเป้าหมาย" จะพยายามใช้จ่ายในค่านี้ให้น้อยลงหรือจากจำนวนค่าใช้จ่ายที่มีการควบคุมตามปกติ หากไม่ได้ระบุ ระบบจะใช้งบประมาณเป็นเป้าหมายการใช้จ่าย ช่องนี้เลิกใช้งานแล้วและไม่ควรใช้งานอีกต่อไป ดูรายละเอียดได้ที่ https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html
cpc_bid_ceiling_micros

int64

ขีดจำกัดราคาเสนอสูงสุดที่กลยุทธ์การเสนอราคากำหนดได้ ขีดจำกัดนี้มีผลกับคีย์เวิร์ดทั้งหมดที่กลยุทธ์นี้จัดการ

โฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของโฆษณา ชื่อทรัพยากรโฆษณามีรูปแบบดังนี้

customers/{customer_id}/ads/{ad_id}
final_urls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสำหรับโฆษณา
type

AdType

ประเภทของโฆษณา
id

int64

รหัสของโฆษณา
display_url

string

URL ที่ปรากฏในคำอธิบายโฆษณาสำหรับรูปแบบโฆษณาบางรูปแบบ
name

string

ชื่อของโฆษณา ซึ่งใช้เพื่อระบุโฆษณาเท่านั้น ซึ่งไม่จำเป็นต้องไม่ซ้ำกันและไม่มีผลต่อโฆษณาที่แสดง ปัจจุบันช่องชื่อรองรับเฉพาะ DisplayUploadAd, ImageAd, ShoppingComparisonListingAd และ VideoAd เท่านั้น
ฟิลด์สหภาพ ad_data รายละเอียดเกี่ยวข้องกับประเภทโฆษณา ต้องตั้งค่าเพียงค่าเดียว ad_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
text_ad

SearchAds360TextAdInfo

รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบข้อความ
expanded_text_ad

SearchAds360ExpandedTextAdInfo

รายละเอียดเกี่ยวกับโฆษณาแบบข้อความที่ขยายออก
responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

รายละเอียดเกี่ยวกับโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
product_ad

SearchAds360ProductAdInfo

รายละเอียดที่เกี่ยวข้องกับโฆษณาผลิตภัณฑ์
expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

รายละเอียดเกี่ยวกับโฆษณา Search แบบไดนามิกอย่างกว้าง

AdGroup

กลุ่มโฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของกลุ่มโฆษณา ชื่อทรัพยากรของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customer_id}/adGroups/{ad_group_id}
status

AdGroupStatus

สถานะของกลุ่มโฆษณา
type

AdGroupType

ประเภทของกลุ่มโฆษณา
ad_rotation_mode

AdGroupAdRotationMode

โหมดการหมุนเวียนโฆษณาของกลุ่มโฆษณา
creation_time

string

การประทับเวลาที่สร้างกลุ่มโฆษณานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
targeting_setting

TargetingSetting

การตั้งค่าสำหรับฟีเจอร์ที่เกี่ยวข้องกับการกำหนดเป้าหมาย
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับกลุ่มโฆษณานี้
engine_id

string

รหัสของกลุ่มโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สำหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu เป็นต้น สำหรับเอนทิตี Google Ads ให้ใช้ "ad_group.id" แทน
start_date

string

วันที่กลุ่มโฆษณานี้เริ่มแสดงโฆษณา โดยค่าเริ่มต้น กลุ่มโฆษณาจะเริ่มต้นทันทีหรือวันที่เริ่มต้นของกลุ่มโฆษณา แล้วแต่ว่าอย่างใดจะเกิดขึ้นทีหลัง หากตั้งค่าช่องนี้ไว้ กลุ่มโฆษณาจะเริ่มต้นที่จุดเริ่มต้นของวันที่ที่ระบุไว้ในเขตเวลาของลูกค้า ช่องนี้มีไว้สําหรับบัญชี Microsoft Advertising และบัญชีเกตเวย์ Facebook เท่านั้น

รูปแบบ: YYYY-MM-DD เช่น 2019-03-14
end_date

string

วันที่ที่กลุ่มโฆษณาสิ้นสุดการแสดงโฆษณา โดยค่าเริ่มต้น กลุ่มโฆษณาจะสิ้นสุดในวันที่สิ้นสุดของกลุ่มโฆษณา หากตั้งค่าช่องนี้ไว้ กลุ่มโฆษณาจะสิ้นสุดเมื่อสิ้นสุดวันที่ที่ระบุไว้ในเขตเวลาของลูกค้า ช่องนี้มีไว้สําหรับบัญชี Microsoft Advertising และบัญชีเกตเวย์ Facebook เท่านั้น

รูปแบบ: YYYY-MM-DD เช่น 2019-03-14
language_code

string

ภาษาของโฆษณาหรือคีย์เวิร์ดในกลุ่มโฆษณา ช่องนี้มีไว้สําหรับบัญชี Microsoft Advertising เท่านั้น ดูรายละเอียดเพิ่มเติมได้ที่ https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time

string

วันที่และเวลาที่กลุ่มโฆษณานี้ได้รับการแก้ไขครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
id

int64

รหัสของกลุ่มโฆษณา
name

string

ชื่อของกลุ่มโฆษณา

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างกลุ่มโฆษณาใหม่

ต้องมีอักขระความกว้างเต็ม UTF-8 น้อยกว่า 255 ตัว

ซึ่งต้องไม่มีอักขระ Null (Code Point 0x0), ฟีดบรรทัด NL (code Point 0xA) หรืออักขระขึ้นบรรทัดใหม่ (Code Point 0xD)
cpc_bid_micros

int64

ราคาเสนอ CPC (ต้นทุนต่อคลิก) สูงสุด
engine_status

AdGroupEngineStatus

สถานะเครื่องมือของกลุ่มโฆษณา

AdGroupAd

โฆษณาในกลุ่มโฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของโฆษณา ชื่อแหล่งข้อมูลโฆษณาของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status

AdGroupAdStatus

สถานะของโฆษณา
ad

Ad

โฆษณา
creation_time

string

การประทับเวลาเมื่อสร้าง ad_group_ad นี้ วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับโฆษณาของกลุ่มโฆษณานี้
engine_id

string

รหัสของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สำหรับบัญชี Search Ads 360 เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu เป็นต้น สําหรับเอนทิตีที่ไม่ใช่ SearchAds 360 ให้ใช้ "ad_group_ad.ad.id" แทน
engine_status

AdGroupAdEngineStatus

สถานะเพิ่มเติมของโฆษณาในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทบัญชีภายนอก) ได้แก่ ใช้งานอยู่ มีสิทธิ์ รอการตรวจสอบ ฯลฯ
last_modified_time

string

วันที่และเวลาที่แก้ไขโฆษณาของกลุ่มโฆษณานี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"

AdGroupAdLabel

ความสัมพันธ์ระหว่างโฆษณาของกลุ่มโฆษณากับป้ายกำกับ

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกำกับโฆษณาของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับโฆษณาของกลุ่มโฆษณามีรูปแบบเป็น customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad

string

โฆษณาของกลุ่มโฆษณาที่ติดป้ายกำกับ
label

string

ป้ายกำกับที่กำหนดให้กับโฆษณาของกลุ่มโฆษณา

AdGroupAsset

ลิงก์ระหว่างกลุ่มโฆษณากับเนื้อหา

ช่อง
resource_name

string

ชื่อทรัพยากรของชิ้นงานกลุ่มโฆษณา ชื่อทรัพยากรกลุ่มโฆษณา Asset Asset จะมีรูปแบบดังนี้

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group

string

ต้องระบุ กลุ่มโฆษณาที่ลิงก์กับชิ้นงาน
asset

string

ต้องระบุ ชิ้นงานที่ลิงก์กับกลุ่มโฆษณา
status

AssetLinkStatus

สถานะชิ้นงานของกลุ่มโฆษณา

AdGroupAssetSet

MastheadAssetSet คือการเชื่อมโยงระหว่างกลุ่มโฆษณากับชุดชิ้นงาน การสร้างกลุ่มโฆษณาAssetSet จะลิงก์ชุดชิ้นงานกับกลุ่มโฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของชุดชิ้นงานกลุ่มโฆษณา ชื่อทรัพยากรชุดชิ้นงานของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group

string

กลุ่มโฆษณาที่ลิงก์กับชุดชิ้นงานนี้
asset_set

string

ชุดชิ้นงานที่ลิงก์กับกลุ่มโฆษณา
status

AssetSetLinkStatus

สถานะของชุดชิ้นงานของกลุ่มโฆษณา อ่านอย่างเดียว

AdGroupAudienceView

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา รวมข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสำหรับเครือข่ายดิสเพลย์และโฆษณาในเครือข่าย YouTube และรายการรีมาร์เก็ตติ้งสำหรับโฆษณา Search (RLSA) ซึ่งรวมในระดับกลุ่มเป้าหมาย

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา ชื่อแหล่งข้อมูลของมุมมองกลุ่มเป้าหมายกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

แสดงตัวปรับราคาเสนอของกลุ่มโฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของตัวปรับราคาเสนอระดับกลุ่มโฆษณา ชื่อทรัพยากรของตัวปรับราคาเสนอระดับกลุ่มโฆษณามีรูปแบบเป็น

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier

double

ตัวแก้ไขสำหรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง: 0.1 - 10.0 ช่วง PreferredContent คือ 1.0-6.0 ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์

ฟิลด์สหภาพ criterion เกณฑ์ของตัวปรับราคาเสนอระดับกลุ่มโฆษณานี้

ต้องใช้ในการสร้างการดำเนินการสร้างที่เริ่มต้นในเวอร์ชัน 5 criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
device

DeviceInfo

เกณฑ์ของอุปกรณ์

AdGroupCriterion

เกณฑ์ของกลุ่มโฆษณา รายงาน ad_group_criterion แสดงเกณฑ์ที่เพิ่มลงในกลุ่มโฆษณาอย่างชัดเจนเท่านั้น

ช่อง
resource_name

string

ชื่อทรัพยากรของเกณฑ์ของกลุ่มโฆษณา ชื่อทรัพยากรเกณฑ์ของกลุ่มโฆษณามีรูปแบบดังนี้

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time

string

การประทับเวลาเมื่อสร้างเกณฑ์ของกลุ่มโฆษณานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
status

AdGroupCriterionStatus

สถานะของเกณฑ์

นี่คือสถานะของเอนทิตีเกณฑ์ของกลุ่มโฆษณาที่กำหนดโดยลูกค้า หมายเหตุ: รายงาน UI อาจรวมข้อมูลเพิ่มเติมที่กำหนดว่าเกณฑ์จะมีสิทธิ์ทำงานหรือไม่ ในบางกรณี เกณฑ์ที่ถูกนำออกใน API อาจยังคงแสดงเป็น "เปิดใช้" ใน UI ตัวอย่างเช่น โดยค่าเริ่มต้น แคมเปญจะแสดงต่อผู้ใช้ทุกช่วงอายุ เว้นแต่จะมีการยกเว้น UI จะแสดงช่วงอายุแต่ละช่วงเป็น "เปิดใช้" เนื่องจากมีสิทธิ์ดูโฆษณา แต่ adCriterion.status จะแสดงเป็น "นำออกแล้ว" เนื่องจากไม่มีการเพิ่มเกณฑ์เชิงบวก
quality_info

QualityInfo

ข้อมูลเกี่ยวกับคุณภาพของเกณฑ์
type

CriterionType

ประเภทของเกณฑ์
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับเกณฑ์ของกลุ่มโฆษณานี้
position_estimates

PositionEstimates

ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในอันดับต่างๆ
final_urls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสำหรับโฆษณา
engine_id

string

รหัสของเกณฑ์ของกลุ่มโฆษณาในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สำหรับบัญชีที่ไม่ใช่ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu เป็นต้น สำหรับเอนทิตี Google Ads ให้ใช้ "ad_group_criterion.criterion_id" แทน
last_modified_time

string

วันที่และเวลาที่แก้ไขเกณฑ์ของกลุ่มโฆษณานี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
criterion_id

int64

รหัสของเกณฑ์
ad_group

string

กลุ่มโฆษณาที่มีเกณฑ์อยู่
negative

bool

จะกำหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์

ฟิลด์นี้จะเปลี่ยนแปลงไม่ได้ หากต้องการเปลี่ยนเกณฑ์จากเชิงบวกเป็นเชิงลบ ให้นำเกณฑ์ออกแล้วเพิ่มกลับเข้าไปใหม่
bid_modifier

double

ตัวแก้ไขสำหรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง: 0.1 - 10.0 ประเภทเกณฑ์ที่กำหนดเป้าหมายได้ส่วนใหญ่รองรับตัวปรับแต่ง
cpc_bid_micros

int64

CPC (ต้นทุนต่อคลิก) ที่เสนอ
effective_cpc_bid_micros

int64

การเสนอราคา CPC (ต้นทุนต่อคลิก) ที่มีประสิทธิภาพ
engine_status

AdGroupCriterionEngineStatus

สถานะเครื่องมือสำหรับเกณฑ์ของกลุ่มโฆษณา
final_url_suffix

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ต่อท้าย URL สุดท้าย
tracking_url_template

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม

ฟิลด์สหภาพ criterion เกณฑ์ของกลุ่มโฆษณา

ต้องตั้งค่าหนึ่งรายการเท่านั้น criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

KeywordInfo

คีย์เวิร์ด
listing_group

ListingGroupInfo

กลุ่มรายชื่อ
age_range

AgeRangeInfo

ช่วงอายุ
gender

GenderInfo

เพศ
user_list

UserListInfo

รายการผู้ใช้
webpage

WebpageInfo

หน้าเว็บ
location

LocationInfo

ตำแหน่ง

PositionEstimates

ค่าประมาณสำหรับราคาเสนอตามเกณฑ์ในอันดับต่างๆ

ช่อง
top_of_page_cpc_micros

int64

ค่าประมาณการเสนอราคา CPC ที่จำเป็นสำหรับการแสดงโฆษณาที่ด้านบนของผลการค้นหาหน้าแรก

QualityInfo

คอนเทนเนอร์สำหรับข้อมูลคุณภาพเกณฑ์ของกลุ่มโฆษณา

ช่อง
quality_score

int32

คะแนนคุณภาพ

ระบบอาจไม่ป้อนข้อมูลในช่องนี้หาก Google มีข้อมูลไม่เพียงพอที่จะกำหนดค่า

AdGroupCriterionLabel

ความสัมพันธ์ระหว่างเกณฑ์ของกลุ่มโฆษณาและป้ายกำกับ

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกำกับเกณฑ์ของกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับเกณฑ์ของกลุ่มโฆษณามีรูปแบบเป็น customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion

string

เกณฑ์ของกลุ่มโฆษณาที่มีการแนบป้ายกำกับ
label

string

ป้ายกำกับที่กำหนดให้กับเกณฑ์ของกลุ่มโฆษณา

AdGroupLabel

ความสัมพันธ์ระหว่างกลุ่มโฆษณาและป้ายกำกับ

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกำกับกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับกลุ่มโฆษณามีรูปแบบเป็น customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group

string

กลุ่มโฆษณาที่ติดป้ายกำกับ
label

string

ป้ายกำกับที่กำหนดให้กับกลุ่มโฆษณา

AgeRangeView

มุมมองช่วงอายุ

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองช่วงอายุ ชื่อแหล่งข้อมูลของมุมมองช่วงอายุมีรูปแบบดังนี้

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

ชิ้นงาน

ชิ้นงานคือส่วนหนึ่งของโฆษณาที่สามารถใช้ร่วมกันในโฆษณาหลายรายการ ซึ่งอาจเป็นรูปภาพ (ImageAsset), วิดีโอ (YouTubeVideoAsset) ฯลฯ ชิ้นงานจะเปลี่ยนแปลงไม่ได้และนำออกไม่ได้ หากต้องการหยุดไม่ให้ชิ้นงานแสดง ให้นําชิ้นงานออกจากเอนทิตีที่ใช้ชิ้นงานอยู่

ช่อง
resource_name

string

ชื่อทรัพยากรของเนื้อหา ชื่อทรัพยากรเนื้อหามีรูปแบบดังนี้

customers/{customer_id}/assets/{asset_id}
type

AssetType

ประเภทของเนื้อหา
final_urls[]

string

รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
status

AssetStatus

สถานะของเนื้อหา
creation_time

string

การประทับเวลาเมื่อสร้างเนื้อหานี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
last_modified_time

string

วันที่และเวลาที่แก้ไขเนื้อหานี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
id

int64

รหัสเนื้อหา
name

string

ชื่อที่ไม่บังคับของเนื้อหา
tracking_url_template

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม
engine_status

AssetEngineStatus

สถานะเครื่องมือสำหรับเนื้อหา
ฟิลด์สหภาพ asset_data ประเภทเนื้อหาที่เฉพาะเจาะจง asset_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
youtube_video_asset

YoutubeVideoAsset

เนื้อหาวิดีโอ YouTube
image_asset

ImageAsset

ชิ้นงานรูปภาพ
text_asset

TextAsset

ชิ้นงานข้อความ
callout_asset

UnifiedCalloutAsset

ชิ้นงานข้อความไฮไลต์แบบรวม
page_feed_asset

UnifiedPageFeedAsset

เนื้อหาฟีดหน้าเว็บแบบรวม
mobile_app_asset

MobileAppAsset

ชิ้นงานแอปบนอุปกรณ์เคลื่อนที่
call_asset

UnifiedCallAsset

ชิ้นงานการโทรแบบรวม
call_to_action_asset

CallToActionAsset

ชิ้นงานคำกระตุ้นให้ดำเนินการ
location_asset

UnifiedLocationAsset

ชิ้นงานสถานที่ตั้งแบบรวม

AssetGroup

กลุ่มชิ้นงาน ระบบใช้ AssetGroupAsset เพื่อลิงก์เนื้อหากับกลุ่มชิ้นงาน AssetGroupSignal ใช้เพื่อเชื่อมโยงสัญญาณกับกลุ่มชิ้นงาน

ช่อง
resource_name

string

ชื่อทรัพยากรของกลุ่มชิ้นงาน ชื่อทรัพยากรของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/assetGroups/{asset_group_id}
id

int64

รหัสของกลุ่มชิ้นงาน
campaign

string

แคมเปญที่เชื่อมโยงกับกลุ่มชิ้นงานนี้ ชิ้นงานที่ลิงก์กับกลุ่มชิ้นงาน
name

string

ต้องระบุ ชื่อกลุ่มชิ้นงาน ต้องระบุ โดยต้องมีความยาวอย่างน้อย 1 และสูงสุด 128 อักขระ ต้องไม่ซ้ำกันในแคมเปญ
final_urls[]

string

รายการ URL สุดท้ายหลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด ใน Performance Max โดยค่าเริ่มต้น URL จะมีสิทธิ์ขยาย เว้นแต่จะเลือกไม่ใช้
final_mobile_urls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด ใน Performance Max โดยค่าเริ่มต้น URL จะมีสิทธิ์ขยาย เว้นแต่จะเลือกไม่ใช้
status

AssetGroupStatus

สถานะของกลุ่มชิ้นงาน
path1

string

ส่วนแรกของข้อความที่อาจปรากฏต่อท้าย URL ที่แสดงในโฆษณา
path2

string

ส่วนที่สองของข้อความที่อาจปรากฏขึ้นต่อท้าย URL ที่แสดงในโฆษณา ตั้งค่าช่องนี้ได้เมื่อตั้งค่าเส้นทาง 1 เท่านั้น
ad_strength

AdStrength

คุณภาพของโฆษณาโดยรวมของกลุ่มชิ้นงานนี้

AssetGroupAsset

AssetGroupAsset คือลิงก์ระหว่างชิ้นงานกับกลุ่มชิ้นงาน การเพิ่ม AssetGroupAsset จะลิงก์เนื้อหากับกลุ่มชิ้นงาน

ช่อง
resource_name

string

ชื่อทรัพยากรของชิ้นงานกลุ่มชิ้นงาน ชื่อทรัพยากรชิ้นงานของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group

string

กลุ่มชิ้นงานที่ชิ้นงานกลุ่มชิ้นงานนี้ลิงก์อยู่
asset

string

ชิ้นงานที่ชิ้นงานกลุ่มชิ้นงานนี้ลิงก์อยู่
field_type

AssetFieldType

คำอธิบายตําแหน่งของชิ้นงานภายในกลุ่มชิ้นงาน เช่น HEADLINE, YOUTUBE_VIDEO เป็นต้น
status

AssetLinkStatus

สถานะของการลิงก์ระหว่างชิ้นงานกับกลุ่มชิ้นงาน

AssetGroupAssetCombinationData

ข้อมูลกลุ่มชิ้นงานแบบผสม

ช่อง
asset_combination_served_assets[]

AssetUsage

เนื้อหาที่แสดง

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter แสดงถึงโหนดโครงสร้างตัวกรองกลุ่มรายชื่อในกลุ่มชิ้นงาน

ช่อง
resource_name

string

ชื่อทรัพยากรของตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงาน ชื่อทรัพยากรตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงานมีแบบฟอร์มดังนี้

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group

string

กลุ่มชิ้นงานที่มีตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงานนี้
id

int64

รหัสของ ListingGroupFilter
type

ListingGroupFilterType

ประเภทโหนดตัวกรองกลุ่มรายชื่อ
vertical

ListingGroupFilterVertical

แนวตั้งที่โหนดทรีปัจจุบันแสดง โหนดทั้งหมดในแผนผังเดียวกันต้องอยู่ในประเภทธุรกิจเดียวกัน
case_value

ListingGroupFilterDimension

ค่ามิติข้อมูลที่กลุ่มรายชื่อนี้ปรับแต่งรายการระดับบนสุด ไม่ได้กำหนดสำหรับกลุ่มรูท
parent_listing_group_filter

string

ชื่อทรัพยากรของการแยกย่อยกลุ่มรายชื่อหลัก ค่า Null สำหรับโหนดตัวกรองกลุ่มรายชื่อรูท
path

ListingGroupFilterDimensionPath

เส้นทางของมิติข้อมูลที่กำหนดตัวกรองกลุ่มรายชื่อนี้

AssetGroupSignal

AssetGroupSignal แสดงสัญญาณในกลุ่มชิ้นงาน การมีสัญญาณจะบอกแคมเปญ Performance Max ว่าใครมีแนวโน้มสูงสุดที่จะทำ Conversion แคมเปญ Performance Max จะใช้สัญญาณนี้เพื่อมองหาผู้ใช้ใหม่ๆ ที่มีความตั้งใจใกล้เคียงหรือมากกว่ากลุ่มเป้าหมายปัจจุบันเพื่อให้ได้ Conversion ใน Search, Display, วิดีโอ และอื่นๆ

ช่อง
resource_name

string

ชื่อทรัพยากรของสัญญาณกลุ่มชิ้นงาน ชื่อทรัพยากรสัญญาณของกลุ่มชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group

string

กลุ่มชิ้นงานที่มีสัญญาณกลุ่มชิ้นงานนี้
ฟิลด์สหภาพ signal สัญญาณของกลุ่มชิ้นงาน signal ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
audience

AudienceInfo

สัญญาณกลุ่มเป้าหมายที่แคมเปญ Performance Max ใช้

AssetGroupTopCombinationView

มุมมองเกี่ยวกับการใช้ชุดค่าผสมชิ้นงานโฆษณาของกลุ่มโฆษณา

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองชุดค่าผสมด้านบนของกลุ่มชิ้นงาน ชื่อทรัพยากรมุมมองชุดค่าผสมยอดนิยมของ AssetGroup จะมีรูปแบบดังนี้ `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]

AssetGroupAssetCombinationData

ชุดค่าผสมสูงสุดของชิ้นงานที่แสดงร่วมกัน

AssetSet

ชุดชิ้นงานที่แสดงถึงคอลเล็กชันเนื้อหา ใช้ AssetSetAsset เพื่อลิงก์ชิ้นงานกับชุดชิ้นงาน

ช่อง
id

int64

รหัสของชุดเนื้อหา
resource_name

string

ชื่อทรัพยากรของชุดเนื้อหา ชื่อทรัพยากรของชุดชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset คือลิงก์ระหว่างชิ้นงานกับชุดชิ้นงาน การเพิ่ม AssetSetAsset จะลิงก์ชิ้นงานกับชุดชิ้นงาน

ช่อง
resource_name

string

ชื่อทรัพยากรของเนื้อหาชุดเนื้อหา ชื่อทรัพยากรชิ้นงานในชุดชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set

string

ชุดชิ้นงานที่ชิ้นงานชุดนี้ลิงก์อยู่
asset

string

เนื้อหาที่ชิ้นงานชุดนี้ลิงก์อยู่
status

AssetSetAssetStatus

สถานะของชิ้นงานชุดชิ้นงาน อ่านอย่างเดียว

ผู้ชม

กลุ่มเป้าหมายคือตัวเลือกการกำหนดเป้าหมายที่มีประสิทธิภาพที่ช่วยให้คุณแบ่งแอตทริบิวต์กลุ่มเป้าหมายต่างๆ เข้าด้วยกันได้ เช่น ข้อมูลประชากรและผู้สนใจโดยละเอียด เพื่อสร้างกลุ่มเป้าหมายที่แสดงถึงส่วนของกลุ่มเป้าหมาย

ช่อง
resource_name

string

ชื่อทรัพยากรของกลุ่มเป้าหมาย ชื่อกลุ่มเป้าหมายมีรูปแบบดังนี้

customers/{customer_id}/audiences/{audience_id}
id

int64

รหัสของกลุ่มเป้าหมาย
name

string

ต้องระบุ ชื่อกลุ่มเป้าหมาย ข้อความต้องไม่ซ้ำกันของกลุ่มเป้าหมายทั้งหมด โดยต้องมีความยาวขั้นต่ำที่ 1 และความยาวสูงสุด 255
description

string

คำอธิบายของกลุ่มเป้าหมายนี้

BiddingStrategy

กลยุทธ์การเสนอราคา

ช่อง
resource_name

string

ชื่อทรัพยากรของกลยุทธ์การเสนอราคา ชื่อทรัพยากรกลยุทธ์การเสนอราคามีรูปแบบดังนี้

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status

BiddingStrategyStatus

สถานะของกลยุทธ์การเสนอราคา

ช่องนี้เป็นแบบอ่านอย่างเดียว
type

BiddingStrategyType

ประเภทของกลยุทธ์การเสนอราคา สร้างกลยุทธ์การเสนอราคาโดยการตั้งค่ารูปแบบการเสนอราคา

ช่องนี้เป็นแบบอ่านอย่างเดียว
currency_code

string

สกุลเงินที่กลยุทธ์การเสนอราคาใช้ (รหัส ISO 4217 ที่เป็นตัวอักษร 3 ตัว)

สำหรับกลยุทธ์การเสนอราคาในกลุ่มลูกค้าบัญชีดูแลจัดการ สกุลเงินนี้จะกำหนดได้เมื่อสร้างขึ้น และเป็นค่าเริ่มต้นเป็นสกุลเงินของลูกค้าผู้จัดการ สำหรับการให้บริการลูกค้า ระบบไม่สามารถตั้งค่าช่องนี้ได้ กลยุทธ์ทั้งหมดของลูกค้าที่ให้บริการใช้สกุลเงินของลูกค้าที่แสดงในการแสดงผลโดยปริยาย ในทุกกรณี ช่องEffective_currency_code จะแสดงสกุลเงินที่กลยุทธ์ใช้
id

int64

รหัสของกลยุทธ์การเสนอราคา
name

string

ชื่อของกลยุทธ์การเสนอราคา กลยุทธ์การเสนอราคาทั้งหมดภายในบัญชีต้องได้รับการตั้งชื่ออย่างชัดเจน

ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 255 ในหน่วยไบต์ UTF-8 (ตัด)
effective_currency_code

string

สกุลเงินที่กลยุทธ์การเสนอราคาใช้ (รหัส ISO 4217 ที่เป็นตัวอักษร 3 ตัว)

สำหรับกลยุทธ์การเสนอราคาในกลุ่มลูกค้าบัญชีดูแลจัดการ สกุลเงินนี้คือสกุลเงินที่ผู้ลงโฆษณากําหนดเมื่อสร้างกลยุทธ์ สำหรับการให้บริการลูกค้า นี่คือ currency_code ของลูกค้า

เมตริกกลยุทธ์การเสนอราคาจะรายงานในสกุลเงินนี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
campaign_count

int64

จำนวนแคมเปญที่แนบกับกลยุทธ์การเสนอราคานี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
non_removed_campaign_count

int64

จำนวนแคมเปญที่ไม่ได้นำออกที่แนบมากับกลยุทธ์การเสนอราคานี้

ช่องนี้เป็นแบบอ่านอย่างเดียว

ฟิลด์สหภาพ scheme รูปแบบการเสนอราคา

ตั้งค่าได้เพียงรายการเดียว scheme ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
enhanced_cpc

EnhancedCpc

กลยุทธ์การเสนอราคาที่จะเพิ่มราคาเสนอสำหรับคลิกที่ดูแล้วมีแนวโน้มที่จะทำให้เกิด Conversion และลดราคาเสนอสำหรับคลิกที่น่าจะมีโอกาสน้อย
maximize_conversion_value

MaximizeConversionValue

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับมูลค่า Conversion สูงที่สุดโดยอยู่ภายในงบประมาณที่กำหนดไว้
maximize_conversions

MaximizeConversions

กลยุทธ์การเสนอราคาอัตโนมัติที่จะช่วยให้คุณได้รับ Conversion มากที่สุดภายในงบประมาณที่กำหนดไว้
target_cpa

TargetCpa

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับ Conversion มากที่สุดที่ราคาต่อหนึ่งการกระทำ (CPA) เป้าหมายที่คุณตั้งไว้
target_impression_share

TargetImpressionShare

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพตามเปอร์เซ็นต์การแสดงผลที่เลือกโดยอัตโนมัติ
target_outrank_share

TargetOutrankShare

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอตามส่วนแบ่งเป้าหมายของการประมูลที่ผู้ลงโฆษณาควรจะมีอันดับสูงกว่าคู่แข่งหนึ่งๆ ช่องนี้เลิกใช้งานแล้ว คุณจะไม่สามารถสร้างกลยุทธ์การเสนอราคาใหม่ด้วยช่องนี้ หรือแนบกลยุทธ์การเสนอราคาที่มีช่องนี้ไว้กับแคมเปญไม่สำเร็จ แต่อนุญาตให้เปลี่ยนแปลงกลยุทธ์ที่มีรูปแบบนี้อยู่แล้ว
target_roas

TargetRoas

กลยุทธ์การเสนอราคาที่ช่วยให้คุณเพิ่มรายได้สูงสุด ในขณะเดียวกันก็เฉลี่ยผลตอบแทนจากค่าโฆษณา (ROAS) เป้าหมายที่ต้องการ
target_spend

TargetSpend

กลยุทธ์การเสนอราคาที่ตั้งราคาเสนอเพื่อช่วยให้คุณได้รับคลิกมากที่สุดภายในงบประมาณของคุณ

แคมเปญ

แคมเปญ

ช่อง
resource_name

string

ชื่อทรัพยากรของแคมเปญ ชื่อทรัพยากรแคมเปญมีรูปแบบดังนี้

customers/{customer_id}/campaigns/{campaign_id}
status

CampaignStatus

สถานะของแคมเปญ

เมื่อมีการเพิ่มแคมเปญใหม่ สถานะเริ่มต้นจะเป็น "เปิดใช้งาน"
serving_status

CampaignServingStatus

สถานะการแสดงโฆษณาของแคมเปญ
bidding_strategy_system_status

BiddingStrategySystemStatus

สถานะระบบของกลยุทธ์การเสนอราคาของแคมเปญ
ad_serving_optimization_status

AdServingOptimizationStatus

สถานะการเพิ่มประสิทธิภาพการแสดงโฆษณาของแคมเปญ
advertising_channel_type

AdvertisingChannelType

เป้าหมายการแสดงโฆษณาหลักสำหรับโฆษณาภายในแคมเปญ คุณปรับแต่งตัวเลือกการกำหนดเป้าหมายได้ในnetwork_settings

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างแคมเปญใหม่

ตั้งค่าได้เมื่อสร้างแคมเปญเท่านั้น หลังจากสร้างแคมเปญแล้วจะเปลี่ยนแปลงไม่ได้
advertising_channel_sub_type

AdvertisingChannelSubType

การปรับแต่งที่ไม่บังคับเป็น advertising_channel_type ต้องเป็นประเภทย่อยที่ถูกต้องของประเภทช่องหลัก

ตั้งค่าได้เมื่อสร้างแคมเปญเท่านั้น หลังจากสร้างแคมเปญแล้ว คุณจะเปลี่ยนช่องนี้ไม่ได้
url_custom_parameters[]

CustomParameter

รายการการแมปที่ใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองใน tracking_url_template, final_urls หรือ mobile_final_urls
real_time_bidding_setting

RealTimeBiddingSetting

การตั้งค่าสำหรับการเสนอราคาแบบเรียลไทม์ ซึ่งเป็นฟีเจอร์ที่ใช้ได้สำหรับแคมเปญที่กำหนดเป้าหมายไปยังเครือข่าย Ad Exchange เท่านั้น
network_settings

NetworkSettings

การตั้งค่าเครือข่ายสำหรับแคมเปญ
dynamic_search_ads_setting

DynamicSearchAdsSetting

การตั้งค่าสําหรับควบคุมโฆษณา Search แบบไดนามิก (DSA)
shopping_setting

ShoppingSetting

การตั้งค่าสำหรับควบคุมแคมเปญ Shopping
geo_target_type_setting

GeoTargetTypeSetting

การตั้งค่าสำหรับการกำหนดเป้าหมายตามภูมิศาสตร์ของโฆษณา
labels[]

string

ชื่อทรัพยากรของป้ายกำกับที่แนบมากับแคมเปญนี้
bidding_strategy_type

BiddingStrategyType

ประเภทของกลยุทธ์การเสนอราคา

คุณสร้างกลยุทธ์การเสนอราคาได้โดยการตั้งค่ารูปแบบการเสนอราคาเพื่อสร้างกลยุทธ์การเสนอราคามาตรฐาน หรือสร้างช่อง bidding_strategy เพื่อสร้างกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอ

ช่องนี้เป็นแบบอ่านอย่างเดียว
accessible_bidding_strategy

string

ชื่อทรัพยากรของ AccessibleBidStrategy ซึ่งเป็นมุมมองอ่านอย่างเดียวของแอตทริบิวต์ที่ไม่จำกัดของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แนบมาซึ่งระบุโดย "bidding_strategy" เว้นว่างไว้ หากแคมเปญไม่ได้ใช้กลยุทธ์พอร์ตโฟลิโอ แอตทริบิวต์กลยุทธ์ที่ไม่จำกัดพร้อมใช้งานสำหรับลูกค้าทุกคนที่แชร์กลยุทธ์ด้วย และลูกค้าที่อ่านกลยุทธ์ AccessibleBidStrategy ได้อ่านแอตทริบิวต์ดังกล่าว ในทางตรงกันข้าม แอตทริบิวต์ที่ถูกจำกัดจะใช้ได้กับลูกค้าที่เป็นเจ้าของกลยุทธ์และผู้จัดการเท่านั้น คุณจะอ่านแอตทริบิวต์ที่ถูกจำกัดได้จากทรัพยากร BiddingStrategy เท่านั้น
frequency_caps[]

FrequencyCapEntry

รายการที่จำกัดความถี่ที่ผู้ใช้แต่ละรายจะเห็นโฆษณาของแคมเปญนี้
selective_optimization

SelectiveOptimization

การตั้งค่าการเพิ่มประสิทธิภาพแบบเลือกส่วนสำหรับแคมเปญนี้ ซึ่งมีชุดการกระทําที่ถือเป็น Conversion ที่จะเพิ่มประสิทธิภาพแคมเปญนี้ ฟีเจอร์นี้ใช้ได้เฉพาะกับ App Campaign ที่ใช้ MULTI_CHANNEL เป็น AdvertisingChannelType และ APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT เป็น AdvertisingChannelSubType เท่านั้น
optimization_goal_setting

OptimizationGoalSetting

การตั้งค่าเป้าหมายการเพิ่มประสิทธิภาพสำหรับแคมเปญนี้ ซึ่งมีชุดประเภทเป้าหมายการเพิ่มประสิทธิภาพ
tracking_setting

TrackingSetting

การตั้งค่าระดับแคมเปญสำหรับข้อมูลการติดตาม
engine_id

string

รหัสของแคมเปญในบัญชีเครื่องมือค้นหาภายนอก ช่องนี้มีไว้สำหรับบัญชีที่ไม่ใช่ของ Google Ads เท่านั้น เช่น Yahoo Japan, Microsoft, Baidu เป็นต้น สำหรับเอนทิตี Google Ads ให้ใช้ "campaign.id" แทน
excluded_parent_asset_field_types[]

AssetFieldType

ประเภทของช่องชิ้นงานที่ควรยกเว้นจากแคมเปญนี้ แคมเปญนี้จะรับช่วงลิงก์เนื้อหากับประเภทช่องเหล่านี้จากระดับบนสุด
create_time

string

การประทับเวลาที่สร้างแคมเปญนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss" โดยจะเลิกใช้งาน create_time ใน v1 ใช้ create_time แทน
creation_time

string

การประทับเวลาที่สร้างแคมเปญนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
last_modified_time

string

วันที่และเวลาที่แก้ไขแคมเปญนี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
id

int64

รหัสของแคมเปญ
name

string

ชื่อแคมเปญ

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างแคมเปญใหม่

ซึ่งต้องไม่มีอักขระ Null (Code Point 0x0), ฟีดบรรทัด NL (code Point 0xA) หรืออักขระขึ้นบรรทัดใหม่ (Code Point 0xD)
tracking_url_template

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม
campaign_budget

string

งบประมาณแคมเปญ
start_date

string

วันที่ที่แคมเปญเริ่มแสดงตามเขตเวลาของลูกค้าในรูปแบบ YYYY-MM-DD
end_date

string

วันสุดท้ายของแคมเปญที่แสดงเขตเวลาของลูกค้าในรูปแบบ YYYY-MM-DD ในการสร้าง ค่าเริ่มต้นคือ 30-12-2037 ซึ่งหมายความว่าแคมเปญจะทำงานโดยไม่มีกําหนด หากต้องการตั้งค่าให้แคมเปญที่มีอยู่ทำงานไปเรื่อยๆ ให้ตั้งค่าช่องนี้เป็น 30-12-2037
final_url_suffix

string

คำต่อท้ายใช้เพื่อเพิ่มพารามิเตอร์การค้นหาต่อท้ายหน้า Landing Page ที่แสดงพร้อมการติดตามพร้อมกัน
url_expansion_opt_out

bool

หมายถึงการเลือกไม่ใช้การขยาย URL ไปยัง URL เป้าหมายเพิ่มเติม หากเลือกไม่ใช้ (จริง) ระบบจะกำหนดเป้าหมายเฉพาะ URL สุดท้ายในกลุ่มชิ้นงานหรือ URL ที่ระบุใน Google Merchant Center หรือฟีดข้อมูลธุรกิจของผู้ลงโฆษณา หากเลือกใช้ (เท็จ) ระบบจะกำหนดเป้าหมายทั้งโดเมน ตั้งค่าช่องนี้ได้กับแคมเปญ Performance Max เท่านั้น ซึ่งค่าเริ่มต้นคือ "เท็จ"

ฟิลด์สหภาพ campaign_bidding_strategy กลยุทธ์การเสนอราคาของแคมเปญ

ต้องเป็นพอร์ตโฟลิโอ (สร้างผ่านบริการ BiddingStrategy) หรือแบบมาตรฐานที่ฝังอยู่ในแคมเปญ campaign_bidding_strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
bidding_strategy

string

กลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แคมเปญใช้
manual_cpa

ManualCpa

กลยุทธ์การเสนอราคา CPA แบบกำหนดเองแบบมาตรฐาน กลยุทธ์การเสนอราคาด้วยตนเองที่ช่วยให้ผู้ลงโฆษณากำหนดราคาเสนอต่อการกระทำที่ผู้ลงโฆษณาระบุได้ รองรับเฉพาะแคมเปญบริการในพื้นที่
manual_cpc

ManualCpc

กลยุทธ์การเสนอราคา CPC ด้วยตนเองแบบมาตรฐาน การเสนอราคาตามการคลิกด้วยตนเองที่ผู้ใช้จ่ายต่อคลิก
manual_cpm

ManualCpm

กลยุทธ์การเสนอราคา CPM ด้วยตนเองแบบมาตรฐาน การเสนอราคาตามการแสดงผลด้วยตนเองที่ผู้ใช้จ่ายต่อการแสดงผล 1,000 ครั้ง
maximize_conversions

MaximizeConversions

กลยุทธ์การเสนอราคาแบบเพิ่มจำนวน Conversion สูงสุดแบบมาตรฐานซึ่งจะเพิ่มจำนวน Conversion สูงสุดโดยอัตโนมัติภายในงบประมาณที่กำหนดไว้
maximize_conversion_value

MaximizeConversionValue

กลยุทธ์การเสนอราคาแบบเพิ่มมูลค่า Conversion สูงสุดแบบมาตรฐานที่จะตั้งราคาเสนอโดยอัตโนมัติเพื่อเพิ่มรายได้สูงสุดโดยอยู่ภายในงบประมาณที่กำหนดไว้
target_cpa

TargetCpa

กลยุทธ์การเสนอราคา CPA เป้าหมายมาตรฐานที่กำหนดราคาเสนอโดยอัตโนมัติเพื่อช่วยให้คุณได้รับ Conversion มากที่สุดเท่าที่จะเป็นไปได้ที่ราคาต่อหนึ่งการกระทำ (CPA) เป้าหมายที่คุณตั้งไว้
target_impression_share

TargetImpressionShare

กลยุทธ์การเสนอราคาส่วนแบ่งการแสดงผลเป้าหมาย กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้ได้เปอร์เซ็นต์การแสดงผลตามที่เลือก
target_roas

TargetRoas

กลยุทธ์การเสนอราคา ROAS เป้าหมายมาตรฐานที่จะช่วยเพิ่มรายได้สูงสุดโดยอัตโนมัติ พร้อมกับเฉลี่ยผลตอบแทนเป้าหมายจากค่าโฆษณา (ROAS) ที่เฉพาะเจาะจง
target_spend

TargetSpend

กลยุทธ์การเสนอราคาการใช้จ่ายเป้าหมายมาตรฐานที่จะตั้งราคาเสนอให้คุณโดยอัตโนมัติเพื่อช่วยให้ได้รับคลิกมากที่สุดเท่าที่จะเป็นไปได้ภายในงบประมาณของคุณ
percent_cpc

PercentCpc

กลยุทธ์การเสนอราคาเปอร์เซ็นต์ CPC มาตรฐานที่ราคาเสนอเป็นเศษส่วนของราคาที่โฆษณาสำหรับบางสินค้าหรือบริการ
target_cpm

TargetCpm

กลยุทธ์การเสนอราคาที่เพิ่มประสิทธิภาพต้นทุนต่อการแสดงผลพันครั้งโดยอัตโนมัติ

DynamicSearchAdsSetting

การตั้งค่าสําหรับควบคุมโฆษณา Search แบบไดนามิก (DSA)

ช่อง
domain_name

string

ต้องระบุ ชื่อโดเมนอินเทอร์เน็ตที่แสดงในการตั้งค่านี้ เช่น "google.com" หรือ "www.google.com"
language_code

string

ต้องระบุ รหัสภาษาที่ระบุภาษาของโดเมน เช่น "en"
use_supplied_urls_only

bool

แคมเปญใช้ URL ที่ผู้ลงโฆษณาให้มาโดยเฉพาะหรือไม่

GeoTargetTypeSetting

แสดงชุดการตั้งค่าที่เกี่ยวข้องกับการกำหนดเป้าหมายตามภูมิศาสตร์ของโฆษณา

ช่อง
positive_geo_target_type

PositiveGeoTargetType

การตั้งค่าที่ใช้สำหรับการกำหนดเป้าหมายตามภูมิศาสตร์เชิงบวกในแคมเปญนี้
negative_geo_target_type

NegativeGeoTargetType

การตั้งค่าที่ใช้สำหรับการกำหนดเป้าหมายตามภูมิศาสตร์เชิงลบในแคมเปญนี้

NetworkSettings

การตั้งค่าเครือข่ายสำหรับแคมเปญ

ช่อง
target_search_network

bool

โฆษณาจะแสดงในเว็บไซต์ของพาร์ทเนอร์ในเครือข่ายการค้นหาของ Google หรือไม่ (ต้องมี target_google_search เป็น true ด้วย)
target_content_network

bool

โฆษณาจะแสดงในตำแหน่งที่ระบุในเครือข่ายดิสเพลย์ของ Google หรือไม่ ตำแหน่งจะกำหนดโดยใช้เกณฑ์ตำแหน่ง
target_partner_search_network

bool

โฆษณาจะแสดงบนเครือข่ายพาร์ทเนอร์ของ Google หรือไม่ ใช้ได้เฉพาะกับบัญชีพาร์ทเนอร์ของ Google บางบัญชีเท่านั้น

OptimizationGoalSetting

การตั้งค่าเป้าหมายการเพิ่มประสิทธิภาพสำหรับแคมเปญนี้ ซึ่งมีชุดประเภทเป้าหมายการเพิ่มประสิทธิภาพ

ช่อง
optimization_goal_types[]

OptimizationGoalType

รายการประเภทเป้าหมายการเพิ่มประสิทธิภาพ

SelectiveOptimization

การตั้งค่าการเพิ่มประสิทธิภาพแบบเลือกส่วนสำหรับแคมเปญนี้ ซึ่งมีชุดการกระทําที่ถือเป็น Conversion ที่จะเพิ่มประสิทธิภาพแคมเปญนี้ ฟีเจอร์นี้ใช้ได้เฉพาะกับ App Campaign ที่ใช้ MULTI_CHANNEL เป็น AdvertisingChannelType และ APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT เป็น AdvertisingChannelSubType เท่านั้น

ช่อง
conversion_actions[]

string

ชุดการกระทําที่ถือเป็น Conversion ที่เลือกสําหรับการเพิ่มประสิทธิภาพแคมเปญนี้

ShoppingSetting

การตั้งค่าสำหรับแคมเปญ Shopping ระบุผลิตภัณฑ์มากมายที่แคมเปญสามารถโฆษณาได้ และวิธีที่แคมเปญนี้โต้ตอบกับแคมเปญ Shopping อื่นๆ

ช่อง
feed_label

string

ป้ายกำกับฟีดของผลิตภัณฑ์ที่จะรวมในแคมเปญ ตั้งค่า feed_label หรือ sales_country ได้เพียง 1 รายการเท่านั้น หากใช้แทน sales_country ช่อง feed_label จะยอมรับรหัสประเทศในรูปแบบเดียวกัน เช่น "XX" หรือจะเป็นสตริงใดก็ได้ที่ใช้สำหรับป้ายกำกับฟีดใน Google Merchant Center ก็ได้
use_vehicle_inventory

bool

จะกำหนดเป้าหมายพื้นที่โฆษณาข้อมูลยานพาหนะหรือไม่
merchant_id

int64

รหัสของบัญชี Merchant Center ต้องระบุข้อมูลในช่องนี้สำหรับการดำเนินการสร้าง ช่องนี้จะเปลี่ยนแปลงไม่ได้สำหรับแคมเปญ Shopping
sales_country

string

ประเทศที่ขายผลิตภัณฑ์ที่จะรวมไว้ในแคมเปญ
campaign_priority

int32

ลำดับความสำคัญของแคมเปญ แคมเปญที่มีลําดับความสําคัญสูงกว่าแบบตัวเลขจะมีลําดับความสําคัญสูงกว่าแคมเปญที่มีลําดับความสําคัญต่ำกว่า ช่องนี้เป็นช่องที่ต้องระบุสำหรับแคมเปญ Shopping โดยรวมค่าระหว่าง 0 ถึง 2 ช่องนี้ไม่บังคับสำหรับแคมเปญ Smart Shopping แต่ต้องเท่ากับ 3 หากตั้งค่าไว้
enable_local

bool

รวมผลิตภัณฑ์ในร้านหรือไม่

TrackingSetting

การตั้งค่าระดับแคมเปญสำหรับข้อมูลการติดตาม

ช่อง
tracking_url

string

URL ที่ใช้สำหรับการติดตามแบบไดนามิก

CampaignAsset

ลิงก์ระหว่างแคมเปญกับเนื้อหา

ช่อง
resource_name

string

ชื่อทรัพยากรของชิ้นงานแคมเปญ ชื่อทรัพยากร CampaignAsset มีรูปแบบดังนี้

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status

AssetLinkStatus

สถานะของชิ้นงานแคมเปญ
campaign

string

แคมเปญที่ลิงก์กับชิ้นงาน
asset

string

ชิ้นงานที่ลิงก์กับแคมเปญ

CampaignAssetSet

CampaignAssetSet คือการเชื่อมโยงระหว่างแคมเปญกับชุดชิ้นงาน การเพิ่ม CampaignAssetSet จะลิงก์ชุดชิ้นงานกับแคมเปญ

ช่อง
resource_name

string

ชื่อทรัพยากรของชุดชิ้นงานแคมเปญ ชื่อทรัพยากรชิ้นงานในชุดชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

แคมเปญที่ลิงก์กับชุดชิ้นงานนี้
asset_set

string

ชุดชิ้นงานที่ลิงก์กับแคมเปญ
status

AssetSetLinkStatus

สถานะของชิ้นงานชุดชิ้นงานแคมเปญ อ่านอย่างเดียว

CampaignAudienceView

มุมมองกลุ่มเป้าหมายของแคมเปญ รวมข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสำหรับโฆษณาในเครือข่ายดิสเพลย์และโฆษณาในเครือข่าย YouTube และรายการรีมาร์เก็ตติ้งสำหรับโฆษณา Search (RLSA) ซึ่งรวบรวมตามเกณฑ์ของแคมเปญและกลุ่มเป้าหมาย มุมมองนี้รวมเฉพาะกลุ่มเป้าหมายที่แนบมาที่ระดับแคมเปญ

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองกลุ่มเป้าหมายของแคมเปญ ชื่อแหล่งข้อมูลมุมมองกลุ่มเป้าหมายของแคมเปญมีรูปแบบดังนี้

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

งบประมาณแคมเปญ

ช่อง
resource_name

string

ชื่อทรัพยากรของงบประมาณแคมเปญ ชื่อทรัพยากรงบประมาณแคมเปญมีแบบฟอร์มดังนี้

customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method

BudgetDeliveryMethod

วิธีการแสดงโฆษณาซึ่งเป็นตัวกำหนดอัตราการใช้งบประมาณของแคมเปญ

ค่าเริ่มต้นจะเป็น STANDARD หากไม่ได้ระบุในการดำเนินการสร้าง
period

BudgetPeriod

ระยะเวลาที่จะใช้งบประมาณ ค่าเริ่มต้นจะเป็น DAILY หากไม่ได้ระบุไว้
amount_micros

int64

จํานวนงบประมาณในสกุลเงินท้องถิ่นของบัญชี จำนวนเงินจะระบุเป็นหน่วยไมโคร โดยที่ 1 ล้านเทียบเท่ากับ 1 หน่วยสกุลเงิน ค่าใช้จ่ายรายเดือนจำกัดไว้ที่ 30.4 เท่าของจำนวนเงินนี้

CampaignCriterion

เกณฑ์ของแคมเปญ

ช่อง
resource_name

string

ชื่อทรัพยากรของเกณฑ์ของแคมเปญ ชื่อทรัพยากรเกณฑ์ของแคมเปญมีรูปแบบดังนี้

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name

string

ชื่อที่แสดงของเกณฑ์

ระบบจะไม่สนใจช่องนี้สำหรับการเปลี่ยนแปลง
type

CriterionType

ประเภทของเกณฑ์
status

CampaignCriterionStatus

สถานะของเกณฑ์
last_modified_time

string

วันที่และเวลาที่แก้ไขเกณฑ์ของแคมเปญนี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
criterion_id

int64

รหัสของเกณฑ์

ระบบจะไม่สนใจช่องนี้ระหว่างการเปลี่ยนรูปแบบ
bid_modifier

float

ตัวแก้ไขสำหรับราคาเสนอเมื่อเกณฑ์ตรงกัน ตัวแก้ไขต้องอยู่ในช่วง: 0.1 - 10.0 ประเภทเกณฑ์ที่กำหนดเป้าหมายได้ส่วนใหญ่รองรับตัวปรับแต่ง ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์
negative

bool

จะกำหนดเป้าหมาย (false) หรือยกเว้น (true) เกณฑ์

ฟิลด์สหภาพ criterion เกณฑ์ของแคมเปญ

ต้องตั้งค่าหนึ่งรายการเท่านั้น criterion ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
keyword

KeywordInfo

คีย์เวิร์ด
location

LocationInfo

ตำแหน่ง
device

DeviceInfo

อุปกรณ์
age_range

AgeRangeInfo

ช่วงอายุ
gender

GenderInfo

เพศ
user_list

UserListInfo

รายการผู้ใช้
language

LanguageInfo

ภาษา
webpage

WebpageInfo

หน้าเว็บ
location_group

LocationGroupInfo

กลุ่มสถานที่ตั้ง

CampaignLabel

แสดงความสัมพันธ์ระหว่างแคมเปญและป้ายกำกับ

ช่อง
resource_name

string

ชื่อทรัพยากร ชื่อทรัพยากรป้ายกำกับแคมเปญอยู่ในรูป: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign

string

แคมเปญที่มีป้ายกำกับแนบ
label

string

ป้ายกำกับที่กำหนดให้กับแคมเปญ

CartDataSalesView

มุมมองยอดขายข้อมูลรถเข็นช็อปปิ้ง

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองการขายข้อมูลรถเข็นช็อปปิ้ง ชื่อทรัพยากรของมุมมองการขายข้อมูลรถเข็นช็อปปิ้งมีรูปแบบดังนี้ customers/{customer_id}/cartDataSalesView

Conversion

Conversion

ช่อง
resource_name

string

ชื่อทรัพยากรของ Conversion ชื่อทรัพยากร Conversion มีรูปแบบดังนี้

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id

int64

รหัสของ Conversion
criterion_id

int64

รหัสเกณฑ์ Search Ads 360 ส่วนค่า 0 หมายความว่าเกณฑ์ไม่มีการระบุแหล่งที่มา
merchant_id

int64

รหัสบัญชีพื้นที่โฆษณา SearchAds360 ที่มีผลิตภัณฑ์ที่มีการคลิก SearchAds360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีพื้นที่โฆษณาใน SearchAds360
ad_id

int64

รหัสโฆษณา ส่วนค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา
click_id

string

สตริงที่ไม่ซ้ำกันสำหรับการเข้าชมที่ระบุแหล่งที่มาของ Conversion ซึ่งจะส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL รหัสคลิก
visit_id

int64

รหัสการเข้าชม SearchAds360 ที่เป็นแหล่งที่มาของ Conversion
advertiser_conversion_id

string

สําหรับ Conversion ออฟไลน์ นี่คือรหัสที่ผู้ลงโฆษณาให้ไว้ หากผู้ลงโฆษณาไม่ได้ระบุรหัสดังกล่าว Search Ads 360 จะสร้างรหัสดังกล่าว สำหรับ Conversion ออนไลน์ ค่านี้จะเท่ากับคอลัมน์รหัสหรือคอลัมน์ Floodlight_order_id ทั้งนี้ขึ้นอยู่กับคำสั่ง Floodlight ของผู้ลงโฆษณา
product_id

string

รหัสของผลิตภัณฑ์ที่คลิก
product_channel

ProductChannel

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก ได้แก่ ออนไลน์หรือในพื้นที่
product_language_code

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์
product_store_id

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน
product_country_code

string

ประเทศ (รูปแบบ ISO-3166) ที่ลงทะเบียนไว้สำหรับฟีดสินค้าคงคลังที่มีผลิตภัณฑ์ที่คลิก
attribution_type

AttributionType

แหล่งที่มาของ Conversion: การเข้าชม หรือคีย์เวิร์ด+โฆษณา
conversion_date_time

string

การประทับเวลาของเหตุการณ์ Conversion
conversion_last_modified_date_time

string

การประทับเวลาของครั้งล่าสุดที่แก้ไข Conversion
conversion_visit_date_time

string

การประทับเวลาการเข้าชมซึ่งเป็นแหล่งที่มาของ Conversion
conversion_quantity

int64

จํานวนสินค้าที่บันทึกโดย Conversion ตามที่กำหนดโดยพารามิเตอร์ qty ของ URL ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน Conversion) หากไม่ใช่ จะมีค่าเริ่มต้นเป็น 1
conversion_revenue_micros

int64

รายได้ที่ปรับในระดับไมโครสําหรับเหตุการณ์ Conversion ซึ่งจะเป็นสกุลเงินของบัญชีที่ใช้แสดงโฆษณาเสมอ
floodlight_original_revenue

int64

รายได้เดิมที่ไม่มีการเปลี่ยนแปลงซึ่งเชื่อมโยงกับเหตุการณ์ Floodlight (ในสกุลเงินของรายงานปัจจุบัน) ก่อนการแก้ไขวิธีการสำหรับสกุลเงินของ Floodlight
floodlight_order_id

string

รหัสคำสั่งซื้อ Floodlight ที่ผู้ลงโฆษณาระบุไว้สำหรับ Conversion
status

ConversionStatus

สถานะของ Conversion ไม่ว่าจะเป็น "เปิดใช้" หรือ "นำออกแล้ว"
asset_id

int64

รหัสของเนื้อหาที่มีการโต้ตอบระหว่างเหตุการณ์ Conversion
asset_field_type

AssetFieldType

ประเภทช่องเนื้อหาของเหตุการณ์ Conversion

ConversionAction

การกระทำที่ถือเป็น Conversion

ช่อง
resource_name

string

ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ชื่อทรัพยากรการกระทำที่ถือเป็น Conversion มีรูปแบบดังนี้

customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time

string

การประทับเวลาที่กิจกรรม Floodlight สร้างขึ้น ซึ่งอยู่ในรูปแบบ ISO 8601
status

ConversionActionStatus

สถานะของการกระทําที่ถือเป็น Conversion นี้สําหรับการได้รับเหตุการณ์ Conversion
type

ConversionActionType

ประเภทของการกระทำที่ถือเป็น Conversion นี้
category

ConversionActionCategory

หมวดหมู่ของ Conversion ที่รายงานสําหรับการกระทําที่ถือเป็น Conversion นี้
value_settings

ValueSettings

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้
attribution_model_settings

AttributionModelSettings

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
floodlight_settings

FloodlightSettings

การตั้งค่า Floodlight สำหรับประเภท Conversion ของ Floodlight
id

int64

รหัสของการกระทำที่ถือเป็น Conversion
name

string

ชื่อของการกระทำที่ถือเป็น Conversion

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างการกระทำที่ถือเป็น Conversion รายการใหม่
primary_for_goal

bool

หากบิต primary_for_goal ของการกระทำที่ถือเป็น Conversion เป็นเท็จ การกระทำที่ถือเป็น Conversion จะเสนอราคาไม่ได้สำหรับทุกแคมเปญ โดยไม่คำนึงถึงเป้าหมาย Conversion ของลูกค้าหรือเป้าหมาย Conversion ของแคมเปญ อย่างไรก็ตาม เป้าหมาย Conversion ที่กําหนดเองจะไม่ดำเนินการตาม primary_for_goal ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กําหนดเองซึ่งกําหนดค่าการกระทําที่ถือเป็น Conversion หลัก = เท็จ การกระทําที่ถือเป็น Conversion ดังกล่าวจะยังคงเสนอราคาได้ โดยค่าเริ่มต้น primary_for_goal จะเป็น "จริง" หากไม่ได้ตั้งค่าไว้ ใน V9 การตั้งค่า primary_for_goal จะเป็น "เท็จ" ได้หลังจากที่สร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศว่าไม่บังคับ
owner_customer

string

ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของการกระทำที่ถือเป็น Conversion หรือค่า Null หากเป็นการกระทำที่ถือเป็น Conversion ที่ระบบกำหนด
include_in_client_account_conversions_metric

bool

ควรรวมการกระทำที่ถือเป็น Conversion นี้ไว้ในเมตริก "client_account_conversions" หรือไม่
include_in_conversions_metric

bool

ควรรวมการกระทำที่ถือเป็น Conversion นี้ไว้ในเมตริก "Conversion" หรือไม่
click_through_lookback_window_days

int64

จํานวนวันสูงสุดที่อาจผ่านไประหว่างการโต้ตอบ (เช่น การคลิก) กับเหตุการณ์ Conversion
app_id

string

รหัสแอปสำหรับการกระทำที่ถือเป็น Conversion ของแอป

AttributionModelSettings

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

ช่อง
attribution_model

AttributionModel

ประเภทรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
data_driven_model_status

DataDrivenModelStatus

สถานะของรูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูลสำหรับการกระทำที่ถือเป็น Conversion

FloodlightSettings

การตั้งค่าที่เกี่ยวข้องกับการกระทำที่ถือเป็น Conversion ของ Floodlight

ช่อง
activity_group_tag

string

สตริงที่ใช้เพื่อระบุกลุ่มกิจกรรม Floodlight เมื่อรายงาน Conversion
activity_tag

string

สตริงที่ใช้เพื่อระบุกิจกรรม Floodlight เมื่อรายงาน Conversion
activity_id

int64

รหัสกิจกรรม Floodlight ใน DoubleClick Campaign Manager (DCM)

ValueSettings

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้

ช่อง
default_value

double

ค่าที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้พร้อมด้วยค่าที่ไม่ถูกต้อง ไม่ได้รับอนุญาต หรือขาดหายไป หรือเมื่อการกระทําที่ถือเป็น Conversion นี้ได้รับการกําหนดค่าให้ใช้ค่าเริ่มต้นเสมอ
default_currency_code

string

รหัสสกุลเงินที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้พร้อมกับรหัสสกุลเงินที่ไม่ถูกต้องหรือขาดหายไป หรือเมื่อการกระทําที่ถือเป็น Conversion นี้ได้รับการกําหนดค่าให้ใช้ค่าเริ่มต้นเสมอ
always_use_default_value

bool

ควบคุมว่าจะใช้มูลค่าเริ่มต้นและรหัสสกุลเงินเริ่มต้นแทนค่าและรหัสสกุลเงินที่ระบุในเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้หรือไม่

ConversionCustomVariable

ตัวแปรที่กำหนดเองสำหรับ Conversion ดู "เกี่ยวกับเมตริกและมิติข้อมูล Floodlight ที่กำหนดเองใน Search Ads 360 เวอร์ชันใหม่" ที่ https://support.google.com/sa360/answer/13567857

ช่อง
resource_name

string

ชื่อทรัพยากรของตัวแปรที่กำหนดเองสำหรับ Conversion ชื่อทรัพยากรตัวแปรที่กำหนดเองของ Conversion มีรูปแบบดังนี้

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id

int64

รหัสของตัวแปรที่กำหนดเองสำหรับ Conversion
name

string

ต้องระบุ ชื่อของตัวแปรที่กำหนดเองของ Conversion ชื่อต้องไม่ซ้ำกัน ชื่อมีความยาวได้สูงสุด 100 อักขระ ไม่ควรมีช่องว่างใดๆ ข้างหน้าและข้างหลังอีก
tag

string

ต้องระบุ แท็กของตัวแปรที่กำหนดเองสำหรับ Conversion แท็กต้องไม่ซ้ำกันและประกอบด้วยอักขระ "u" ที่ตามด้วยตัวเลขที่น้อยกว่าหรือเท่ากับ 100 เช่น "u4"
status

ConversionCustomVariableStatus

สถานะของตัวแปรที่กําหนดเองของ Conversion สําหรับการได้รับเหตุการณ์ Conversion
owner_customer

string

ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของตัวแปรที่กำหนดเองของ Conversion
family

ConversionCustomVariableFamily

กลุ่มตัวแปรที่กำหนดเองสำหรับ Conversion
cardinality

ConversionCustomVariableCardinality

Cardinality ของตัวแปรที่กําหนดเอง Conversion
floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

ช่องสำหรับตัวแปรที่กำหนดเองสำหรับ Conversion ของ Floodlight ของ Search Ads 360
custom_column_ids[]

int64

รหัสของคอลัมน์ที่กําหนดเองซึ่งใช้ตัวแปรที่กําหนดเองสำหรับ Conversion นี้

FloodlightConversionCustomVariableInfo

ข้อมูลสำหรับตัวแปรที่กำหนดเองของ Conversion ของ Floodlight ของ Search Ads 360

ช่อง
floodlight_variable_type

FloodlightVariableType

ประเภทตัวแปร Floodlight ที่กำหนดไว้ใน Search Ads 360
floodlight_variable_data_type

FloodlightVariableDataType

ประเภทข้อมูลตัวแปร Floodlight ที่กำหนดไว้ใน Search Ads 360

ConversionTrackingSetting

ชุดการตั้งค่าสําหรับลูกค้าทั้งหมดที่เกี่ยวข้องกับเครื่องมือวัด Conversion ของ Search Ads 360

ช่อง
accepted_customer_data_terms

bool

ลูกค้ายอมรับข้อกําหนดสำหรับข้อมูลลูกค้าแล้วหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้จากผู้จัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/adspolicy/answer/7475709
conversion_tracking_status

ConversionTrackingStatus

สถานะเครื่องมือวัด Conversion ซึ่งจะระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ และใครเป็นเจ้าของเครื่องมือวัด Conversion ของลูกค้ารายนี้ หากลูกค้ารายนี้ใช้เครื่องมือวัด Conversion ข้ามบัญชี มูลค่าที่แสดงผลจะแตกต่างกันไปตาม login-customer-id ของคำขอ
enhanced_conversions_for_leads_enabled

bool

ดูว่าลูกค้าเลือกใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้จากผู้จัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว
google_ads_conversion_customer

string

ชื่อทรัพยากรของลูกค้าที่มีการสร้างและจัดการ Conversion ช่องนี้เป็นแบบอ่านอย่างเดียว
conversion_tracking_id

int64

รหัสเครื่องมือวัด Conversion ที่ใช้กับบัญชีนี้ รหัสนี้ไม่ได้ระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ (conversion_tracking_status) ช่องนี้เป็นแบบอ่านอย่างเดียว
google_ads_cross_account_conversion_tracking_id

int64

รหัสเครื่องมือวัด Conversion ของผู้จัดการของลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion และจะลบล้าง conversion_tracking_id ช่องนี้จะจัดการได้ผ่าน UI ของ Google Ads เท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว
cross_account_conversion_tracking_id

int64

รหัสเครื่องมือวัด Conversion ของผู้จัดการของลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชี และจะลบล้าง conversion_tracking_id

CustomColumn

คอลัมน์ที่กำหนดเอง ดูคอลัมน์ที่กำหนดเองของ Search Ads 360 ที่ https://support.google.com/sa360/answer/9633916

ช่อง
resource_name

string

ชื่อทรัพยากรของคอลัมน์ที่กำหนดเอง ชื่อทรัพยากรคอลัมน์ที่กำหนดเองมีรูปแบบดังนี้

customers/{customer_id}/customColumns/{custom_column_id}
id

int64

รหัสของคอลัมน์ที่กําหนดเอง
name

string

ชื่อคอลัมน์ที่กำหนดเองที่ผู้ใช้กำหนด
description

string

คำอธิบายคอลัมน์ที่กำหนดเองที่ผู้ใช้กำหนด
value_type

CustomColumnValueType

ประเภทของค่าผลลัพธ์ของคอลัมน์ที่กำหนดเอง
references_attributes

bool

เป็นจริงเมื่อคอลัมน์ที่กำหนดเองอ้างอิงถึงแอตทริบิวต์อย่างน้อย 1 รายการ
references_metrics

bool

เป็นจริงเมื่อคอลัมน์ที่กําหนดเองอ้างอิงถึงเมตริกอย่างน้อย 1 รายการ
queryable

bool

เป็นจริงเมื่อคอลัมน์ที่กำหนดเองพร้อมใช้งานในการค้นหา SearchAds360Service.Search และ SearchAds360Service.SearchStream
referenced_system_columns[]

string

รายการคอลัมน์ระบบที่อ้างอิงของคอลัมน์ที่กำหนดเองนี้ เช่น คอลัมน์ที่กำหนดเอง "ผลรวมของการแสดงผลและจำนวนคลิก" มีคอลัมน์ระบบอ้างอิงคอลัมน์ {"metric.clicks", "metrics.impressions"}

ลูกค้า

ลูกค้า

ช่อง
resource_name

string

ชื่อทรัพยากรของลูกค้า ชื่อทรัพยากรของลูกค้ามีรูปแบบดังนี้

customers/{customer_id}
conversion_tracking_setting

ConversionTrackingSetting

การตั้งค่าเครื่องมือวัด Conversion สำหรับลูกค้า
account_type

AccountType

ประเภทบัญชีเครื่องมือค้นหา เช่น Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track ฯลฯ
double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

การตั้งค่า DoubleClick Campaign Manager (DCM) สำหรับลูกค้าที่เป็นผู้จัดการ
account_status

AccountStatus

สถานะบัญชี เช่น เปิดใช้ หยุดชั่วคราว นําออก ฯลฯ
last_modified_time

string

วันที่และเวลาที่แก้ไขลูกค้ารายนี้ครั้งล่าสุด วันที่และเวลาจะอยู่ในเขตเวลาของลูกค้าและอยู่ในรูปแบบ "yyyy-MM-dd HH:mm:ss.ssssss"
engine_id

string

รหัสของบัญชีในบัญชีเครื่องมือค้นหาภายนอก
status

CustomerStatus

สถานะของลูกค้า
creation_time

string

การประทับเวลาเมื่อสร้างลูกค้ารายนี้ การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
id

int64

รหัสของลูกค้า
descriptive_name

string

ชื่อที่สื่อความหมายซึ่งไม่บังคับและซ้ำกันของลูกค้า
currency_code

string

สกุลเงินที่ใช้ในบัญชี รองรับรหัสสกุลเงินบางส่วนจากมาตรฐาน ISO 4217
time_zone

string

รหัสเขตเวลาท้องถิ่นของลูกค้า
tracking_url_template

string

เทมเพลต URL สำหรับการสร้าง URL ติดตามผลจากพารามิเตอร์
final_url_suffix

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ต่อท้าย URL สุดท้าย
auto_tagging_enabled

bool

เปิดใช้การติดแท็กอัตโนมัติสำหรับลูกค้าหรือไม่
manager

bool

ลูกค้าเป็นผู้จัดการหรือไม่

CustomerAsset

ลิงก์ระหว่างลูกค้ากับเนื้อหา

ช่อง
resource_name

string

ชื่อทรัพยากรของชิ้นงานของลูกค้า ชื่อทรัพยากร CustomerAsset มีรูปแบบดังนี้

customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset

string

ต้องระบุ ชิ้นงานที่ลิงก์กับลูกค้า
status

AssetLinkStatus

สถานะชิ้นงานของลูกค้า

CustomerAssetSet

CustomerAssetSet คือการลิงก์ระหว่างลูกค้ากับชุดชิ้นงาน การเพิ่ม CustomerAssetSet ลิงก์ชุดชิ้นงานกับลูกค้า

ช่อง
resource_name

string

ชื่อทรัพยากรของชุดชิ้นงานของลูกค้า ชื่อทรัพยากรชิ้นงานในชุดชิ้นงานมีรูปแบบดังนี้

customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set

string

ชุดชิ้นงานที่ลิงก์กับลูกค้า
customer

string

ลูกค้าที่ลิงก์กับชุดชิ้นงานนี้
status

AssetSetLinkStatus

สถานะของชิ้นงานชุดชิ้นงานของลูกค้า อ่านอย่างเดียว

CustomerClient

ลิงก์ระหว่างลูกค้ารายหนึ่งๆ กับลูกค้ารายหนึ่งๆ ลูกค้าแบบลูกค้ามีอยู่สำหรับลูกค้าระดับผู้จัดการเท่านั้น มีลูกค้าที่เป็นลูกค้าโดยตรงและโดยอ้อมทั้งหมด รวมถึงตัวผู้จัดการเองด้วย

ช่อง
resource_name

string

ชื่อทรัพยากรของไคลเอ็นต์ของลูกค้า ชื่อทรัพยากร CustomerClient จะมีแบบฟอร์ม: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]

string

ชื่อทรัพยากรของป้ายกำกับของลูกค้าที่ส่งคำขอซึ่งมีผลกับลูกค้าของไคลเอ็นต์ ชื่อทรัพยากรของป้ายกำกับมีรูปแบบดังนี้

customers/{customer_id}/labels/{label_id}
status

CustomerStatus

สถานะของลูกค้าของลูกค้า อ่านอย่างเดียว
client_customer

string

ชื่อทรัพยากรของลูกค้าของลูกค้าซึ่งลิงก์กับลูกค้าที่ระบุ อ่านอย่างเดียว
hidden

bool

ระบุว่าบัญชีนี้เป็นบัญชีที่ซ่อนหรือไม่

อ่านอย่างเดียว
level

int64

ระยะห่างระหว่างลูกค้าที่กำหนด สำหรับลิงก์เข้าเว็บเดิม ค่าระดับจะเป็น 0 อ่านอย่างเดียว
time_zone

string

การแสดงสตริง Common Locale Data Repository (CLDR) ของเขตเวลาของลูกค้า เช่น America/Los_Angeles อ่านอย่างเดียว
test_account

bool

ระบุว่าลูกค้าเป็นบัญชีทดสอบหรือไม่ อ่านอย่างเดียว
manager

bool

ระบุว่าลูกค้าเป็นผู้จัดการหรือไม่ อ่านอย่างเดียว
descriptive_name

string

ชื่อที่สื่อความหมายสำหรับไคลเอ็นต์ อ่านอย่างเดียว
currency_code

string

รหัสสกุลเงิน (เช่น "USD", "EUR") สำหรับลูกค้า อ่านอย่างเดียว
id

int64

รหัสลูกค้าของลูกค้า อ่านอย่างเดียว

DoubleClickCampaignManagerSetting

การตั้งค่า DoubleClick Campaign Manager (DCM) สำหรับลูกค้าที่เป็นผู้จัดการ

ช่อง
advertiser_id

int64

รหัสของผู้ลงโฆษณา Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
network_id

int64

รหัสของเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้
time_zone

string

เขตเวลาของเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้ในรูปแบบฐานข้อมูลเขตเวลาของ IANA เช่น อเมริกา/New_York

DynamicSearchAdsSearchTermView

มุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิก ชื่อทรัพยากรของมุมมองข้อความค้นหาของโฆษณา Search แบบไดนามิกมีรูปแบบดังนี้

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page

string

URL ของหน้า Landing Page ที่เลือกแบบไดนามิกของการแสดงผล

ช่องนี้เป็นแบบอ่านอย่างเดียว

GenderView

มุมมองเพศ ทรัพยากร gender_view จะแสดงสถานะการแสดงผลที่มีประสิทธิภาพ ไม่ใช่เกณฑ์ที่เพิ่ม โดยค่าเริ่มต้น กลุ่มโฆษณาที่ไม่มีเกณฑ์เพศจะแสดงต่อเพศทั้งหมด ดังนั้นเพศทั้งหมดจะปรากฏใน gender_view พร้อมกับสถิติ

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองเพศ ชื่อแหล่งข้อมูลของมุมมองเพศจะมีรูปแบบดังนี้

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

ค่าคงที่เป้าหมายทางภูมิศาสตร์

ช่อง
resource_name

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ ชื่อทรัพยากรคงที่ของเป้าหมายทางภูมิศาสตร์มีรูปแบบดังนี้

geoTargetConstants/{geo_target_constant_id}
status

GeoTargetConstantStatus

สถานะคงที่ของเป้าหมายทางภูมิศาสตร์
id

int64

รหัสของค่าคงที่เป้าหมายทางภูมิศาสตร์
name

string

ชื่อภาษาอังกฤษคงที่ที่กำหนดเป้าหมายตามภูมิศาสตร์
country_code

string

รหัสประเทศ ISO-3166-1 alpha-2 ที่เชื่อมโยงกับเป้าหมาย
target_type

string

ประเภทเป้าหมายคงที่เป้าหมายทางภูมิศาสตร์
canonical_name

string

ชื่อภาษาอังกฤษที่สมบูรณ์ในตัวเอง ซึ่งประกอบด้วยชื่อเป้าหมายและชื่อของประเทศระดับบนสุดและประเทศ
parent_geo_target

string

ชื่อทรัพยากรของค่าคงที่เป้าหมายทางภูมิศาสตร์ระดับบนสุด ชื่อทรัพยากรคงที่ของเป้าหมายทางภูมิศาสตร์มีรูปแบบดังนี้

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

มุมมองคีย์เวิร์ด

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองคีย์เวิร์ด ชื่อแหล่งข้อมูลของมุมมองคีย์เวิร์ดมีรูปแบบดังนี้

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

ค่ายเพลง

ป้ายกำกับ

ช่อง
resource_name

string

ชื่อทรัพยากร ชื่อทรัพยากรของป้ายกำกับอยู่ในรูปแบบ: customers/{customer_id}/labels/{label_id}
status

LabelStatus

สถานะของป้ายกำกับ อ่านอย่างเดียว
text_label

TextLabel

ป้ายกำกับประเภทหนึ่งที่แสดงข้อความบนพื้นหลังที่มีสี
id

int64

รหัสของป้ายกำกับ อ่านอย่างเดียว
name

string

ชื่อของป้ายกำกับ

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างป้ายกำกับใหม่

ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 80 เท่านั้น

LanguageConstant

ภาษา

ช่อง
resource_name

string

ชื่อทรัพยากรของค่าคงที่ของภาษา ชื่อทรัพยากรค่าคงที่ของภาษามีรูปแบบดังนี้

languageConstants/{criterion_id}
id

int64

รหัสของค่าคงที่ของภาษา
code

string

รหัสภาษา เช่น "en_US", "en_AU", "es", "fr" ฯลฯ
name

string

ชื่อเต็มของภาษาที่เป็นภาษาอังกฤษ เช่น "อังกฤษ (สหรัฐอเมริกา)" "สเปน" ฯลฯ
targetable

bool

ดูว่าภาษาสามารถกำหนดเป้าหมายได้หรือไม่

ListingGroupFilterDimension

มิติข้อมูลรายการสําหรับตัวกรองกลุ่มรายชื่อของกลุ่มชิ้นงาน

ช่อง
ฟิลด์สหภาพ dimension มิติข้อมูลของประเภทใดประเภทหนึ่งด้านล่างนี้จะแสดงอยู่เสมอ dimension ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
product_bidding_category

ProductBiddingCategory

หมวดหมู่การเสนอราคาของข้อเสนอผลิตภัณฑ์
product_brand

ProductBrand

แบรนด์ของข้อเสนอผลิตภัณฑ์
product_channel

ProductChannel

สถานที่ตั้งของข้อเสนอผลิตภัณฑ์
product_condition

ProductCondition

เงื่อนไขของข้อเสนอผลิตภัณฑ์
product_custom_attribute

ProductCustomAttribute

แอตทริบิวต์ที่กำหนดเองของข้อเสนอผลิตภัณฑ์
product_item_id

ProductItemId

รหัสสินค้าของข้อเสนอผลิตภัณฑ์
product_type

ProductType

ประเภทข้อเสนอผลิตภัณฑ์

ProductBiddingCategory

องค์ประกอบหนึ่งของหมวดหมู่การเสนอราคาที่ระดับหนึ่ง หมวดหมู่ระดับบนสุดอยู่ในระดับ 1 ย่อยในระดับที่ 2 เป็นต้น ขณะนี้เรารองรับสูงสุด 5 ระดับ ผู้ใช้ต้องระบุประเภทมิติข้อมูลที่ระบุระดับของหมวดหมู่ กรณีทั้งหมดของส่วนย่อยเดียวกันต้องมีประเภทมิติข้อมูล (ระดับหมวดหมู่) เหมือนกัน

ช่อง
level

ListingGroupFilterBiddingCategoryLevel

ระบุระดับของหมวดหมู่ในการจัดหมวดหมู่
id

int64

รหัสของหมวดหมู่การเสนอราคาผลิตภัณฑ์

รหัสนี้เทียบเท่ากับรหัส google_product_category ตามที่อธิบายไว้ในบทความนี้ https://support.google.com/merchants/answer/6324436

ProductBrand

แบรนด์ของผลิตภัณฑ์

ช่อง
value

string

ค่าสตริงของแบรนด์ผลิตภัณฑ์

ProductChannel

สถานที่ตั้งของข้อเสนอผลิตภัณฑ์

ช่อง
channel

ListingGroupFilterProductChannel

คุณค่าของย่าน

ProductCondition

เงื่อนไขของข้อเสนอผลิตภัณฑ์

ช่อง
condition

ListingGroupFilterProductCondition

ค่าของเงื่อนไข

ProductCustomAttribute

แอตทริบิวต์ที่กำหนดเองของข้อเสนอผลิตภัณฑ์

ช่อง
index

ListingGroupFilterCustomAttributeIndex

ระบุดัชนีของแอตทริบิวต์ที่กำหนดเอง
value

string

ค่าสตริงของแอตทริบิวต์ที่กำหนดเองของผลิตภัณฑ์

ProductItemId

รหัสสินค้าของข้อเสนอผลิตภัณฑ์

ช่อง
value

string

ค่าของรหัส

ProductType

ประเภทข้อเสนอผลิตภัณฑ์

ช่อง
level

ListingGroupFilterProductTypeLevel

ระดับของประเภท
value

string

ค่าของประเภท

ListingGroupFilterDimensionPath

การกําหนดเส้นทางของมิติข้อมูลที่กําหนดตัวกรองกลุ่มรายชื่อ

ช่อง
dimensions[]

ListingGroupFilterDimension

เส้นทางที่สมบูรณ์ของมิติข้อมูลผ่านลําดับชั้นของตัวกรองกลุ่มรายชื่อ (ไม่รวมโหนดรูท) ไปยังตัวกรองกลุ่มรายชื่อนี้

LocationView

มุมมองสถานที่ตั้งจะสรุปประสิทธิภาพของแคมเปญตามเกณฑ์สถานที่ตั้ง

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองสถานที่ตั้ง ชื่อทรัพยากรของมุมมองตำแหน่งมีรูปแบบดังนี้

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

หมวดหมู่การเสนอราคาผลิตภัณฑ์

ช่อง
resource_name

string

ชื่อทรัพยากรของหมวดหมู่การเสนอราคาผลิตภัณฑ์ ชื่อทรัพยากรหมวดหมู่การเสนอราคาผลิตภัณฑ์มีรูปแบบดังนี้

productBiddingCategoryConstants/{country_code}~{level}~{id}
level

ProductBiddingCategoryLevel

ระดับของหมวดหมู่การเสนอราคาผลิตภัณฑ์
status

ProductBiddingCategoryStatus

สถานะของหมวดหมู่การเสนอราคาผลิตภัณฑ์
id

int64

รหัสของหมวดหมู่การเสนอราคาผลิตภัณฑ์

รหัสนี้เทียบเท่ากับรหัส google_product_category ตามที่อธิบายไว้ในบทความนี้ https://support.google.com/merchants/answer/6324436
country_code

string

รหัสประเทศแบบ 2 ตัวอักษรของหมวดหมู่การเสนอราคาผลิตภัณฑ์
product_bidding_category_constant_parent

string

ชื่อทรัพยากรของหมวดหมู่การเสนอราคาผลิตภัณฑ์หลัก
language_code

string

รหัสภาษาของหมวดหมู่การเสนอราคาผลิตภัณฑ์
localized_name

string

แสดงค่าของหมวดหมู่การเสนอราคาผลิตภัณฑ์ที่แปลตาม language_code

ProductGroupView

มุมมองกลุ่มผลิตภัณฑ์

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองกลุ่มผลิตภัณฑ์ ชื่อแหล่งข้อมูลของมุมมองกลุ่มผลิตภัณฑ์มีแบบฟอร์มดังนี้

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

ฟิลด์หรือทรัพยากร (อาร์ติแฟกต์) ที่ใช้โดย SearchAds360Service

ช่อง
resource_name

string

ชื่อทรัพยากรของอาร์ติแฟกต์ ชื่อทรัพยากรอาร์ติแฟกต์มีรูปแบบดังนี้

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

หมวดหมู่ของอาร์ติแฟกต์
selectable_with[]

string

ชื่อของทรัพยากร กลุ่ม และเมตริกทั้งหมดที่เลือกได้พร้อมกับอาร์ติแฟกต์ที่อธิบาย
attribute_resources[]

string

ชื่อของทรัพยากรทั้งหมดที่เลือกได้ด้วยอาร์ติแฟกต์ที่อธิบายได้ ช่องจากแหล่งข้อมูลเหล่านี้จะไม่แบ่งกลุ่มเมตริกเมื่อรวมอยู่ในคำค้นหา

ช่องนี้จะมีการตั้งค่าเฉพาะสำหรับอาร์ติแฟกต์ที่มีหมวดหมู่เป็น RESOURCE เท่านั้น
metrics[]

string

ช่องนี้แสดงชื่อของเมตริกทั้งหมดที่เลือกได้พร้อมกับอาร์ติแฟกต์ที่อธิบายเมื่อใช้ในอนุประโยค FROM โดยจะตั้งค่าสำหรับอาร์ติแฟกต์ที่มีหมวดหมู่เป็น RESOURCE เท่านั้น
segments[]

string

ช่องนี้แสดงชื่อของอาร์ติแฟกต์ทั้งหมด ไม่ว่าจะเป็นกลุ่มหรือทรัพยากรอื่น เมตริกกลุ่มดังกล่าวเมื่อรวมอยู่ในคำค้นหา และเมื่อมีการใช้อาร์ติแฟกต์ที่อธิบายในอนุประโยค FROM โดยจะตั้งค่าสำหรับอาร์ติแฟกต์ที่มีหมวดหมู่เป็น RESOURCE เท่านั้น
enum_values[]

string

ค่าที่อาร์ติแฟกต์สามารถคาดเดาได้หากเป็นฟิลด์ประเภท ENUM

ฟิลด์นี้กำหนดขึ้นสำหรับอาร์ติแฟกต์ของหมวดหมู่ Segment หรือ ATTRIBUTE เท่านั้น
data_type

SearchAds360FieldDataType

ฟิลด์นี้จะกำหนดโอเปอเรเตอร์ที่สามารถใช้กับอาร์ติแฟกต์ในอนุประโยค WHERE
name

string

ชื่อของอาร์ติแฟกต์
selectable

bool

สามารถใช้อาร์ติแฟกต์ในอนุประโยค SELECT ในคำค้นหาหรือไม่
filterable

bool

อาร์ติแฟกต์นี้สามารถใช้ในคำสั่ง WHERE ในคำค้นหาได้หรือไม่
sortable

bool

สามารถใช้อาร์ติแฟกต์ในอนุประโยค ORDER BY ในคำค้นหาหรือไม่
type_url

string

URL ของ Proto ที่อธิบายประเภทข้อมูลของอาร์ติแฟกต์
is_repeated

bool

อาร์ติแฟกต์ฟิลด์ซ้ำกันหรือไม่

ShoppingPerformanceView

มุมมองประสิทธิภาพของ Shopping แสดงสถิติของแคมเปญ Shopping ที่รวบรวมในระดับมิติข้อมูลผลิตภัณฑ์หลายๆ ระดับ ค่ามิติข้อมูลผลิตภัณฑ์จาก Merchant Center เช่น แบรนด์ หมวดหมู่ แอตทริบิวต์ที่กำหนดเอง สภาพผลิตภัณฑ์และประเภทผลิตภัณฑ์ จะแสดงสถานะของมิติข้อมูลแต่ละรายการ ณ วันที่และเวลาที่บันทึกเหตุการณ์ที่เกี่ยวข้อง

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองประสิทธิภาพของ Shopping ชื่อแหล่งข้อมูลมุมมองประสิทธิภาพของ Shopping มีรูปแบบดังนี้ customers/{customer_id}/shoppingPerformanceView

UserList

รายชื่อผู้ใช้ นี่คือรายชื่อผู้ใช้ที่ลูกค้าอาจกำหนดเป้าหมาย

ช่อง
resource_name

string

ชื่อทรัพยากรของรายชื่อผู้ใช้ ชื่อทรัพยากรของรายชื่อผู้ใช้มีรูปแบบดังนี้

customers/{customer_id}/userLists/{user_list_id}
type

UserListType

ประเภทของรายการนี้

ช่องนี้เป็นแบบอ่านอย่างเดียว
id

int64

รหัสของรายชื่อผู้ใช้
name

string

ชื่อของรายชื่อผู้ใช้นี้ ชื่อรายชื่อผู้ใช้อาจซ้ำกันได้ (เช่น หาก access_reason=SHARED) ทั้งนี้ขึ้นอยู่กับเหตุผลการเข้าถึง

ไปที่

การเข้าชม

ช่อง
resource_name

string

ชื่อทรัพยากรของการเข้าชม ชื่อทรัพยากรการเยี่ยมชมมีแบบฟอร์มดังนี้

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id

int64

รหัสของการเข้าชม
criterion_id

int64

รหัสคีย์เวิร์ด Search Ads 360 ส่วนค่า 0 หมายความว่าคีย์เวิร์ดไม่มีการระบุแหล่งที่มา
merchant_id

int64

รหัสบัญชีพื้นที่โฆษณา Search Ads 360 ที่มีผลิตภัณฑ์ที่มีการคลิก Search Ads 360 จะสร้างรหัสนี้เมื่อคุณลิงก์บัญชีพื้นที่โฆษณาใน Search Ads 360
ad_id

int64

รหัสโฆษณา ส่วนค่า 0 หมายความว่าโฆษณาไม่มีการระบุแหล่งที่มา
click_id

string

สตริงที่ไม่ซ้ำกันสำหรับการเข้าชมแต่ละครั้งที่ส่งไปยังหน้า Landing Page เป็นพารามิเตอร์ของ URL รหัสคลิก
visit_date_time

string

การประทับเวลาของเหตุการณ์การเข้าชม การประทับเวลาจะอยู่ในเขตเวลาของลูกค้าและในรูปแบบ "yyyy-MM-dd HH:mm:ss"
product_id

string

รหัสของผลิตภัณฑ์ที่คลิก
product_channel

ProductChannel

ช่องทางการขายของผลิตภัณฑ์ที่มีการคลิก ได้แก่ ออนไลน์หรือในพื้นที่
product_language_code

string

ภาษา (ISO-639-1) ที่ตั้งค่าไว้สำหรับฟีด Merchant Center ที่มีข้อมูลเกี่ยวกับผลิตภัณฑ์
product_store_id

string

ร้านค้าในโฆษณาสินค้าคงคลังในร้านที่มีการคลิก ซึ่งควรตรงกับรหัสร้านค้าที่ใช้ในฟีดผลิตภัณฑ์ในร้าน
product_country_code

string

ประเทศ (รูปแบบ ISO-3166) ที่ลงทะเบียนสำหรับฟีดสินค้าคงคลังที่มีผลิตภัณฑ์ซึ่งคลิก
asset_id

int64

รหัสเนื้อหาที่มีการโต้ตอบระหว่างกิจกรรมการเข้าชม
asset_field_type

AssetFieldType

ประเภทช่องเนื้อหาของเหตุการณ์การเข้าชม

WebpageView

การดูหน้าเว็บ

ช่อง
resource_name

string

ชื่อทรัพยากรของการดูหน้าเว็บ ชื่อแหล่งข้อมูลของการดูหน้าเว็บมีแบบฟอร์มดังนี้

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}