- แหล่งข้อมูล: การโปรโมต
- RedemptionChannel
- แอตทริบิวต์
- ProductApplicability
- OfferType
- CouponValueType
- DestinationEnum
- StoreApplicability
- PromotionStatus
- DestinationStatus
- สถานะ
- ItemLevelIssue
- ระดับความรุนแรง
- เมธอด
แหล่งข้อมูล: การโปรโมต
แสดงโปรโมชัน โปรดดูรายละเอียดเพิ่มเติมในบทความต่อไปนี้
แอตทริบิวต์อินพุตโปรโมชันที่ต้องระบุเพื่อให้ผ่านการตรวจสอบความถูกต้องของข้อมูลมีดังนี้
หลังจากแทรกแล้ว การอัปเดตข้อมูลโปรโมชัน อาจต้องรอหลายนาทีกว่าจะดึงข้อมูลโปรโมชันสุดท้ายได้
การแสดง JSON |
---|
{ "name": string, "promotionId": string, "contentLanguage": string, "targetCountry": string, "redemptionChannel": [ enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของโปรโมชัน รูปแบบ: |
promotionId |
ต้องระบุ ผู้ใช้ระบุรหัสโปรโมชันเพื่อระบุโปรโมชันโดยไม่ซ้ำกัน ปฏิบัติตามข้อกำหนดขั้นต่ำเพื่อป้องกันการไม่อนุมัติโปรโมชัน |
contentLanguage |
ต้องระบุ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับโปรโมชัน โปรโมชันใช้ได้กับภาษาที่เลือกเท่านั้น |
targetCountry |
ต้องระบุ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR โปรโมชันมีให้บริการเฉพาะในบางประเทศ รวมถึงโฆษณาสินค้าคงคลังในร้านและข้อมูลที่แสดงฟรีและโฆษณา Shopping เท่านั้น |
redemptionChannel[] |
ต้องระบุ ช่องทางการแลกสิทธิ์สำหรับโปรโมชัน ต้องมีแชแนลอย่างน้อย 1 รายการ |
dataSource |
เอาต์พุตเท่านั้น แหล่งข้อมูลหลักของโปรโมชัน |
attributes |
ไม่บังคับ รายการแอตทริบิวต์โปรโมชัน |
customAttributes[] |
ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ระบุโดยผู้ขาย) นอกจากนี้ ยังใช้สำหรับการส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น |
promotionStatus |
เอาต์พุตเท่านั้น สถานะของโปรโมชัน ปัญหาในการตรวจสอบข้อมูล ซึ่งก็คือข้อมูลเกี่ยวกับโปรโมชันที่คำนวณแบบไม่พร้อมกัน |
versionNumber |
ไม่บังคับ แสดงโปรโมชันเวอร์ชันที่มีอยู่ (ความใหม่) ซึ่งใช้เพื่อรักษาลำดับที่เหมาะสมเมื่ออัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันการแทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของโปรโมชันที่มีอยู่ การแทรกอีกครั้ง (เช่น รีเฟรชโปรโมชันหลังผ่านไป 30 วัน) จะดำเนินการด้วย หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก |
RedemptionChannel
ช่องทางของโปรโมชัน
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
บ่งบอกว่าไม่ได้ระบุช่อง |
IN_STORE |
บ่งบอกว่าช่องอยู่ในร้านค้าแล้ว ซึ่งเหมือนกับช่อง local ที่ใช้สำหรับ products |
ONLINE |
บ่งบอกว่าช่องออนไลน์อยู่ |
Attributes
แอตทริบิวต์
การแสดง JSON |
---|
{ "productApplicability": enum ( |
ช่อง | |
---|---|
productApplicability |
ต้องระบุ ความเกี่ยวข้องของโปรโมชันกับผลิตภัณฑ์ทั้งหมดหรือเฉพาะผลิตภัณฑ์ที่เฉพาะเจาะจง |
offerType |
ต้องระบุ ประเภทของโปรโมชัน ใช้แอตทริบิวต์นี้เพื่อระบุว่าลูกค้าต้องใช้รหัสคูปองเพื่อแลกสิทธิ์โปรโมชันหรือไม่ |
genericRedemptionCode |
ไม่บังคับ รหัสแลกรับข้อเสนอทั่วไปสำหรับโปรโมชัน เพื่อใช้กับช่อง |
longTitle |
ต้องระบุ ชื่อเต็มสำหรับโปรโมชัน |
couponValueType |
ต้องระบุ แอตทริบิวต์ coupon value type เพื่อระบุประเภทโปรโมชันที่ใช้งานอยู่ ต้องระบุแอตทริบิวต์บางรายการ ทั้งนี้ขึ้นอยู่กับประเภทของมูลค่าคูปองที่เลือก |
promotionDestinations[] |
ต้องระบุ รายการปลายทางที่ใช้โปรโมชัน หากไม่ระบุปลายทางด้วยการใส่ค่าที่รองรับในแหล่งข้อมูล โปรโมชันจะแสดงในโฆษณา Shopping และข้อมูลที่แสดงฟรีโดยค่าเริ่มต้น ก่อนหน้านี้คุณอาจส่งค่า Shopping Actions, แพลตฟอร์มของ Google, แพลตฟอร์มในพื้นที่ของ Google เป็นปลายทางสำหรับผลิตภัณฑ์ หากต้องการแทนค่าเหล่านี้ ให้ใช้ |
itemIdInclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
brandInclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามแบรนด์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
itemGroupIdInclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์โปรโมชัน [productApplicability] เป็น specific_products |
productTypeInclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามประเภทผลิตภัณฑ์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
itemIdExclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นรหัสสินค้าสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
brandExclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นแบรนด์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
itemGroupIdExclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามรหัสกลุ่มสินค้า ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
productTypeExclusion[] |
ไม่บังคับ ตัวกรองผลิตภัณฑ์ตามการยกเว้นประเภทผลิตภัณฑ์สำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองผลิตภัณฑ์ก็ต่อเมื่อตั้งค่าแอตทริบิวต์ผลิตภัณฑ์ที่มีสิทธิ์สำหรับความเกี่ยวข้องของผลิตภัณฑ์สำหรับโปรโมชัน |
minimumPurchaseAmount |
ไม่บังคับ ยอดสั่งซื้อขั้นต่ำสำหรับโปรโมชัน |
minimumPurchaseQuantity |
ไม่บังคับ จำนวนการซื้อขั้นต่ำสำหรับโปรโมชัน |
limitQuantity |
ไม่บังคับ จำนวนการซื้อสูงสุดสำหรับโปรโมชัน |
limitValue |
ไม่บังคับ ราคาผลิตภัณฑ์สูงสุดสำหรับโปรโมชัน |
percentOff |
ไม่บังคับ ส่วนลดเป็นเปอร์เซ็นต์ที่เสนอในโปรโมชัน |
moneyOffAmount |
ไม่บังคับ จำนวนเงินส่วนลดที่เสนอในโปรโมชัน |
getThisQuantityDiscounted |
ไม่บังคับ จํานวนสินค้าที่ลดราคาในโปรโมชัน ระบบจะตั้งค่าแอตทริบิวต์เมื่อ |
freeGiftValue |
ไม่บังคับ มูลค่าของขวัญฟรีสำหรับโปรโมชัน |
freeGiftDescription |
ไม่บังคับ รายละเอียดของขวัญฟรีสำหรับโปรโมชัน |
freeGiftItemId |
ไม่บังคับ รหัสสินค้าของขวัญฟรีสำหรับโปรโมชัน |
promotionEffectiveTimePeriod |
ต้องระบุ |
promotionDisplayTimePeriod |
ไม่บังคับ |
storeApplicability |
ไม่บังคับ ใช้โปรโมชันกับร้านค้าทั้งหมดหรือเฉพาะร้านค้าที่ระบุ การโปรโมตโฆษณาสินค้าคงคลังในร้านจะเกิดข้อผิดพลาดหากไม่มีความเกี่ยวข้องกับร้านค้า ระบบจะแสดงข้อผิดพลาด |
storeCodesInclusion[] |
ไม่บังคับ รหัสร้านค้าที่จะรวมสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองร้านค้าเมื่อตั้งค่าแอตทริบิวต์ รหัสร้านค้า (รหัสร้านค้าจาก Business Profile) ของกิจการที่มีหน้าร้านจริงที่จำหน่ายผลิตภัณฑ์นั้น ดูข้อมูลเพิ่มเติมได้ในข้อกำหนดในการจัดทำข้อมูลสินค้าคงคลังของผลิตภัณฑ์ในร้าน |
storeCodesExclusion[] |
ไม่บังคับ รหัสร้านค้าที่จะยกเว้นสำหรับโปรโมชัน ระบบจะใช้แอตทริบิวต์ตัวกรองร้านค้าเมื่อตั้งค่าแอตทริบิวต์ |
promotionUrl |
ไม่บังคับ 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 |
StoreApplicability
รหัสร้านค้าหรือรายการรหัสร้านค้าที่ใช้โปรโมชัน สำหรับโปรโมชันโฆษณาสินค้าคงคลังในร้านเท่านั้น
Enum | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
ไม่ทราบรหัสร้านค้าที่ใช้โปรโมชัน |
ALL_STORES |
โปรโมชันใช้ได้กับร้านค้าทุกแห่ง |
SPECIFIC_STORES |
โปรโมชันใช้ได้กับร้านค้าที่ระบุเท่านั้น |
PromotionStatus
สถานะของโปรโมชัน
การแสดง JSON |
---|
{ "destinationStatuses": [ { object ( |
ช่อง | |
---|---|
destinationStatuses[] |
เอาต์พุตเท่านั้น ปลายทางที่ต้องการสำหรับโปรโมชัน |
itemLevelIssues[] |
เอาต์พุตเท่านั้น รายการปัญหาที่เกี่ยวข้องกับโปรโมชัน |
creationDate |
เอาต์พุตเท่านั้น วันที่สร้างโปรโมชันในรูปแบบ ISO 8601 ได้แก่ วันที่ เวลา และออฟเซ็ต เช่น |
lastUpdateDate |
เอาต์พุตเท่านั้น วันที่ที่อัปเดตสถานะโปรโมชันครั้งล่าสุดในรูปแบบ ISO 8601 ซึ่งได้แก่ วันที่ เวลา และออฟเซ็ต เช่น |
DestinationStatus
สถานะของปลายทางที่ระบุ
การแสดง JSON |
---|
{ "reportingContext": enum ( |
ช่อง | |
---|---|
reportingContext |
เอาต์พุตเท่านั้น ชื่อของปลายทางโปรโมชัน |
status |
เอาต์พุตเท่านั้น สถานะของปลายทางที่ระบุ |
รัฐ
สถานะปัจจุบันของโปรโมชัน
Enum | |
---|---|
STATE_UNSPECIFIED |
สถานะโปรโมชันที่ไม่รู้จัก |
IN_REVIEW |
โปรโมชันอยู่ระหว่างตรวจสอบ |
REJECTED |
โปรโมชันไม่ได้รับอนุมัติ |
LIVE |
โปรโมชันได้รับอนุมัติแล้วและใช้งานได้ |
STOPPED |
ผู้ขายหยุดโปรโมชันแล้ว |
EXPIRED |
โปรโมชันนี้ใช้งานไม่ได้แล้ว |
PENDING |
เราไม่ได้หยุดใช้โปรโมชันและการตรวจสอบทั้งหมดได้รับอนุมัติแล้ว แต่วันที่เปิดใช้งานถือเป็นวันที่ในอนาคต |
ItemLevelIssue
ปัญหาที่เกี่ยวข้องกับโปรโมชัน
การแสดง JSON |
---|
{ "code": string, "severity": enum ( |
ช่อง | |
---|---|
code |
เอาต์พุตเท่านั้น รหัสข้อผิดพลาดของปัญหา |
severity |
เอาต์พุตเท่านั้น ปัญหานี้ส่งผลต่อการแสดงโปรโมชันอย่างไร |
resolution |
เอาต์พุตเท่านั้น ผู้ขายแก้ไขปัญหาได้หรือไม่ |
attribute |
เอาต์พุตเท่านั้น ชื่อแอตทริบิวต์ หากปัญหาเกิดจากแอตทริบิวต์เดียว |
reportingContext |
เอาต์พุตเท่านั้น ปลายทางที่เกิดปัญหา |
description |
เอาต์พุตเท่านั้น คำอธิบายปัญหาสั้นๆ เป็นภาษาอังกฤษ |
detail |
เอาต์พุตเท่านั้น คำอธิบายปัญหาโดยละเอียดเป็นภาษาอังกฤษ |
documentation |
เอาต์พุตเท่านั้น URL ของหน้าเว็บที่จะช่วยแก้ปัญหานี้ได้ |
applicableCountries[] |
เอาต์พุตเท่านั้น รายการรหัสประเทศ (ISO 3166-1 alpha-2) ที่เกี่ยวข้องกับข้อเสนอ |
ความรุนแรง
ความรุนแรงของปัญหา
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_IMPACTED |
ปัญหานี้แสดงถึงคำเตือนและไม่มีผลโดยตรงต่อการโปรโมต |
DEMOTED |
โปรโมชันถูกลดระดับและมีแนวโน้มสูงที่จะถูกจำกัดประสิทธิภาพในผลการค้นหา |
DISAPPROVED |
ปัญหาไม่อนุมัติโปรโมชัน |
เมธอด |
|
---|---|
|
เรียกข้อมูลโปรโมชันจากบัญชี Merchant Center |
|
แทรกโปรโมชันสำหรับบัญชี Merchant Center |
|
แสดงรายการโปรโมชันในบัญชี Merchant Center |