ใช้โปรโมชันเพื่อแสดงข้อเสนอพิเศษสำหรับผลิตภัณฑ์ที่ขายบน Google โปรโมชันจะแสดงในผลิตภัณฑ์และบริการต่างๆ ของ Google รวมถึง Google Search, Shopping และ Chrome
เมื่อคุณเพิ่มโปรโมชันลงในผลิตภัณฑ์ ผู้เลือกซื้อจะเห็นลิงก์ข้อเสนอพิเศษ เช่น "ลด 15%" หรือ "จัดส่งฟรี" ลิงก์ข้อเสนอสามารถเพิ่มความน่าสนใจของ ผลิตภัณฑ์ของคุณและกระตุ้นให้ผู้เลือกซื้อทำการซื้อ
สำหรับข้อมูลเพิ่มเติม โปรดดู โปรโมชัน พื้นฐาน
ข้อกำหนดเบื้องต้น
Google จำเป็นต้องให้คุณระบุข้อมูลที่เจาะจงเกี่ยวกับธุรกิจของคุณ และ ก่อนแสดงโปรโมชัน คุณต้องมีสิ่งต่อไปนี้
- ผลิตภัณฑ์ที่ใช้งานอยู่ ฟีด ใน Merchant Center
- โปรโมชันที่ใช้งานอยู่ ฟีด ใน Merchant Center
- บัญชี Google Ads สำหรับ Shopping แคมเปญ
นอกจากนี้ คุณต้องลงทะเบียนบัญชีผู้ขายในโปรแกรมโปรโมชันด้วย ถ้า หากไม่แน่ใจว่าลงทะเบียนแล้วหรือไม่ ให้ตรวจสอบช่อง Center
หากยังไม่ได้ลงทะเบียน ให้กรอกคำขอให้เสร็จสมบูรณ์ แบบฟอร์ม ทีมโปรโมชันจะแจ้งให้ทราบเมื่อคุณเริ่มใช้งานได้
สำหรับข้อมูลเพิ่มเติม โปรดดูเกณฑ์การเข้าร่วมและ
สร้างแหล่งข้อมูล
ใช้ API datasource.create เพื่อสร้างฟีดโปรโมชัน หากมี มีฟีดโปรโมชัน ให้ใช้ datasource.get เพื่อดึงข้อมูล datasource.name
แบบฟอร์มคำขอมีดังนี้
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
ตัวอย่าง
ตัวอย่างนี้แสดงคำขอและคำตอบทั่วไป
คำขอ:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
คำตอบ:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
สร้างโปรโมชัน
คุณสามารถใช้
accounts.promotions.insert
วิธีสร้างหรืออัปเดตโปรโมชัน เมธอด accounts.promotions.insert
ใส่ทรัพยากร promotions
และชื่อแหล่งข้อมูลเป็นอินพุต โดยจะแสดง
การโปรโมตใหม่หรือที่อัปเดต หากประสบความสำเร็จ
การสร้างโปรโมชันจำเป็นต้องใช้ datasource.name
Google จะตรวจสอบและอนุมัติโปรโมชันของคุณก่อนเผยแพร่ สำหรับข้อมูลเพิ่มเติม โปรดดูข้อมูลที่หัวข้อการอนุมัติโปรโมชัน กระบวนการ
แบบฟอร์มคำขอ
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
ศึกษาตัวอย่างโปรโมชันต่อไปนี้เพื่อเป็นข้อมูลอ้างอิง
ตัวอย่าง 1: A Local โปรโมชันสำหรับ ผลิตภัณฑ์ทั้งหมดและร้านค้าทั้งหมด
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert
{
"promotion": {
"promotionId": "buy_2_get_10_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"IN_STORE"
],
"attributes": {
"longTitle": "Buy 2 and get 10$ OFF purchase",
"productApplicability": "ALL_PRODUCTS",
"offerType": "NO_CODE",
"couponValueType": "BUY_M_GET_MONEY_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"moneyOffAmount": {
"amountMicros": "1000000",
"currencyCode": "USD"
},
"minimum_purchase_quantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
},
"dataSource": "accounts/123/dataSources/1000000573361824"
}
ตัวอย่างที่ 2: โปรโมชันออนไลน์ที่ใช้กับผลิตภัณฑ์ที่เลือกและมีการแลกสิทธิ์ รหัส
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert
{
"promotion": {
"promotionId": "25_pct_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"ONLINE"
],
"attributes": {
"longTitle": "10% off on selected items",
"productApplicability": "SPECIFIC_PRODUCTS",
"offerType": "GENERIC_CODE",
"genericRedemptionCode": "SPRINGSALE",
"couponValueType": "PERCENT_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"percentOff": 25,
"promotionDestinations": [
"FREE_LISTINGS"
],
"itemIdInclusion": [
"1499860100",
"1499860101",
"1499860102",
"1499860103",
"1499860104"
],
}
},
"dataSource": "accounts/123/dataSources/1000000573361824"
}
หมายเหตุพิเศษ
หลังจากสร้างโปรโมชัน ระบบอาจใช้เวลา 2-3 นาทีในการสร้างโปรโมชัน
ดูรายการแอตทริบิวต์ที่เกี่ยวข้องกับโปรโมชันได้ที่เพิ่มข้อมูลที่มีโครงสร้าง
ก่อนที่จะสร้างและจัดการโปรโมชัน โปรดดูโปรโมชันที่ดีที่สุด แนวทางปฏิบัติ
ดูโปรโมชัน
หากต้องการดูโปรโมชัน ให้ใช้
accounts.promotions.get
การรับนี้เป็นแบบอ่านอย่างเดียว ต้องใช้ merchantId
และรหัสของ
การโปรโมตของคุณ เมธอด get
จะแสดงทรัพยากรโปรโมชันที่เกี่ยวข้อง
เช่น
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
ศึกษาตัวอย่างเหล่านี้
ตัวอย่างที่ 1: โปรโมชันในร้าน
GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/in_store~en~US~buy_2_get_10_off
{
"name": "accounts/123/promotions/in_store~en~US~buy_2_get_10_off",
"promotionId": "buy_2_get_10_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"IN_STORE"
],
"attributes": {
"longTitle": "Buy 2 and get 10$ OFF purchase",
"productApplicability": "ALL_PRODUCTS",
"offerType": "NO_CODE",
"couponValueType": "BUY_M_GET_MONEY_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"moneyOffAmount": {
"amountMicros": "1000000",
"currencyCode": "USD"
},
"minimum_purchase_quantity": 2,
"storeApplicability": "ALL_STORES",
"promotionUrl": "http://promotionnew4url.com/",
"promotionDestinations": [
"LOCAL_INVENTORY_ADS"
],
}
"dataSource": "accounts/123/dataSources/1000000573361824"
}
ตัวอย่าง 2 โปรโมชันออนไลน์
GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/online~en~US~25_pct_off
{
"name": "accounts/123/promotions/online~en~US~25_pct_off",
"promotionId": "25_pct_off",
"contentLanguage": "en",
"targetCountry": "US",
"redemptionChannel": [
"ONLINE"
],
"attributes": {
"longTitle": "10% off on selected items",
"productApplicability": "SPECIFIC_PRODUCTS",
"offerType": "GENERIC_CODE",
"genericRedemptionCode": "WINTERGIFT",
"couponValueType": "PERCENT_OFF",
"promotionDisplayTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"promotionEffectiveTimePeriod": {
"startTime": "2024-2-06T00:47:44Z",
"endTime": "2024-5-06T00:47:44Z"
},
"percentOff": 25,
"promotionDestinations": [
"FREE_LISTINGS"
],
"itemIdInclusion": [
"1499860100",
"1499860101",
"1499860102",
"1499860103",
"1499860104"
],
}
"dataSource": "accounts/{account}/dataSources/{dataSource}"
}
แสดงรายการโปรโมชัน
คุณสามารถใช้
promotions.list
วิธีดูโปรโมชันที่สร้างขึ้นทั้งหมด
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
สถานะโปรโมชัน
หากต้องการดูสถานะของโปรโมชัน ให้ดูแอตทริบิวต์ promotionStatus
ส่งคืนโดย
promotions.get
และ
promotions.list
หากต้องการทำความเข้าใจกระบวนการอนุมัติ โปรดดูที่การอนุมัติโปรโมชัน กระบวนการ
ตัวอย่างสถานะโปรโมชัน
ตัวอย่างต่อไปนี้แสดงความแตกต่างระหว่างการสำเร็จและความล้มเหลว คำขอ
ตัวอย่าง 1 เนื้อหาการตอบกลับต่อไปนี้แสดงการโปรโมตออนไลน์ที่ ถูกปฏิเสธเนื่องจากไม่มีการแมปผลิตภัณฑ์
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "REJECTED"
}
],
"itemLevelIssues": [
{
"code": "promotion_sku_unmapped",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unmapped",
"detail": "This promotion couldn't be tested during review because it doesn't apply to any products that are currently in your Products feed",
"documentation": "https://support.google.com/merchants/answer/2906014",
"applicableCountries": [
"US"
]
},
{
"code": "promotion_sku_additional_requirements",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Promotion conditions not allowed",
"detail": "This promotion has additional requirements that are not allowed such as requiring customers to verify additional details like phone number or ID before showing the promotion details",
"documentation": "https://support.google.com/merchants/answer/2906014",
"applicableCountries": [
"US"
]
}
]
}
ตัวอย่าง 2 เนื้อหาการตอบกลับต่อไปนี้แสดงโปรโมชันที่ได้รับอนุมัติ
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
ตัวอย่าง 3 โปรโมชันที่ได้รับอนุมัติและใช้งานอยู่
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
ดูข้อมูลเพิ่มเติม
ดูรายละเอียดเพิ่มเติมได้ที่ความช่วยเหลือเกี่ยวกับโปรโมชัน Center
โปรดดูข้อมูลเกี่ยวกับการย้ายข้อมูลจาก Content API for Shopping ในหัวข้อย้ายข้อมูลโปรโมชัน การจัดการ