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

ประเภทโฆษณา

synthetic_content_info

SyntheticContentInfo

ข้อมูลเนื้อหาสังเคราะห์สำหรับโฆษณา เฉพาะโฆษณาที่มีประเภทโฆษณาที่เฉพาะเจาะจงเท่านั้นที่มีสิทธิ์รับการอัปเดตโดยใช้ฟิลด์ synthetic_content_info

ค่า AdType ที่อนุญาต: * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD

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

รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบข้อความที่ขยายออก โฆษณาแบบข้อความที่ขยายออกถูกเลิกใช้งานแล้ว โปรดใช้ SearchAds360ResponsiveSearchAd แทน

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 สูงสุด (ต้นทุนต่อคลิก) ฟิลด์นี้ใช้เมื่อกลยุทธ์การเสนอราคาที่มีประสิทธิภาพของกลุ่มโฆษณาคือการเสนอราคา 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 ใช้ 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

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

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

หมายเหตุ: แม้ว่าคุณจะแบ่งกลุ่มเมตริกตามช่วงอายุโดยใช้ age_range_view หรือตามเพศโดยใช้ gender_view ได้ แต่ Search Ads 360 API ไม่รองรับการแบ่งกลุ่มเมตริกตามทั้งช่วงอายุและเพศพร้อมกันในการค้นหาครั้งเดียว Search Ads 360 API ไม่รองรับการวิเคราะห์ประสิทธิภาพในมิติข้อมูลทั้ง 2 รายการรวมกัน

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

synthetic_content_info

SyntheticContentInfo

ข้อมูลเนื้อหาสังเคราะห์สำหรับชิ้นงาน เฉพาะชิ้นงานที่มีประเภทชิ้นงานที่เฉพาะเจาะจงเท่านั้นที่จะมีสิทธิ์รับการอัปเดตโดยใช้ฟิลด์ synthetic_content_info

ค่า AssetType ที่อนุญาต: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

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

โฆษณาจะแสดงในเครือข่ายพาร์ทเนอร์หรือไม่ โดยฟีเจอร์นี้มีให้บริการในบัญชีพาร์ทเนอร์บางบัญชีเท่านั้น หากไม่ได้รับคำสั่งให้ใช้ช่องนี้ ก็เป็นไปได้ว่าช่องนี้จะไม่มีผลกับบัญชีของคุณ การตั้งค่านี้ไม่ได้ควบคุมว่าจะแสดงโฆษณาในเครือข่ายพาร์ทเนอร์ Search ของ Google หรือไม่ ให้ใช้ target_search_network แทน

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

ป้ายกำกับฟีดของผลิตภัณฑ์ที่จะรวมไว้ในแคมเปญ ป้ายกำกับฟีดที่ถูกต้องมีอักขระได้สูงสุด 20 ตัว ซึ่งรวมถึงตัวอักษรพิมพ์ใหญ่ ตัวเลข ขีดกลาง และขีดล่าง หากก่อนหน้านี้คุณใช้ sales_country ที่เลิกใช้งานแล้วในรูปแบบรหัสประเทศ 2 ตัวอักษร (XX) คุณควรใช้ช่อง feed_label แทน ดูข้อมูลเพิ่มเติมได้ที่บทความสนับสนุนเกี่ยวกับป้ายกำกับฟีด

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

จํานวนเงินเฉลี่ยรายวันที่แคมเปญจะใช้จ่าย ฟิลด์นี้ใช้เมื่อตั้งค่า CampaignBudget period เป็น DAILY ซึ่งเป็นค่าเริ่มต้น

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

ฟิลด์นี้จะใช้ร่วมกับ "total_amount_micros" ไม่ได้ ควรตั้งค่า "amount_micros" หรือ "total_amount_micros" อย่างใดอย่างหนึ่งเท่านั้น

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

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

ให้ข้อมูลเกี่ยวกับผลิตภัณฑ์ที่ซื้อหากมีการติดตั้งใช้งาน Conversion จากข้อมูลรถเข็นช็อปปิ้ง เมตริกประสิทธิภาพ เช่น รายได้ กำไรขั้นต้น เมตริกโอกาสในการขาย/การขายครอสเซล ฯลฯ และแอตทริบิวต์ Merchant Center เช่น แบรนด์ หมวดหมู่ ฯลฯ จะพร้อมใช้งานสำหรับผลิตภัณฑ์ที่กำหนดไว้ในฟีดสินค้าคงคลังและขายได้จากโฆษณา Google สำหรับการซื้อที่มีการระบุแหล่งที่มาเป็นการคลิกโฆษณา Shopping คุณจะดูมิติข้อมูลของทั้งผลิตภัณฑ์ที่คลิกและผลิตภัณฑ์ที่ขายได้พร้อมกัน

