- แหล่งข้อมูล: โปรโมชัน
- RedemptionChannel
- แอตทริบิวต์
- ProductApplicability
- OfferType
- CouponValueType
- DestinationEnum
- StoreApplicability
- PromotionStatus
- DestinationStatus
- สถานะ
- ItemLevelIssue
- ระดับความรุนแรง
- เมธอด
แหล่งข้อมูล: โปรโมชัน
แสดงถึงโปรโมชัน โปรดดูรายละเอียดเพิ่มเติมในบทความต่อไปนี้
แอตทริบิวต์อินพุตโปรโมชันที่ต้องระบุเพื่อให้ผ่านการตรวจสอบความถูกต้องของข้อมูลมีดังนี้
หลังจากแทรกและอัปเดตข้อมูลโปรโมชันแล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลโปรโมชันสุดท้ายได้
การแสดง JSON |
---|
{ "name": string, "promotionId": string, "contentLanguage": string, "targetCountry": string, "redemptionChannel": [ enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของโปรโมชัน รูปแบบ: |
promotion |
ต้องระบุ รหัสโปรโมชันที่ผู้ใช้ระบุเพื่อระบุโปรโมชันนั้นๆ โดยไม่ซ้ำกัน ปฏิบัติตามข้อกำหนดขั้นต่ำเพื่อป้องกันการไม่อนุมัติโปรโมชัน |
content |
ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรของโปรโมชัน โปรโมชันใช้ได้กับภาษาที่เลือกเท่านั้น |
target |
ต้องระบุ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR โปรโมชันใช้ได้เฉพาะในบางประเทศ ข้อมูลที่แสดงฟรีและโฆษณา Shopping โฆษณาสินค้าคงคลังในร้าน |
redemption |
ต้องระบุ ช่องทางการแลกรับสิทธิ์สำหรับโปรโมชัน ต้องมีแชแนลอย่างน้อย 1 รายการ |
data |
เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของโปรโมชัน |
attributes |
ไม่บังคับ รายการแอตทริบิวต์โปรโมชัน |
custom |
ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น |
promotion |
เอาต์พุตเท่านั้น สถานะของการโปรโมต ปัญหาการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับการโปรโมตที่ประมวลผลแบบไม่พร้อมกัน |
version |
ไม่บังคับ แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของโปรโมชัน ซึ่งสามารถใช้เพื่อรักษาลำดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันไม่ให้แทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของโปรโมชันที่มีอยู่ คุณสามารถแทรก หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก |
RedemptionChannel
ช่องทางของโปรโมชัน
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
บ่งบอกว่าไม่ได้ระบุช่อง |
IN_STORE |
บ่งบอกว่าช่องมีให้บริการใน Store ซึ่งเหมือนกับช่อง local ที่ใช้สำหรับ products |
ONLINE |
บ่งบอกว่าช่องออนไลน์อยู่ |
Attributes
แอตทริบิวต์
การแสดง JSON |
---|
{ "productApplicability": enum ( |
ช่อง | |
---|---|
product |
ต้องระบุ การใช้โปรโมชันกับผลิตภัณฑ์ทั้งหมดหรือเฉพาะผลิตภัณฑ์ที่เฉพาะเจาะจง |
offer |
ต้องระบุ ประเภทโปรโมชัน ใช้แอตทริบิวต์นี้เพื่อระบุว่าลูกค้าต้องใช้รหัสคูปองเพื่อแลกรับโปรโมชันหรือไม่ |
generic |
ไม่บังคับ รหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชัน เพื่อใช้กับช่อง |
long |
ต้องระบุ ชื่อแบบยาวของโปรโมชัน |
coupon |
ต้องระบุ แอตทริบิวต์ประเภทมูลค่าของคูปองเพื่อระบุประเภทโปรโมชันที่คุณใช้อยู่ ต้องระบุแอตทริบิวต์บางรายการ ทั้งนี้ขึ้นอยู่กับประเภทของมูลค่าคูปองที่เลือก |
promotion |
ต้องระบุ รายการปลายทางที่มีสิทธิ์ใช้โปรโมชัน หากไม่ได้ระบุปลายทางด้วยการใส่ค่าที่รองรับในแหล่งข้อมูล โปรโมชันจะแสดงในโฆษณา Shopping และข้อมูลที่แสดงฟรีโดยค่าเริ่มต้น ก่อนหน้านี้คุณอาจส่งค่า Shopping Actions, แพลตฟอร์มของ Google, แพลตฟอร์มในพื้นที่ของ Google เป็นปลายทางสำหรับผลิตภัณฑ์ หากต้องการแทนค่าเหล่านี้ ให้ใช้ |
item |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
brand |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
item |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน [productApplicability] เป็น specific_products |
product |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
item |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นรหัสสินค้าสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
brand |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นแบรนด์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
item |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้า แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ |
product |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นประเภทผลิตภัณฑ์สำหรับโปรโมชัน แอตทริบิวต์ตัวกรองผลิตภัณฑ์จะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ความเกี่ยวข้องของผลิตภัณฑ์ที่มีสิทธิ์สำหรับโปรโมชัน |
minimum |
ไม่บังคับ ยอดสั่งซื้อขั้นต่ำสำหรับโปรโมชัน |
minimum |
ไม่บังคับ จำนวนการซื้อขั้นต่ำสำหรับโปรโมชัน |
limit |
ไม่บังคับ จำนวนการซื้อสูงสุดสำหรับโปรโมชัน |
limit |
ไม่บังคับ ราคาผลิตภัณฑ์สูงสุดสำหรับโปรโมชัน |
percent |
ไม่บังคับ เปอร์เซ็นต์ส่วนลดที่มีให้ในโปรโมชัน |
money |
ไม่บังคับ จำนวนเงินส่วนลดที่เสนอในโปรโมชัน |
get |
ไม่บังคับ จํานวนสินค้าที่ลดราคาในโปรโมชัน ระบบจะตั้งค่าแอตทริบิวต์เมื่อ |
free |
ไม่บังคับ มูลค่าของขวัญฟรีสำหรับโปรโมชัน |
free |
ไม่บังคับ รายละเอียดของขวัญฟรีสำหรับโปรโมชัน |
free |
ไม่บังคับ รหัสสินค้าของขวัญฟรีสำหรับโปรโมชัน |
promotion |
ต้องระบุ |
promotion |
ไม่บังคับ |
store |
ไม่บังคับ ใช้โปรโมชันกับร้านค้าทั้งหมดหรือเฉพาะร้านค้าที่ระบุ โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มีการนำไปใช้กับร้านค้า ระบบจะแสดงข้อผิดพลาด |
store |
ไม่บังคับ รหัสร้านค้าที่จะรวมในโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของร้านค้าจริงที่ขายผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน |
store |
ไม่บังคับ รหัสร้านค้าที่จะยกเว้นสำหรับโปรโมชัน แอตทริบิวต์ตัวกรองร้านค้าจะใช้ได้ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ |
promotion |
ไม่บังคับ URL ไปยังหน้าในเว็บไซต์ของผู้ขายที่แสดงโปรโมชัน โปรโมชันโฆษณาสินค้าคงคลังในร้านจะแสดงข้อผิดพลาดหากไม่มี |
ProductApplicability
ผลิตภัณฑ์หรือรายการผลิตภัณฑ์ที่ใช้โปรโมชันนั้น
Enum | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
ไม่ทราบผลิตภัณฑ์ที่จะใช้โปรโมชันนี้ |
ALL_PRODUCTS |
ใช้กับผลิตภัณฑ์ทั้งหมดได้ |
SPECIFIC_PRODUCTS |
ใช้กับผลิตภัณฑ์หรือรายการผลิตภัณฑ์รายการเดียวเท่านั้น |
OfferType
ประเภทข้อเสนอของโปรโมชัน
Enum | |
---|---|
OFFER_TYPE_UNSPECIFIED |
ประเภทข้อเสนอที่ไม่รู้จัก |
NO_CODE |
ประเภทข้อเสนอที่ไม่มีรหัส |
GENERIC_CODE |
ประเภทข้อเสนอโดยใช้รหัส คุณต้องระบุรหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชันเมื่อ offerType = GENERIC_CODE |
CouponValueType
ประเภทมูลค่าของคูปองของโปรโมชัน
Enum | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
ระบุว่าไม่ได้ระบุประเภทมูลค่าของคูปอง |
MONEY_OFF |
ประเภทมูลค่าคูปองเป็นเงิน |
PERCENT_OFF |
ประเภทมูลค่าคูปองส่วนลด |
BUY_M_GET_N_MONEY_OFF |
ซื้อจำนวน M แล้วรับส่วนลดเป็นเงิน N ประเภทมูลค่าคูปอง ต้องระบุ minimumPurchaseQuantity และ getThisQuantityDiscounted ต้องมี moneyOffAmount ด้วย |
BUY_M_GET_N_PERCENT_OFF |
ซื้อ M รายการ รับส่วนลด N เปอร์เซ็นต์สำหรับประเภทมูลค่าของคูปอง ต้องมี minimumPurchaseQuantity และ getThisQuantityDiscounted ต้องมี percent_off_percentage ด้วย |
BUY_M_GET_MONEY_OFF |
ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimumPurchaseQuantity และ moneyOffAmount |
BUY_M_GET_PERCENT_OFF |
ซื้อ M รายการและรับส่วนลดเป็นเงิน โดยต้องมี minimumPurchaseQuantity และ percent_off_percentage |
FREE_GIFT |
ของขวัญฟรีพร้อมคำอธิบายเท่านั้น |
FREE_GIFT_WITH_VALUE |
ของขวัญฟรีที่มีมูลค่าทางการเงิน |
FREE_GIFT_WITH_ITEM_ID |
ของขวัญฟรีที่มีรหัสสินค้า |
FREE_SHIPPING_STANDARD |
ประเภทมูลค่าของคูปองจัดส่งฟรีแบบมาตรฐาน |
FREE_SHIPPING_OVERNIGHT |
ประเภทมูลค่าของคูปองจัดส่งฟรีข้ามคืน |
FREE_SHIPPING_TWO_DAY |
ประเภทมูลค่าของคูปองจัดส่งฟรีใน 2 วัน |
DestinationEnum
ค่าปลายทาง
Enum | |
---|---|
DESTINATION_ENUM_UNSPECIFIED |
ไม่ได้ระบุ |
SHOPPING_ADS |
โฆษณา Shopping |
DISPLAY_ADS |
โฆษณา Display |
LOCAL_INVENTORY_ADS |
โฆษณาคลังผลิตภัณฑ์ในพื้นที่ |
FREE_LISTINGS |
ข้อมูลที่แสดงฟรี |
FREE_LOCAL_LISTINGS |
ข้อมูลผลิตภัณฑ์ในร้านที่แสดงฟรี |
YOUTUBE_SHOPPING |
YouTube Shopping |
YOUTUBE_SHOPPING_CHECKOUT |
จุดชำระเงินใน YouTube Shopping |
YOUTUBE_AFFILIATE |
แอฟฟิลิเอตของ YouTube |
FREE_VEHICLE_LISTINGS |
ข้อมูลยานพาหนะที่แสดงฟรี |
VEHICLE_ADS |
โฆษณายานพาหนะ |
CLOUD_RETAIL |
Cloud Retail |
LOCAL_CLOUD_RETAIL |
Cloud Retail ในท้องถิ่น |
StoreApplicability
รหัสร้านค้าหรือรายการรหัสร้านค้าที่โปรโมชันมีผล สำหรับโปรโมชันโฆษณาสินค้าคงคลังในร้านเท่านั้น
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
ไม่ทราบรหัสร้านค้าที่ใช้โปรโมชันได้ |
ALL_STORES |
ใช้โปรโมชันกับทุกร้านค้า |
SPECIFIC_STORES |
โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น |
PromotionStatus
สถานะของโปรโมชัน
การแสดง JSON |
---|
{ "destinationStatuses": [ { object ( |
ช่อง | |
---|---|
destination |
เอาต์พุตเท่านั้น ปลายทางที่ต้องการสำหรับโปรโมชัน |
item |
เอาต์พุตเท่านั้น รายการปัญหาที่เกี่ยวข้องกับโปรโมชัน |
creation |
เอาต์พุตเท่านั้น วันที่สร้างโปรโมชันในรูปแบบ ISO 8601: วันที่ เวลา และออฟเซ็ต เช่น |
last |
เอาต์พุตเท่านั้น วันที่อัปเดตสถานะโปรโมชันครั้งล่าสุดในรูปแบบ ISO 8601: วันที่ เวลา และระยะห่าง เช่น |
DestinationStatus
สถานะสำหรับปลายทางที่ระบุ
การแสดง JSON |
---|
{ "reportingContext": enum ( |
ช่อง | |
---|---|
reporting |
เอาต์พุตเท่านั้น ชื่อของปลายทางของโปรโมชัน |
status |
เอาต์พุตเท่านั้น สถานะสำหรับปลายทางที่ระบุ |
รัฐ
สถานะปัจจุบันของโปรโมชัน
Enum | |
---|---|
STATE_UNSPECIFIED |
สถานะโปรโมชันที่ไม่รู้จัก |
IN_REVIEW |
โปรโมชันอยู่ระหว่างตรวจสอบ |
REJECTED |
โปรโมชันไม่ได้รับอนุมัติ |
LIVE |
โปรโมชันได้รับอนุมัติและใช้งานได้ |
STOPPED |
ผู้ขายหยุดโปรโมชันแล้ว |
EXPIRED |
โปรโมชันนี้ใช้งานไม่ได้แล้ว |
PENDING |
โปรโมชันไม่ได้หยุดลงและการตรวจสอบทั้งหมดได้รับอนุมัติแล้ว แต่วันที่ที่ใช้งานอยู่คือวันที่ในอนาคต |
ItemLevelIssue
ปัญหาที่เกี่ยวข้องกับโปรโมชัน
การแสดง JSON |
---|
{ "code": string, "severity": enum ( |
ช่อง | |
---|---|
code |
เอาต์พุตเท่านั้น รหัสข้อผิดพลาดของปัญหา |
severity |
เอาต์พุตเท่านั้น ปัญหานี้ส่งผลต่อการแสดงโปรโมชันอย่างไร |
resolution |
เอาต์พุตเท่านั้น ผู้ขายแก้ไขปัญหาได้หรือไม่ |
attribute |
เอาต์พุตเท่านั้น ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์รายการเดียว |
reporting |
เอาต์พุตเท่านั้น ปลายทางที่มีปัญหา |
description |
เอาต์พุตเท่านั้น คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ |
detail |
เอาต์พุตเท่านั้น คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ |
documentation |
เอาต์พุตเท่านั้น URL ของหน้าเว็บที่จะช่วยแก้ปัญหานี้ได้ |
applicable |
เอาต์พุตเท่านั้น รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่มีปัญหากับข้อเสนอ |
ความรุนแรง
ความรุนแรงของปัญหา
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_IMPACTED |
ปัญหานี้แสดงคำเตือนและไม่มีผลกระทบโดยตรงต่อโปรโมชัน |
DEMOTED |
โปรโมชันถูกลดระดับและมีแนวโน้มสูงที่จะถูกจำกัดประสิทธิภาพในผลการค้นหา |
DISAPPROVED |
ปัญหาที่ส่งผลให้โปรโมชันไม่ได้รับอนุมัติ |
เมธอด |
|
---|---|
|
ดึงข้อมูลโปรโมชันจากบัญชี Merchant Center |
|
แทรกโปรโมชันสำหรับบัญชี Merchant Center |
|
แสดงโปรโมชันในบัญชี Merchant Center |