Package google.ads.searchads360.v0.resources

ดัชนี

AccessibleBiddingStrategy

แสดงมุมมองของ BiddingStrategies ที่ลูกค้าเป็นเจ้าของและแชร์ด้วย

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

ช่อง
resource_name

string

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

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

int64

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

string

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

BiddingStrategyType

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

int64

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

string

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

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

ตั้งค่าได้เพียง 1 รายการ 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

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

ช่อง
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

เป้าหมายการใช้จ่ายที่จะเพิ่มจำนวนคลิกสูงสุด ผู้เสนอราคา TargetSpend จะพยายามใช้จ่ายค่าที่น้อยกว่าค่านี้หรือจำนวนการใช้จ่ายที่ถูกจำกัดตามปกติ หากไม่ได้ระบุ ระบบจะใช้งบประมาณเป็นเป้าหมายการใช้จ่าย ฟิลด์นี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ ดูรายละเอียดได้ที่ 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 สุดท้ายที่เป็นไปได้หลังจากเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสำหรับโฆษณา
final_app_urls[]

FinalAppUrl

รายการ URL สุดท้ายของแอปที่จะใช้ในอุปกรณ์เคลื่อนที่หากผู้ใช้ติดตั้งแอปที่เฉพาะเจาะจง
final_mobile_urls[]

string

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

AdType

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

int64

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

string

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

string

คำต่อท้ายที่จะใช้เมื่อสร้าง URL สุดท้าย
display_url

string

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

string

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

SearchAds360TextAdInfo

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

SearchAds360ExpandedTextAdInfo

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

SearchAds360ResponsiveSearchAdInfo

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

SearchAds360ProductAdInfo

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

SearchAds360ExpandedDynamicSearchAdInfo

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

กลุ่มโฆษณา :

กลุ่มโฆษณา

ช่อง
resource_name

string

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

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

AdGroupStatus

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

AdGroupType

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

AdGroupAdRotationMode

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

string

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

TargetingSetting

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

string

ชื่อทรัพยากรของป้ายกำกับที่แนบกับกลุ่มโฆษณานี้
effective_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)
tracking_url_template

string

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

int64

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

AdGroupEngineStatus

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

string

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

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

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

string

ชื่อทรัพยากรของป้ายกำกับที่มีผลซึ่งแนบมากับโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่รับช่วงมาหรือกำหนดให้กับโฆษณานี้โดยตรง
engine_id

string

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

AdGroupAdEngineStatus

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

string

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

AdGroupAdEffectiveLabel

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

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกำกับที่มีผลของโฆษณาในกลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับที่มีผลของโฆษณากลุ่มโฆษณามีรูปแบบดังนี้ customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupAdLabel

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

ช่อง
resource_name

string

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

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

AdGroupAsset

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

ช่อง
resource_name

string

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

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

string

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

string

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

AssetLinkStatus

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

AdGroupAssetSet

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

ช่อง
resource_name

string

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

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

string

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

string

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

AssetSetLinkStatus

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

AdGroupAudienceView

มุมมองกลุ่มเป้าหมายของกลุ่มโฆษณา รวมถึงข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสําหรับโฆษณาในเครือข่าย Display และเครือข่าย 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 ช่วงคือ 1.0 - 6.0 สำหรับ PreferredContent ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์

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

ต้องระบุในการดำเนินการสร้างตั้งแต่ V5 เป็นต้นไป 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 จะแสดงช่วงอายุแต่ละช่วงเป็น "เปิดใช้" เนื่องจากมีสิทธิ์เห็นโฆษณา แต่ AdGroupCriterion.status จะแสดงเป็น "นำออกแล้ว" เนื่องจากไม่มีการเพิ่มเกณฑ์เชิงบวก
quality_info

QualityInfo

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

CriterionType

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

string

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

string

ชื่อทรัพยากรของป้ายกำกับที่มีผลซึ่งแนบมากับเกณฑ์ของกลุ่มโฆษณานี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่สืบทอดมาหรือกำหนดให้กับเกณฑ์กลุ่มโฆษณานี้โดยตรง
position_estimates

PositionEstimates

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

string

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

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
url_custom_parameters[]

CustomParameter

รายการการแมปที่ใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองใน tracking_url_template, final_urls หรือ mobile_final_urls
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 ติดตาม

ฟิลด์ Union 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 มีข้อมูลไม่เพียงพอที่จะกำหนดค่า

AdGroupCriterionEffectiveLabel

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

ช่อง
resource_name

string

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

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupCriterionLabel

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

ช่อง
resource_name

string

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

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

AdGroupEffectiveLabel

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

ช่อง
resource_name

string

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

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

AdGroupLabel

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

ช่อง
resource_name

