Package google.ads.searchads360.v0.resources

ดัชนี

AccessibleBiddingStrategy

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

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

ช่อง
resource_name

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

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

name

string

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

type

BiddingStrategyType

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

owner_customer_id

int64

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

owner_descriptive_name

string

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

ช่องการรวม scheme รูปแบบการเสนอราคา

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

maximize_conversion_value

MaximizeConversionValue

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

maximize_conversions

MaximizeConversions

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

MaximizeConversionValue

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

ช่อง
target_roas

double

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

MaximizeConversions

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

ช่อง
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

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

ช่อง
target_cpa_micros

int64

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

TargetImpressionShare

กลยุทธ์การเสนอราคาอัตโนมัติที่ตั้งราคาเสนอเพื่อให้โฆษณา 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

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

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

targeting_setting

TargetingSetting

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

labels[]

string

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

engine_id

string

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

start_date

string

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

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

end_date

string

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

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

language_code

string

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

last_modified_time

string

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

id

int64

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

name

string

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

ต้องระบุข้อมูลในฟิลด์นี้ และต้องไม่ว่างเปล่าเมื่อสร้างกลุ่มโฆษณาใหม่

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

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

cpc_bid_micros

int64

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

engine_status

AdGroupEngineStatus

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

AdGroupAd

โฆษณาระดับกลุ่มโฆษณา

ช่อง
resource_name

string

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

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

status

AdGroupAdStatus

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

ad

Ad

โฆษณา

creation_time

string

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

labels[]

string

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

engine_id

string

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

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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

AdGroupAdLabel

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

ช่อง
resource_name

string

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

ad_group_ad

string

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

label

string

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

AdGroupAsset

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

ช่อง
resource_name

string

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

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

ad_group

string

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

asset

string

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

status

AssetLinkStatus

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

AdGroupAssetSet

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

ช่อง
resource_name

string

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

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

ad_group

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

AdGroupAudienceView

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

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

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 เกณฑ์ของกลุ่มโฆษณา

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

keyword

KeywordInfo

คีย์เวิร์ด

listing_group

ListingGroupInfo

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

age_range

AgeRangeInfo

ช่วงอายุ

gender

GenderInfo

เพศ

user_list

UserListInfo

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

webpage

WebpageInfo

หน้าเว็บ

location

LocationInfo

ตำแหน่ง

PositionEstimates

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

ช่อง
top_of_page_cpc_micros

int64

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

QualityInfo

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

ช่อง
quality_score

int32

คะแนนคุณภาพ

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

AdGroupCriterionLabel

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

ช่อง
resource_name

string

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

ad_group_criterion

string

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

label

string

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

AdGroupLabel

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

ช่อง
resource_name

string

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

ad_group

string

กลุ่มโฆษณาที่ป้ายกำกับแนบอยู่

label

string

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

AgeRangeView

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

ช่อง
resource_name

string

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

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

ชิ้นงาน

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

ช่อง
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

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

final_urls[]

string

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

status

AssetStatus

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

creation_time

string

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

last_modified_time

string

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

id

int64

รหัสเนื้อหา

name

string

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

tracking_url_template

string

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

engine_status

AssetEngineStatus

สถานะเครื่องมือสำหรับเนื้อหา

ช่องการรวม asset_data ประเภทที่เฉพาะเจาะจงของเนื้อหา asset_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
youtube_video_asset

YoutubeVideoAsset

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

image_asset

ImageAsset

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

text_asset

TextAsset

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

callout_asset

UnifiedCalloutAsset

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

page_feed_asset

UnifiedPageFeedAsset

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

mobile_app_asset

MobileAppAsset

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

call_asset

UnifiedCallAsset

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

call_to_action_asset

CallToActionAsset

ชิ้นงานคำกระตุ้นให้ดำเนินการ (Call-To-Action)

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

final_mobile_urls[]

string

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

status

AssetGroupStatus

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

path1

string

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

path2

string

