বণিক প্রচার API এর ওভারভিউ

আপনি Google এ বিক্রি করেন এমন পণ্যগুলির জন্য বিশেষ অফারগুলি প্রদর্শন করতে প্রচারগুলি ব্যবহার করুন৷ প্রচারগুলি Google অনুসন্ধান, কেনাকাটা এবং Chrome সহ বিভিন্ন Google বৈশিষ্ট্য জুড়ে প্রদর্শিত হয়৷

আপনি যখন আপনার পণ্যগুলিতে প্রচার যোগ করেন, ক্রেতারা একটি বিশেষ অফার লিঙ্ক দেখতে পান, উদাহরণস্বরূপ "15% ছাড়" বা "ফ্রি শিপিং"৷ অফার লিঙ্কগুলি আপনার পণ্যের আবেদন বাড়াতে পারে এবং ক্রেতাদের ক্রয় করতে উত্সাহিত করতে পারে।

আরও তথ্যের জন্য, প্রচারের মূল বিষয়গুলি দেখুন।

পূর্বশর্ত

আপনার প্রচারগুলি প্রদর্শন করার আগে Google আপনাকে আপনার ব্যবসা এবং পণ্য সম্পর্কে নির্দিষ্ট তথ্য প্রদান করতে হবে৷ আপনার অবশ্যই নিম্নলিখিতগুলি থাকতে হবে:

• Google Merchant Center- এ একটি সক্রিয় পণ্য ফিড ।
• Google Merchant Center- এ একটি সক্রিয় প্রচার ফিড ।
• শপিং প্রচারাভিযানের জন্য একটি Google বিজ্ঞাপন অ্যাকাউন্ট।

এছাড়াও, আপনাকে অবশ্যই প্রচার প্রোগ্রামে আপনার বণিক অ্যাকাউন্ট নথিভুক্ত করতে হবে। আপনি ইতিমধ্যে নথিভুক্ত কিনা তা নিশ্চিত না হলে, বণিক কেন্দ্র চেক করুন।

আপনি নথিভুক্ত না হলে, অনুরোধ ফর্মটি পূরণ করুন৷ আপনি যখন বাস্তবায়ন শুরু করতে প্রস্তুত তখন প্রচার দল আপনাকে জানাবে।

আরও তথ্যের জন্য, অংশগ্রহণের মানদণ্ড এবং নীতিগুলি দেখুন।

একটি ডেটা উত্স তৈরি করুন

একটি প্রচার ফিড তৈরি করতে datasource.create API ব্যবহার করুন। যদি একটি বিদ্যমান প্রচার ফিড উপলব্ধ থাকে, 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

রেফারেন্সের জন্য নিম্নলিখিত নমুনা প্রচারগুলি অধ্যয়ন করুন।

নমুনা 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"
      },
      "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"
}

বিশেষ নোট

প্রচার তৈরির পরে, প্রচার তৈরি করতে কয়েক মিনিট সময় লাগতে পারে৷

প্রচার-সম্পর্কিত বৈশিষ্ট্যগুলির একটি তালিকার জন্য, কাঠামোগত ডেটা বৈশিষ্ট্য যুক্ত করুন দেখুন।

প্রচার তৈরি এবং পরিচালনা করার আগে, প্রচারের সেরা অনুশীলন দেখুন।

প্রচার দেখুন

একটি প্রচার দেখতে, 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

প্রচারের অবস্থা

একটি প্রচারের স্থিতি দেখতে, আপনি promotions.get এবং promotions.list দ্বারা ফেরত promotionStatus বৈশিষ্ট্য দেখতে পারেন।

অনুমোদন প্রক্রিয়া বুঝতে, প্রচার অনুমোদন প্রক্রিয়া দেখুন।

নমুনা প্রচার অবস্থা

নিম্নলিখিত নমুনা সফল এবং ব্যর্থ অনুরোধের মধ্যে পার্থক্য প্রদর্শন করে।

নমুনা 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": []
  }

আরও জানুন

আরও বিশদ বিবরণের জন্য, প্রচার সহায়তা কেন্দ্র দেখুন।

কেনাকাটার জন্য বিষয়বস্তু API থেকে স্থানান্তরিত করার বিষয়ে জানতে, মাইগ্রেট প্রচার ব্যবস্থাপনা দেখুন।