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 ของลูกค้าที่เป็นเจ้าของกลยุทธ์การเสนอราคา

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

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

ช่อง
target_roas

double

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

MaximizeConversions

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

ช่อง
target_cpa

int64

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

target_cpa_micros

int64

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

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

type

AdType

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

id

int64

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

display_url

string

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

name

string

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

ฟิลด์สหภาพ 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)

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

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

AdGroupAd

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

ช่อง
resource_name

string

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

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

status

AdGroupAdStatus

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

ad

Ad

โฆษณา

creation_time

string

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

labels[]

string

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

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/{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/{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 ช่วงของ PreferredContent คือ 1.0 - 6.0 ใช้ 0 เพื่อเลือกไม่ใช้ประเภทอุปกรณ์

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

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

device

DeviceInfo

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

AdGroupCriterion

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

ช่อง
resource_name

string

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

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

creation_time

string

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

status

AdGroupCriterionStatus

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

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

quality_info

QualityInfo

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

type

CriterionType

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

labels[]

string

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

effective_labels[]

string

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

position_estimates

PositionEstimates

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

final_urls[]

string

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

engine_id

string

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

last_modified_time

string

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

criterion_id

int64

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

ad_group

string

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

negative

bool

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

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

bid_modifier

double

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

cpc_bid_micros

int64

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

effective_cpc_bid_micros

int64

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

engine_status

AdGroupCriterionEngineStatus

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

final_url_suffix

string

เทมเพลต URL สําหรับต่อท้ายพารามิเตอร์ไปยัง URL สุดท้าย

tracking_url_template

string

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

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

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

keyword

KeywordInfo

คีย์เวิร์ด

listing_group

ListingGroupInfo

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

age_range

AgeRangeInfo

ช่วงอายุ

gender

GenderInfo

เพศ

user_list

UserListInfo

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

webpage

WebpageInfo

หน้าเว็บ

location

LocationInfo

ตำแหน่ง

PositionEstimates

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

ช่อง
top_of_page_cpc_micros

int64

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

QualityInfo

ที่เก็บข้อมูลคุณภาพของเกณฑ์กลุ่มโฆษณา

ช่อง
quality_score

int32

คะแนนคุณภาพ

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

AdGroupCriterionEffectiveLabel

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

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกำกับที่มีประสิทธิภาพของเกณฑ์กลุ่มโฆษณา ชื่อทรัพยากรป้ายกำกับที่มีประสิทธิภาพของเกณฑ์กลุ่มโฆษณามีรูปแบบดังนี้ customers/{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/{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/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad_group

string

กลุ่มโฆษณาที่ติดป้ายกำกับที่มีประสิทธิภาพ

label

string

ป้ายกำกับที่มีประสิทธิภาพซึ่งกำหนดให้กับกลุ่มโฆษณา

owner_customer_id

int64

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

AdGroupLabel

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

ช่อง
resource_name

string

ชื่อทรัพยากรของป้ายกํากับกลุ่มโฆษณา ชื่อทรัพยากรป้ายกํากับกลุ่มโฆษณาอยู่ในรูปแบบ customers/{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 สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมด

status

AssetStatus

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

creation_time

string

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

last_modified_time

string

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

id

int64

รหัสเนื้อหา

name

string

ชื่อชิ้นงาน (ไม่บังคับ)

tracking_url_template

string

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

engine_status

AssetEngineStatus

สถานะเครื่องมือของชิ้นงาน

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

YoutubeVideoAsset

ชิ้นงานวิดีโอ YouTube

image_asset

ImageAsset

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

text_asset

TextAsset

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

callout_asset

UnifiedCalloutAsset

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

page_feed_asset

UnifiedPageFeedAsset

ชิ้นงานฟีดหน้าเว็บแบบรวม

mobile_app_asset

MobileAppAsset

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

call_asset

UnifiedCallAsset

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

call_to_action_asset

CallToActionAsset

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

location_asset

UnifiedLocationAsset

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

AssetGroup

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

ช่อง
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

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

campaign

string

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

name

string

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

final_urls[]

string

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

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

path1

string

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

path2

string

ข้อความส่วนที่ 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

กลุ่มชิ้นงานที่สัญญาณของกลุ่มชิ้นงานนี้อยู่

ฟิลด์สหภาพ 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

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

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

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

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

enhanced_cpc

EnhancedCpc

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_outrank_share

TargetOutrankShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

แคมเปญ

แคมเปญ

ช่อง
resource_name

string

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

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

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

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

serving_status

CampaignServingStatus

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

bidding_strategy_system_status

BiddingStrategySystemStatus

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

ad_serving_optimization_status

AdServingOptimizationStatus

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

advertising_channel_type

AdvertisingChannelType

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

ฟิลด์นี้ต้องกรอกข้อมูลและไม่ควรว่างเปล่าเมื่อสร้างแคมเปญใหม่

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

advertising_channel_sub_type

AdvertisingChannelSubType

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

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

url_custom_parameters[]

CustomParameter

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

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

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

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

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

geo_target_type_setting

GeoTargetTypeSetting

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

effective_labels[]

string

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

labels[]

string

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

bidding_strategy_type

BiddingStrategyType

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

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

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

accessible_bidding_strategy

string

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

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" และอยู่ตามเขตเวลาของลูกค้า

id

int64

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

name

string

ชื่อแคมเปญ

ฟิลด์นี้ต้องกรอกข้อมูลและไม่ควรว่างเปล่าเมื่อสร้างแคมเปญใหม่

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

tracking_url_template

string

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

campaign_budget

string

ชื่อทรัพยากรของงบประมาณแคมเปญ

start_date

string

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

end_date

string

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

final_url_suffix

string

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

url_expansion_opt_out

bool

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

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

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

bidding_strategy

string

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

manual_cpa

ManualCpa

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

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

percent_cpc

PercentCpc

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

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

ช่อง
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

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

ช่อง
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

NetworkSettings

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

ช่อง
target_search_network

bool

โฆษณาจะแสดงในเว็บไซต์พาร์ทเนอร์ในเครือข่าย Google 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) เกณฑ์

ฟิลด์สหภาพ 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/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

แคมเปญที่แนบป้ายกํากับที่มีประสิทธิภาพอยู่

label

string

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

owner_customer_id

int64

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

CampaignLabel

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

ช่อง
resource_name

string

ชื่อแหล่งข้อมูล ชื่อทรัพยากรป้ายกํากับแคมเปญอยู่ในรูปแบบ customers/{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 ซึ่งพิจารณาจากพารามิเตอร์ qty url ผู้ลงโฆษณามีหน้าที่ป้อนข้อมูลพารามิเตอร์แบบไดนามิก (เช่น จํานวนสินค้าที่ขายใน Conversion) มิฉะนั้นค่าเริ่มต้นจะเป็น 1

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

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

floodlight_order_id

string

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

status

ConversionStatus

สถานะของ Conversion ซึ่งก็คือ "เปิดใช้" หรือ "นําออก"

asset_id

int64

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

asset_field_type

AssetFieldType

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

ConversionAction

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

ช่อง
resource_name

string

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

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

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

type

ConversionActionType

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

category

ConversionActionCategory

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

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

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

id

int64

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

name

string

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

ช่องนี้ต้องกรอกข้อมูลและไม่ควรเว้นว่างไว้เมื่อสร้างการกระทําที่ถือเป็น Conversion ใหม่

primary_for_goal

bool

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

owner_customer

string

ชื่อทรัพยากรของลูกค้าเจ้าของการกระทำที่ถือเป็น Conversion หรือเป็นค่าว่างหากเป็นการกระทำที่ถือเป็น 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

การนําเสนอสตริงของที่เก็บข้อมูลภาษาที่พบบ่อย (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/{customer_id}/labels/{label_id}

status

LabelStatus

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

text_label

TextLabel

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

id

int64

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

name

string

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

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

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

LanguageConstant

ภาษา

ช่อง
resource_name

string

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

languageConstants/{criterion_id}

id

int64

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

code

string

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

name

string

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

targetable

bool

ภาษาที่กำหนดเป้าหมายได้หรือไม่

ListingGroupFilterDimension

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

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

ProductBiddingCategory

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

product_brand

ProductBrand

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

product_channel

ProductChannel

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

product_condition

ProductCondition

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

product_custom_attribute

ProductCustomAttribute

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

product_item_id

ProductItemId

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

product_type

ProductType

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

ProductBiddingCategory

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

ช่อง
level

ListingGroupFilterBiddingCategoryLevel

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

id

int64

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

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

ProductBrand

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

ช่อง
value

string

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

ProductChannel

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

ช่อง
channel

ListingGroupFilterProductChannel

ค่าของย่าน

ProductCondition

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

ช่อง
condition

ListingGroupFilterProductCondition

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

ProductCustomAttribute

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

ช่อง
index

ListingGroupFilterCustomAttributeIndex

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

value

string

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

ProductItemId

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

ช่อง
value

string

ค่าของรหัส

ProductType

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

ช่อง
level

ListingGroupFilterProductTypeLevel

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

value

string

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

ListingGroupFilterDimensionPath

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

ช่อง
dimensions[]

ListingGroupFilterDimension

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

LocationView

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

ช่อง
resource_name

string

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

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

ProductBiddingCategoryConstant

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

ช่อง
resource_name

string

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

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

level

ProductBiddingCategoryLevel

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

status

ProductBiddingCategoryStatus

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

id

int64

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

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

country_code

string

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

product_bidding_category_constant_parent

string

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

language_code

string

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

localized_name

string

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

ProductGroupView

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

ช่อง
resource_name

string

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

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

SearchAds360Field

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

ช่อง
resource_name

string

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

หมวดหมู่ของรายการ

selectable_with[]

string

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

attribute_resources[]

string

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

ช่องนี้ตั้งค่าไว้สำหรับอาร์ติแฟกต์ที่มีหมวดหมู่เป็นทรัพยากรเท่านั้น

metrics[]

string

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

segments[]

string

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

enum_values[]

string

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

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

data_type

SearchAds360FieldDataType

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

name

string

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

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

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

is_repeated

bool

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

ShoppingPerformanceView

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

ช่อง
resource_name

string

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

UserList

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

ช่อง
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

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

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

id

int64

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

name

string

ชื่อของรายการผู้ใช้นี้ ชื่อรายการผู้ใช้อาจไม่ซ้ำกันโดยขึ้นอยู่กับ access_reason (เช่น หาก 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}