string

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

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

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 สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
final_mobile_urls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด
url_custom_parameters[]

CustomParameter

รายการการแมปที่จะใช้แทนที่แท็กพารามิเตอร์ที่กำหนดเองของ URL ใน tracking_url_template, final_urls และ/หรือ final_mobile_urls
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 ติดตาม
final_url_suffix

string

เทมเพลต URL สำหรับการต่อท้ายพารามิเตอร์กับ URL ของหน้า Landing Page ที่แสดงด้วยการติดตามพร้อมกัน
engine_status

AssetEngineStatus

สถานะเครื่องมือสำหรับชิ้นงาน
ฟิลด์ Union 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

ข้อความส่วนที่ 2 ที่อาจปรากฏต่อท้าย URL ที่แสดงในโฆษณา ตั้งค่าฟิลด์นี้ได้ก็ต่อเมื่อตั้งค่า path1 แล้วเท่านั้น
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

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

AudienceInfo

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

AssetGroupTopCombinationView

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

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองชุดค่าผสมที่มีประสิทธิภาพสูงสุดของกลุ่มชิ้นงาน ชื่อทรัพยากรของมุมมองชุดค่าผสมยอดนิยมของชิ้นงานกลุ่มโฆษณามีรูปแบบเป็น"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

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

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

int64

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

string

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

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

string

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

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

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

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

int64

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

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

int64

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

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

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

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

EnhancedCpc

กลยุทธ์การเสนอราคาที่เพิ่มราคาเสนอสำหรับการคลิกที่น่าจะนำไปสู่ Conversion และลดราคาเสนอสำหรับการคลิกที่ไม่น่าจะนำไปสู่ 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

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

string

ชื่อทรัพยากรของป้ายกำกับที่มีผลซึ่งแนบมากับแคมเปญนี้ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่สืบทอดมาหรือกำหนดให้กับแคมเปญนี้โดยตรง
labels[]

string

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

BiddingStrategyType

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

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

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

string

ชื่อทรัพยากรของ AccessibleBiddingStrategy ซึ่งเป็นมุมมองแบบอ่านอย่างเดียวของแอตทริบิวต์ที่ไม่จำกัดของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แนบมาซึ่งระบุโดย "bidding_strategy" ว่างเปล่า หากแคมเปญไม่ได้ใช้กลยุทธ์พอร์ตโฟลิโอ แอตทริบิวต์กลยุทธ์แบบไม่จำกัดพร้อมให้บริการแก่ลูกค้าทั้งหมดที่มีการแชร์กลยุทธ์ด้วย และอ่านได้จากทรัพยากร AccessibleBiddingStrategy ในทางตรงกันข้าม แอตทริบิวต์ที่จำกัดจะใช้ได้เฉพาะลูกค้าที่เป็นเจ้าของกลยุทธ์และผู้จัดการของลูกค้าเท่านั้น แอตทริบิวต์ที่ถูกจำกัดจะอ่านได้จากทรัพยากร 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 ให้ใช้ creation_time แทน
creation_time

string

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

string

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

AssetSetType

ประเภทฟีดที่แนบมากับแคมเปญนี้โดยตรง
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 เมื่อสร้าง ค่าเริ่มต้นจะเป็น 2037-12-30 ซึ่งหมายความว่าแคมเปญจะทํางานต่อไปเรื่อยๆ หากต้องการตั้งค่าแคมเปญที่มีอยู่ให้ทํางานต่อไปเรื่อยๆ ให้ตั้งค่าฟิลด์นี้เป็น 2037-12-30
final_url_suffix

string

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

bool

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

ฟิลด์ Union 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 Search หรือไม่ (ต้องtarget_google_searchเป็นtrueด้วย)
target_content_network

bool

ไม่ว่าจะแสดงโฆษณาในตําแหน่งที่ระบุในเครือข่าย Display ของ 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 ได้เพียงอย่างเดียว หากใช้แทน 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

มุมมองกลุ่มเป้าหมายของแคมเปญ รวมถึงข้อมูลประสิทธิภาพจากความสนใจและรายการรีมาร์เก็ตติ้งสําหรับโฆษณาในเครือข่าย Display และเครือข่าย 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) เกณฑ์

ฟิลด์ Union criterion เกณฑ์แคมเปญ

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

KeywordInfo

คีย์เวิร์ด
location

LocationInfo

ตำแหน่ง
device

DeviceInfo

อุปกรณ์
age_range

AgeRangeInfo

ช่วงอายุ
gender

GenderInfo

เพศ
user_list

UserListInfo

รายชื่อผู้ใช้
language

LanguageInfo

ภาษา
webpage

WebpageInfo

หน้าเว็บ
location_group

LocationGroupInfo

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

CampaignEffectiveLabel