ช่อง
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 ของจํานวน ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จำนวนสินค้าที่ขายใน 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, การติดตามเครื่องมือค้นหา ฯลฯ

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

แหล่งข้อมูลมุมมองเพศ แสดงมุมมองของเมตริกประสิทธิภาพของลูกค้าที่รวบรวมตามเพศ สถิติทั้งหมดจะรวบรวมที่ระดับกลุ่มโฆษณา

หมายเหตุ: แม้ว่าคุณจะแบ่งกลุ่มเมตริกตามช่วงอายุโดยใช้ age_range_view หรือตามเพศโดยใช้ gender_view ได้ แต่ Search Ads 360 API ไม่รองรับการแบ่งกลุ่มเมตริกตามทั้งช่วงอายุและเพศพร้อมกันในการค้นหาครั้งเดียว Search Ads 360 API ไม่รองรับการวิเคราะห์ประสิทธิภาพในมิติข้อมูลทั้ง 2 รายการรวมกัน

ช่อง
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 โดยจะตั้งค่าสำหรับอาร์ติแฟกต์ที่มีหมวดหมู่เป็น RESOURCE เท่านั้น

segments[]

string

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

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

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

name

string

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

selectable

bool

ใช้สิ่งประดิษฐ์ในอนุประโยค SELECT ในคำค้นหาได้หรือไม่

filterable

bool

ใช้ Artifact ในคําสั่ง WHERE ในคําค้นหาได้หรือไม่

sortable

bool

ใช้สิ่งประดิษฐ์ในอนุประโยค ORDER BY ในคำค้นหาได้หรือไม่

type_url

string

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

is_repeated

bool

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

ShoppingPerformanceView

มุมมองประสิทธิภาพของ Shopping

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

จำนวนการแสดงผลและคลิกที่ shopping_performance_view แสดงสถิติอาจแตกต่างจากรายงานแคมเปญ shopping_performance_view แสดงการแสดงผลและการคลิกผลิตภัณฑ์ที่ปรากฏในโฆษณา ขณะที่รายงานแคมเปญแสดงการแสดงผลและการคลิกโฆษณาเอง โฆษณาอาจแสดงผลิตภัณฑ์ตั้งแต่ 0 รายการจนถึงหลายรายการ ทั้งนี้ขึ้นอยู่กับรูปแบบ ดังนั้นตัวเลขจึงอาจไม่ตรงกัน

ใน UI ของ Search Ads 360 คุณสามารถค้นหาการแสดงผลและการคลิกของผลิตภัณฑ์ที่ปรากฏในโฆษณาได้โดยเลือกคอลัมน์จาก "แอตทริบิวต์ผลิตภัณฑ์" ในเครื่องมือแก้ไขรายงาน เช่น การเลือกคอลัมน์ "แบรนด์" จะเหมือนกับการเลือก segments.product_brand

ช่อง
resource_name

string

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

UserList

รายชื่อผู้ใช้ นี่คือรายชื่อผู้ใช้ที่ลูกค้าอาจกำหนดเป้าหมาย คีย์ที่ไม่ซ้ำของกลุ่มเป้าหมายตามรายการผู้ใช้ประกอบด้วยช่องต่อไปนี้ id โปรดทราบว่า name ต้องไม่ซ้ำกันสำหรับกลุ่มเป้าหมายตามข้อมูลผู้ใช้ที่เป็นของลูกค้าที่กำหนดด้วย ยกเว้นในบางกรณีที่ตั้งค่า access_reason เป็น SHARED การละเมิดข้อจำกัดชื่อที่ไม่ซ้ำกันจะทำให้เกิดข้อผิดพลาด: UserListError.INVALID_NAME

ช่อง
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

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

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

id

int64

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

name

string

ชื่อของกลุ่มเป้าหมายตามรายชื่อผู้ใช้นี้ ไม่ซ้ำกันต่อรายการผู้ใช้ ยกเว้นในบางกรณีที่รายการผู้ใช้ที่มีชื่อเดียวกันaccess_reasonตั้งค่าเป็นSHARED

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}