व्यापार प्रोत्साहन एपीआई के बारे में खास जानकारी

Google पर बेचे जाने वाले प्रॉडक्ट के खास ऑफ़र दिखाने के लिए, प्रमोशन का इस्तेमाल करें. प्रमोशन, Google की अलग-अलग प्रॉपर्टीज़ पर दिखाए जाते हैं. इनमें Google Search, Shopping, और Chrome शामिल हैं.

अपने प्रॉडक्ट में प्रमोशन जोड़ने पर, खरीदारों को खास ऑफ़र का लिंक दिखता है. उदाहरण के लिए, "15% की छूट" या "मुफ़्त शिपिंग". ऑफ़र के लिंक आपके प्रॉडक्ट में दिलचस्पी बढ़ा सकते हैं और खरीदारों को खरीदारी करने के लिए प्रोत्साहित कर सकते हैं.

ज़्यादा जानकारी के लिए, प्रमोशन की बुनियादी बातें देखें.

ज़रूरी शर्तें

आपके प्रमोशन दिखाने से पहले, Google को आपके कारोबार और प्रॉडक्ट के बारे में खास जानकारी देनी होगी. आपके पास ये चीज़ें होनी चाहिए:

• Google Merchant Center में मौजूद एक चालू प्रॉडक्ट फ़ीड.
• Google Merchant Center में चालू प्रमोशन फ़ीड.
• शॉपिंग कैंपेन के लिए, एक Google Ads खाता.

इसके अलावा, आपको प्रमोशन प्रोग्राम में अपना व्यापारी खाता रजिस्टर करना होगा. अगर आपको यह तय करने में समस्या आ रही है कि आपका खाता पहले से रजिस्टर है या नहीं, तो Merchant Center पर जाएं.

अगर आपने इस प्रोग्राम में रजिस्टर नहीं किया है, तो अनुरोध करने का फ़ॉर्म भरें. प्रमोशन टीम आपको बताएगी कि आप इसे लागू करने के लिए कब तैयार हैं.

ज़्यादा जानकारी के लिए, शामिल होने के लिए ज़रूरी शर्तें और नीतियां देखें.

डेटा स्रोत बनाना

प्रमोशन फ़ीड बनाने के लिए datasource.create एपीआई का इस्तेमाल करें. अगर कोई मौजूदा प्रमोशन फ़ीड उपलब्ध है, तो datasource.name को फ़ेच करने के लिए, datasource.get का इस्तेमाल करें

अनुरोध इस तरह का है:

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

रेफ़रंस के लिए, यहां दिए गए प्रमोशन के सैंपल देखें.

पहला सैंपल: सभी प्रॉडक्ट और सभी स्टोर पर लागू होने वाला लोकल प्रमोशन

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"
}

दूसरा नमूना: रिडेंप्शन कोड के साथ चुनिंदा प्रॉडक्ट पर लागू होने वाला ऑनलाइन प्रमोशन

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"
}

खास जानकारी

प्रमोशन बनाने के बाद, उसे बनाने में कुछ मिनट लग सकते हैं.

प्रमोशन से जुड़े एट्रिब्यूट की सूची के लिए, स्ट्रक्चर्ड डेटा एट्रिब्यूट जोड़ें देखें.

प्रमोशन बनाने और उन्हें मैनेज करने से पहले, प्रमोशन से जुड़े सबसे सही तरीके देखें.

प्रचार वाला कार्ड देखें

प्रमोशन देखने के लिए, accounts.promotions.get का इस्तेमाल करें. यह सुविधा सिर्फ़ पढ़ने के लिए है. इसके लिए, आपके merchantId और प्रमोशन के आईडी की ज़रूरत होगी. get तरीका, उससे जुड़े प्रमोशन के संसाधन दिखाता है.

उदाहरण के लिए:

GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}

इन सैंपल का अध्ययन करें.

पहला उदाहरण: लोकल प्रमोशन

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"
}

दूसरा सैंपल. ऑनलाइन प्रमोशन

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

प्रमोशन की स्थिति

किसी प्रमोशन की स्थिति देखने के लिए, promotions.get और promotions.list से मिला promotionStatus एट्रिब्यूट देखें.

अनुमति देने की प्रोसेस को समझने के लिए, प्रमोशन को मंज़ूरी की प्रोसेस देखें.

सैंपल प्रमोशन की स्थिति

नीचे दिए गए सैंपल, पूरे होने और पूरे न हो पाने वाले अनुरोधों के बीच का अंतर दिखाते हैं.

पहला सैंपल. जवाब का नीचे दिया गया मुख्य हिस्सा एक ऑनलाइन प्रमोशन दिखाता है, जिसे प्रॉडक्ट मैपिंग मौजूद न होने की वजह से अस्वीकार कर दिया जाएगा.

  "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"
        ]
      }
    ]
  }

दूसरा सैंपल. जवाब का नीचे दिया गया मुख्य हिस्सा, मंज़ूर किया गया एक प्रमोशन दिखाता है.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "PENDING"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "PENDING"
      }
    ],
    "itemLevelIssues": []
  }

तीसरा सैंपल. स्वीकार किया गया और लाइव प्रमोशन

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "LIVE"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "LIVE"
 }  ],
    "itemLevelIssues": []
  }

ज़्यादा जानें

ज़्यादा जानकारी के लिए, प्रमोशन से जुड़ा सहायता केंद्र देखें.

अगर आपको Shopping के लिए Content API से माइग्रेट करना है, तो प्रमोशन मैनेजमेंट को माइग्रेट करना लेख पढ़ें.