แสดงความสัมพันธ์ระหว่างแคมเปญกับป้ายกำกับที่มีประสิทธิภาพ ป้ายกำกับที่มีประสิทธิภาพคือป้ายกำกับที่สืบทอดมาหรือกำหนดให้กับแคมเปญนี้โดยตรง

ช่อง
resource_name

string

ชื่อของทรัพยากร ชื่อทรัพยากร CampaignEffectivelabel มีรูปแบบดังนี้ customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

แคมเปญที่ติดป้ายกำกับที่มีประสิทธิภาพ
label

string

ป้ายกำกับที่มีผลซึ่งกำหนดให้กับแคมเปญ
owner_customer_id

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับที่มีผล

CampaignLabel

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

ช่อง
resource_name

string

ชื่อของทรัพยากร ชื่อทรัพยากรของป้ายกำกับแคมเปญมีรูปแบบดังนี้ customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign

string

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

string

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

int64

รหัสของลูกค้าที่เป็นเจ้าของป้ายกำกับ

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

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

int64

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

string

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

int64

รหัสการเข้าชม Search Ads 360 ที่ระบุแหล่งที่มาของ 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 ตามที่กําหนดโดยพารามิเตอร์ URL ของ qty ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน Conversion) มิฉะนั้นระบบจะตั้งค่าเริ่มต้นเป็น 1
conversion_revenue_micros

int64

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

int64

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

string

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

ConversionStatus

สถานะของ Conversion ซึ่งอาจเป็น ENABLED หรือ REMOVED
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 ที่มี primary_for_goal = false การกระทําที่ถือเป็น Conversion นั้นจะยังคงเสนอราคาได้ โดยค่าเริ่มต้น primary_for_goal จะเป็นจริงหากไม่ได้ตั้งค่าไว้ ใน V9 จะตั้งค่า primary_for_goal เป็น false ได้หลังจากสร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่ได้ประกาศเป็นตัวเลือก
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

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

CustomColumnRenderType

วิธีตีความค่าผลลัพธ์ของคอลัมน์ที่กำหนดเอง

ลูกค้า

ลูกค้า

ช่อง
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"
manager_id

int64

รหัสลูกค้าของผู้จัดการ ค่า 0 หมายความว่าลูกค้าไม่มีผู้จัดการ SA360
manager_descriptive_name

string

ชื่อที่สื่อความหมายของผู้จัดการ
sub_manager_id

int64

รหัสลูกค้าของบัญชีดูแลจัดการย่อย ค่า 0 หมายความว่าลูกค้าไม่มีบัญชีดูแลจัดการ SA360 ย่อย
sub_manager_descriptive_name

string

ชื่อที่สื่อความหมายของบัญชีดูแลจัดการย่อย
associate_manager_id

int64

รหัสลูกค้าของผู้จัดการที่เชื่อมโยง ค่า 0 หมายความว่าลูกค้าไม่มีบัญชีดูแลจัดการการเชื่อมโยง SA360
associate_manager_descriptive_name

string

ชื่อที่สื่อความหมายของผู้จัดการที่เชื่อมโยง
account_level

AccountLevelType

ระดับบัญชีของลูกค้า: บัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย บัญชีดูแลจัดการสำหรับพาร์ทเนอร์แบรนด์ บัญชีบริการ
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

ลิงก์ระหว่างลูกค้าที่ระบุกับลูกค้าของไคลเอ็นต์ 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 เช่น America/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/{owner_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

ชื่อเต็มของภาษาเป็นภาษาอังกฤษ เช่น "English (US)", "Spanish" ฯลฯ
targetable

bool

ไม่ว่าจะกำหนดเป้าหมายภาษาได้หรือไม่

ListingGroupFilterDimension

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

ช่อง
ฟิลด์ Union 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 Clause โดยจะตั้งค่าเฉพาะอาร์ติแฟกต์ที่มีหมวดหมู่เป็น RESOURCE
segments[]

string

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

string

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

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

SearchAds360FieldDataType

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

string

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

bool

ระบุว่าใช้ Artifact ในอนุประโยค SELECT ในคำค้นหาได้หรือไม่
filterable

bool

ใช้ Artifact ในคําสั่ง 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) ทั้งนี้ขึ้นอยู่กับ access_reason

UserLocationView

มุมมองตําแหน่งของผู้ใช้

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

ช่อง
resource_name

string

ชื่อทรัพยากรของมุมมองตําแหน่งของผู้ใช้ ชื่อทรัพยากรของมุมมอง UserLocation จะมีรูปแบบดังนี้

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id

int64

รหัสเกณฑ์สำหรับประเทศ
targeting_location

bool

ระบุว่ามีการกำหนดเป้าหมายสถานที่หรือไม่

ไปที่

การเข้าชม

ช่อง
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}