ส่วนที่สองของข้อความที่อาจปรากฏต่อท้าย 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

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

asset_group_top_combinations[]

AssetGroupAssetCombinationData

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

AssetSet

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

ช่อง
id

int64

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

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

ช่อง
resource_name

string

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

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

asset_set

string

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

asset

string

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

status

AssetSetAssetStatus

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

ผู้ชม

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

ช่อง
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

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

name

string

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

description

string

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

BiddingStrategy

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

ช่อง
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

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

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

type

BiddingStrategyType

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

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

currency_code

string

สกุลเงินที่ใช้โดยกลยุทธ์การเสนอราคา (รหัส 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

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

labels[]

string

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

bidding_strategy_type

BiddingStrategyType

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

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

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

accessible_bidding_strategy

string

ชื่อทรัพยากรของ AccessibleBidStrategy คือมุมมองแบบอ่านอย่างเดียวของแอตทริบิวต์ที่ไม่จำกัดของกลยุทธ์การเสนอราคาแบบพอร์ตโฟลิโอที่แนบมาซึ่งมีการระบุโดย "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 จะเลิกใช้งานในเวอร์ชัน 1 ใช้ create_time แทน

creation_time

string

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

last_modified_time

string

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

id

int64

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

name

string

ชื่อแคมเปญ

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

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

tracking_url_template

string

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

campaign_budget

string

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

start_date

string

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

end_date

string

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

final_url_suffix

string

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

url_expansion_opt_out

bool

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

ช่องการรวม campaign_bidding_strategy กลยุทธ์การเสนอราคาสําหรับแคมเปญ

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

bidding_strategy

string

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

manual_cpa

ManualCpa

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

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

MaximizeConversionValue

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

target_cpa

TargetCpa

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

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

TargetSpend

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

percent_cpc

PercentCpc

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

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

ช่อง
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

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

ช่อง
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

NetworkSettings

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

ช่อง
target_search_network

bool

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

target_content_network

bool

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

target_partner_search_network

bool

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

OptimizationGoalSetting

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

ช่อง
optimization_goal_types[]

OptimizationGoalType

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

SelectiveOptimization

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

ช่อง
conversion_actions[]

string

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

ShoppingSetting

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

ช่อง
feed_label

string

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

use_vehicle_inventory

bool

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

merchant_id

int64

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

sales_country

string

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

campaign_priority

int32

ลำดับความสำคัญของแคมเปญ แคมเปญที่มีลำดับความสำคัญสูงกว่ามีความสำคัญมากกว่าแคมเปญที่มีลำดับความสำคัญต่ำกว่า ต้องระบุข้อมูลในฟิลด์นี้สำหรับแคมเปญ Shopping ที่มีค่าระหว่าง 0 ถึง 2 ช่องนี้ไม่บังคับสำหรับแคมเปญ Smart Shopping แต่ต้องมีค่าเท่ากับ 3 หากตั้งค่าไว้

enable_local

bool

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

TrackingSetting

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

ช่อง
tracking_url

string

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

CampaignAsset

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

ช่อง
resource_name

string

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

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

status

AssetLinkStatus

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

campaign

string

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

asset

string

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

CampaignAssetSet

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

ช่อง
resource_name

string

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

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

campaign

string

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

asset_set

string

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

status

AssetSetLinkStatus

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

CampaignAudienceView

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

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

keyword

KeywordInfo

คีย์เวิร์ด

location

LocationInfo

ตำแหน่ง

device

DeviceInfo

อุปกรณ์

age_range

AgeRangeInfo

ช่วงอายุ

gender

GenderInfo

เพศ

user_list

UserListInfo

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

language

LanguageInfo

ภาษา

webpage

WebpageInfo

หน้าเว็บ

location_group

LocationGroupInfo

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

CampaignLabel

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

ช่อง
resource_name

string

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

campaign

string

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

label

string

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

CartDataSalesView

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

ช่อง
resource_name

string

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

Conversion

Conversion

ช่อง
resource_name

string

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

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

id

int64

รหัสของ Conversion

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_id

int64

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

advertiser_conversion_id

string

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

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

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

product_country_code

string

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

attribution_type

AttributionType

Conversion มีที่มาจากอะไร: การเข้าชม หรือคีย์เวิร์ด+โฆษณา

conversion_date_time

string

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

conversion_last_modified_date_time

string

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

conversion_visit_date_time

string

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

conversion_quantity

int64

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

conversion_revenue_micros

int64

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

floodlight_original_revenue

int64

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

floodlight_order_id

string

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

status

ConversionStatus

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

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 ที่กําหนดเองจะไม่ยึดตาม main_for_goal ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กําหนดเองซึ่งกําหนดค่าด้วยการกระทําที่ถือเป็น Conversion หลัก = เท็จ การกระทําที่ถือเป็น Conversion นั้นจะยังคงเสนอราคาได้ โดยค่าเริ่มต้น ค่าหลัก_for_goal จะเป็นค่าจริงหากไม่ได้ตั้งค่าไว้ ใน V9 จะตั้งรหัสหลัก_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 ของ 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"}

ลูกค้า

ลูกค้า

ช่อง
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

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

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

สถานะบัญชี เช่น เปิดใช้ หยุดชั่วคราว นำออกแล้ว เป็นต้น

last_modified_time

string

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

engine_id

string

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

status

CustomerStatus

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

creation_time

string

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

id

int64

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

descriptive_name

string

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

currency_code

string

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

time_zone

string

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

tracking_url_template

string

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

final_url_suffix

string

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

auto_tagging_enabled

bool

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

manager

bool

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

CustomerAsset

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

ช่อง
resource_name

string

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

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

asset

string

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

status

AssetLinkStatus

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

CustomerAssetSet

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

ช่อง
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

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

customer

string

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

status

AssetSetLinkStatus

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

CustomerClient

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

ช่อง
resource_name

string

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

applied_labels[]

string

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

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

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

client_customer

string

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

hidden

bool

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

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

level

int64

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

time_zone

string

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

test_account

bool

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

manager

bool

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

descriptive_name

string

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

currency_code

string

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

id

int64

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

DoubleClickCampaignManagerSetting

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

ช่อง
advertiser_id

int64

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

network_id

int64

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

time_zone

string

เขตเวลาของเครือข่าย Campaign Manager ที่เชื่อมโยงกับลูกค้ารายนี้ในรูปแบบฐานข้อมูลเขตเวลาของ IANA เช่น 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 [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 [google_product_category] ตามที่อธิบายไว้ในบทความนี้ https://support.google.com/merchants/answer/6324436

country_code

string

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

product_bidding_category_constant_parent

string

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

language_code

string

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

localized_name

string

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

ProductGroupView

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

ช่อง
resource_name

string

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

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

SearchAds360Field

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

ช่อง
resource_name

string

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

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

selectable_with[]

string

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

attribute_resources[]

string

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

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

metrics[]

string

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

segments[]

string

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

enum_values[]

string

ค่าที่อาร์ติแฟกต์สันนิษฐานได้นั้นหากเป็นช่องของประเภท ENUM

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

data_type

SearchAds360FieldDataType

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

name

string

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

selectable

bool

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

filterable

bool

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

sortable

bool

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

type_url

string

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

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

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

ไปที่

การเยี่ยมชม

ช่อง
resource_name

string

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

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

id

int64

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

criterion_id

int64

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

merchant_id

int64

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

ad_id

int64

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

click_id

string

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

visit_date_time

string

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

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

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

product_country_code

string

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

asset_id

int64

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

asset_field_type

AssetFieldType

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

WebpageView

มุมมองหน้าเว็บ

ช่อง
resource_name

string

ชื่อทรัพยากรของการดูหน้าเว็บ ชื่อทรัพยากรการดูหน้าเว็บจะอยู่ในรูปแบบดังนี้

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