ภาพรวมของ API โปรโมชันจากผู้ขาย

ใช้โปรโมชันเพื่อแสดงข้อเสนอพิเศษสำหรับผลิตภัณฑ์ที่คุณขายบน Google โปรโมชันจะแสดงในผลิตภัณฑ์และบริการต่างๆ ของ Google ซึ่งรวมถึง Google Search, Shopping และ Chrome

เมื่อคุณเพิ่มโปรโมชันไปยังผลิตภัณฑ์ ผู้เลือกซื้อจะเห็นลิงก์ข้อเสนอพิเศษ เช่น "ลด 15%" หรือ "จัดส่งฟรี" ลิงก์ข้อเสนอจะช่วยเพิ่มความน่าสนใจให้กับผลิตภัณฑ์และกระตุ้นให้ผู้เลือกซื้อทำการซื้อได้

ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเบื้องต้นเกี่ยวกับโปรโมชัน

ข้อกำหนดเบื้องต้น

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

นอกจากนี้ คุณต้องลงทะเบียนบัญชีผู้ขายในโปรแกรมโปรโมชันด้วย หากไม่แน่ใจว่าได้ลงทะเบียนแล้วหรือยัง ให้ตรวจสอบใน Merchant Center

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

ดูข้อมูลเพิ่มเติมได้ที่เกณฑ์และนโยบายการเข้าร่วม

สร้างแหล่งข้อมูล

ใช้ datasource.create API เพื่อสร้างฟีดโปรโมชัน หากมีฟีดโปรโมชันที่มีอยู่ ให้ใช้เมธอด accounts.dataSources.get เพื่อดึงข้อมูลชื่อแหล่งข้อมูล

รูปแบบคำขอมีดังนี้

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources

ตัวอย่าง

ตัวอย่างนี้แสดงคําขอและการตอบกลับทั่วไป

คำขอ

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

การสร้างโปรโมชันต้องใช้ชื่อของแหล่งข้อมูล

Google จะตรวจสอบและอนุมัติโปรโมชันของคุณก่อนเผยแพร่ ดูข้อมูลเพิ่มเติมได้ที่กระบวนการอนุมัติโปรโมชัน

รูปแบบของคำขอ

POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert

ดูตัวอย่างโปรโมชันต่อไปนี้เพื่อเป็นข้อมูลอ้างอิง

ตัวอย่างที่ 1: โปรโมชันในร้านที่ใช้ได้กับผลิตภัณฑ์และร้านค้าทั้งหมด

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"
      },
      "minimumPurchaseQuantity": 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 นาทีเพื่อให้โปรโมชันปรากฏในฐานข้อมูล Shopping

ดูรายการแอตทริบิวต์ที่เกี่ยวข้องกับโปรโมชันได้ที่เพิ่มแอตทริบิวต์ Structured Data

โปรดดูแนวทางปฏิบัติแนะนำสำหรับโปรโมชันก่อนสร้างและจัดการโปรโมชัน

ดูโปรโมชัน

หากต้องการดูโปรโมชัน ให้ใช้ 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"
   },
   "minimumPurchaseQuantity": 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": []
  }

ดูข้อมูลเพิ่มเติม

ดูรายละเอียดเพิ่มเติมได้ที่ศูนย์ช่วยเหลือเกี่ยวกับโปรโมชัน

ดูข้อมูลเกี่ยวกับการย้ายข้อมูลจาก Content API for Shopping ได้ที่ย้ายข้อมูลการจัดการโปรโมชัน