লয়ালটি প্রোগ্রামের ওভারভিউ

লয়ালটি প্রোগ্রাম ব্যবহার করে Google-এ আপনার স্টোরের সুবিধা দেখান। আপনি ফ্রি শিপিং, রিডিম করা যায় এমন পয়েন্ট এবং মেম্বারদের জন্য এক্সক্লুসিভ দামের মতো বিভিন্ন সুবিধা জমা দিতে পারবেন। আপনার লয়ালটি প্রোগ্রামের সুবিধা Google Search, শপিং ট্যাব এবং Google Wallet সহ Google সারফেস জুড়ে ফ্রি লিস্টিং, শপিং বিজ্ঞাপন এবং স্থানীয় ইনভেনটরি বিজ্ঞাপনে দেখানো হতে পারে।

Merchant API-এর মাধ্যমে, মার্চেন্ট এবং মার্চেন্টের হয়ে কাজ করা থার্ড-পার্টি লয়ালটি প্রোগ্রাম প্রদানকারী LoyaltyProgramService ব্যবহার করে প্রোগ্রাম্যাটিকভাবে লয়ালটি প্রোগ্রাম কনফিগার ও ম্যানেজ করতে পারেন। এই পরিষেবার মাধ্যমে আপনি লয়ালটি প্রোগ্রাম তৈরি, ফিরিয়ে আনা, তালিকাভুক্ত, আপডেট ও মুছে ফেলতে পারবেন।

গুরুত্বপূর্ণ: এই পরিষেবা শুধুমাত্র বাছাই করা মার্চেন্টদের জন্য উপলভ্য। সমস্যা/প্রশ্ন কী? বিকল্পের অধীনে Shopping API সহায়তা ফর্মে সাদাতালিকা সংক্রান্ত অনুরোধ জমা দিয়ে অংশগ্রহণের আগ্রহ প্রকাশ করতে সহায়তা টিমের সাথে যোগাযোগ করুন > অনুমোদিত তালিকা সংক্রান্ত অনুরোধ > অন্যান্য।

ব্যবসার প্রয়োজনীয়তা ও নীতি নির্দেশিকা সম্পর্কে আরও জানতে, Merchant Center সহায়তা কেন্দ্রে মার্চেন্ট লয়ালটি প্রোগ্রাম সম্পর্কে দেখুন।

মূল ধারণা

লয়ালটি প্রোগ্রামের সাথে কাজ করার সময় নিম্নলিখিত ধারণা এবং সীমাবদ্ধতাগুলি মনে রাখবেন:

• অ্যাকাউন্ট-লেভেল শনাক্তকারী: Merchant API, মালিকানা থাকা Merchant Center অ্যাকাউন্ট আইডির মাধ্যমে লয়ালটি প্রোগ্রাম শনাক্ত করে।
• একটি প্রোগ্রামের সীমা: মার্চেন্ট API-তে প্রতিটি মার্চেন্ট অ্যাকাউন্টের জন্য শুধুমাত্র একটি লয়ালটি প্রোগ্রাম কাজ করে।
• সরাসরি অ্যাকাউন্টের মালিকানা: লয়ালটি প্রোগ্রাম সরাসরি টার্গেট মার্চেন্ট অ্যাকাউন্টে (accounts/{ACCOUNT_ID}) কনফিগার করতে হবে। সাব-অ্যাকাউন্টের জন্য উন্নত অ্যাকাউন্ট লেভেলে লয়ালটি প্রোগ্রাম ম্যানেজ করার সুবিধা এই পরিষেবায় নেই। থার্ড-পার্টি লয়ালটি প্রদানকারী, যার কাছে মার্চেন্টের অ্যাকাউন্টের অনুমোদিত অ্যাক্সেস আছে, তিনি মার্চেন্টের হয়ে প্রোগ্রামটি ম্যানেজ করতে পারেন।
• এডিটোরিয়াল রিভিউ: লয়ালটি প্রোগ্রাম তৈরি বা আপডেট করার পরে, প্রোগ্রামটি রিভিউ করা হয়। review_result.review_status ফিল্ড থেকে বোঝা যায় যে প্রোগ্রামটি UNDER_REVIEW, APPROVED নাকি REJECTED।
• কাজ করে এমন অঞ্চল: মার্চেন্ট লয়ালটি প্রোগ্রাম কাজ করে এমন দেশে উপলভ্য, যার মধ্যে অস্ট্রেলিয়া, ব্রাজিল, কানাডা, ফ্রান্স, জার্মানি, ভারত, ইতালি, মেক্সিকো, নেদারল্যান্ডস, দক্ষিণ কোরিয়া, স্পেন, যুক্তরাজ্য এবং মার্কিন যুক্তরাষ্ট্র অন্তর্ভুক্ত।
• টিয়ার সংক্রান্ত প্রয়োজনীয়তা: টিয়ারে যোগ দেওয়ার জন্য কোনও খরচ নাও লাগতে পারে, মেম্বারশিপ ফি লাগতে পারে, খরচের থ্রেশহোল্ড থাকতে পারে অথবা মার্চেন্ট-ব্র্যান্ডেড ক্রেডিট কার্ডের প্রয়োজন হতে পারে। পেশা-ভিত্তিক টিয়ার (যেমন, স্টুডেন্ট বা মিলিটারি টিয়ার) কাজ করে না।
• বিশেষ উপহার ও সুবিধা: প্রোগ্রামে ফ্রি শিপিং, রিডিম করা যায় এমন পয়েন্ট এবং মেম্বারদের জন্য দামের সুবিধা পাওয়া যায়। বিজ্ঞাপনে, মেম্বার প্রাইসিংয়ের জন্য স্বাভাবিক বা বিক্রয় মূল্যের থেকে কমপক্ষে ৫% বা ৫ কারেন্সি ইউনিট কম হতে হবে।

পূর্বশর্ত

Merchant API-এর মাধ্যমে লয়ালটি প্রোগ্রাম ম্যানেজ করার আগে, আপনি নিম্নলিখিত প্রয়োজনীয়তা পূরণ করেছেন কিনা তা নিশ্চিত করুন:

• আপনার একটি অ্যাক্টিভ Merchant Center অ্যাকাউন্ট থাকতে হবে (অথবা আপনি যদি থার্ড-পার্টি লয়ালটি প্রদানকারী হন, তাহলে মার্চেন্টের অ্যাকাউন্টে অনুমোদিত অ্যাক্সেস থাকতে হবে)।
• আপনার অ্যাকাউন্টের জন্য লয়ালটি প্রোগ্রাম অ্যাড-অন চালু করুন। আপনি নিম্নলিখিত বিকল্পগুলির যেকোনও একটি ব্যবহার করে অ্যাড-অন চালু করতে পারবেন:
  • Merchant Center UI: Merchant Center সহায়তায় লয়ালটি প্রোগ্রাম সেট-আপ করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।
  • প্রোগ্রাম সাব-API: প্রোগ্রাম সাব-API-তে প্রোগ্রাম চালু করুন লিঙ্কে যেভাবে বর্ণনা করা হয়েছে সেইভাবে প্রোগ্র্যামাটিক উপায়ে প্রোগ্রাম চালু করুন।

Programs সাব-API ব্যবহার করে লয়ালটি প্রোগ্রাম অ্যাড-অন চালু করার জন্য একটি স্যাম্পেল অনুরোধ এখানে দেওয়া হল:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable

cURL

curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

পদ্ধতি

নিম্নলিখিত পদ্ধতি ব্যবহার করে লয়ালটি প্রোগ্রাম ম্যানেজ করুন:

• loyaltyPrograms.create
• loyaltyPrograms.get
• loyaltyPrograms.list
• loyaltyPrograms.update
• loyaltyPrograms.delete

লয়ালটি প্রোগ্রাম তৈরি করুন

কোনও অ্যাকাউন্টের জন্য নতুন লয়ালটি প্রোগ্রাম তৈরি করতে, loyaltyPrograms.create পদ্ধতি ব্যবহার করুন। প্রোগ্রামের বিবরণ, সাইন-আপ URL এবং প্রোগ্রামের টিয়ারের সাথে সেগুলির অনন্য সুবিধা ও প্রয়োজনীয়তার মতো বিবরণ উল্লেখ করুন।

প্রয়োজনীয় program_label লয়ালটি প্রোগ্রামের জন্য অনন্য শনাক্তকারী সেট করে। যেমন, my-rewards লেবেল প্রদান করলে accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards-এর name রিসোর্স পাওয়া যায়।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

{
  "programLabel": "my-rewards",
  "loyaltyProgram": {
    "programName": "my rewards",
    "tiers": [
      {
        "tierName": "gold",
        "tierLabel": "gold",
        "tierBenefits": [
          {
            "otherBenefit": "free gift on your birthday"
          },
          {
            "structuredBenefit": {
              "pointsEarningBenefit": {
                "minimumMoneySpent": {
                  "currencyCode": "USD",
                  "units": "25"
                },
                "pointsEarningBenefitAnnotation": {
                  "pointsEarned": 1.0,
                  "amountSpent": {
                    "currencyCode": "USD",
                    "units": "1"
                  }
                }
              }
            }
          }
        ],
        "requirements": {
          "freeToJoin": true
        }
      }
    ],
    "programDescriptions": [
      "earn rewards buying products you love"
    ],
    "signupUrl": "https://www.example.com/my_rewards_signup",
    "regionCodes": [
      "US"
    ]
  }
}

{ACCOUNT_ID}-এর জায়গায় আপনার Merchant Center অ্যাকাউন্টের অনন্য শনাক্তকারী লিখুন।

অনুরোধ সফল হলে কেমন উত্তর পাওয়া যায় তার একটি নমুনা এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

লয়ালটি প্রোগ্রাম ফিরিয়ে আনা

নিজস্ব মালিকানাধীন নির্দিষ্ট লয়ালটি প্রোগ্রামের বিবরণ ফিরিয়ে আনতে, loyaltyPrograms.get পদ্ধতি ব্যবহার করুন।

মনে রাখবেন: লয়ালটি প্রোগ্রাম অ্যাড-অন চালু না করা থাকলেও, এই এন্ডপয়েন্ট এখনও কোনও সমস্যা না দেখিয়ে ম্যাচিং লয়ালটি প্রোগ্রামের সাথে উত্তর দেয়।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{ACCOUNT_ID}-এর জায়গায় আপনার অ্যাকাউন্ট আইডি এবং {PROGRAM_LABEL}-এর জায়গায় লয়ালটি প্রোগ্রামের অনন্য লেবেল লিখুন (যেমন, my-rewards)।

অনুরোধ সফল হলে কেমন উত্তর পাওয়া যায় তার একটি নমুনা এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

লয়ালটি প্রোগ্রামের তালিকা

আপনার অ্যাকাউন্টের সাথে যুক্ত সব নিজস্ব লয়ালটি প্রোগ্রামের তালিকা দেখতে, loyaltyPrograms.list পদ্ধতি ব্যবহার করুন।

মনে রাখবেন: এই পদ্ধতিতে শুধুমাত্র নির্দিষ্ট অ্যাকাউন্টের মালিকানাধীন লয়ালটি প্রোগ্রাম তালিকাভুক্ত করা হয়, সাব-অ্যাকাউন্টের সাথে সম্পর্কিত প্রোগ্রাম নয়। এমনকি লয়ালটি প্রোগ্রাম অ্যাড-অন বন্ধ করা থাকলেও, এই এন্ডপয়েন্ট কোনও সমস্যা না দেখিয়েই আগে থেকে থাকা প্রোগ্রামের সাথে উত্তর দেয়।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

অনুরোধ সফল হলে কেমন উত্তর পাওয়া যায় তার একটি নমুনা এখানে দেওয়া হল:

{
  "loyaltyPrograms": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
      "programName": "my rewards",
      "tiers": [
        {
          "tierName": "gold",
          "tierLabel": "gold",
          "tierBenefits": [
            {
              "otherBenefit": "free gift on your birthday"
            },
            {
              "structuredBenefit": {
                "pointsEarningBenefit": {
                  "minimumMoneySpent": {
                    "currencyCode": "USD",
                    "units": "25"
                  },
                  "pointsEarningBenefitAnnotation": {
                    "pointsEarned": 1.0,
                    "amountSpent": {
                      "currencyCode": "USD",
                      "units": "1"
                    }
                  }
                }
              }
            }
          ],
          "requirements": {
            "freeToJoin": true
          },
          "signupUrl": "https://www.example.com/my-rewards/gold"
        }
      ],
      "programDescriptions": [
        "earn rewards buying products you love"
      ],
      "signupUrl": "https://www.example.com/my_rewards_signup",
      "reviewResult": {
        "reviewStatus": "UNDER_REVIEW"
      },
      "regionCodes": [
        "US"
      ]
    }
  ]
}

লয়ালটি প্রোগ্রাম আপডেট করা

আগে থেকে থাকা লয়ালটি প্রোগ্রাম আপডেট করতে, loyaltyPrograms.update পদ্ধতি ব্যবহার করুন। update_mask ব্যবহার করে আংশিক আপডেট করুন অথবা মাস্ক বাদ দিয়ে সম্পূর্ণ পরিবর্তন করুন।

গুরুত্বপূর্ণ: লয়ালটি প্রোগ্রাম আপডেট করার সময়, বারবার দেখানো ফিল্ড (যেমন programDescriptions এবং tiers) সেই জায়গায় আপডেট করা যাবে না। আপডেটে অন্তর্ভুক্ত যেকোনও পুনরাবৃত্ত ফিল্ড আগে থেকে থাকা সম্পূর্ণ তালিকাটি প্রতিস্থাপন করে। অনিচ্ছাকৃতভাবে ডেটা মুছে যাওয়া এড়াতে, রিপিট করা ফিল্ড আপডেট করার আগে বর্তমান ভ্যালু ফিরিয়ে আনতে প্রথমে get অনুরোধ পাঠান।

আপডেট মাস্ক সহ আংশিক আপডেট

update_mask-এর মাধ্যমে আপনি আপডেট করার জন্য নির্দিষ্ট ফিল্ড উল্লেখ করতে পারবেন। শুধুমাত্র মাস্কে তালিকাভুক্ত ফিল্ডগুলি পরিবর্তিত হয়, যখন তালিকাভুক্ত নয় এমন ফিল্ডগুলি অপরিবর্তিত থাকে। আপডেট মাস্ক থেকে বাদ দেওয়া যেকোনও ফিল্ড উপেক্ষা করা হয়, এমনকি অনুরোধের বডিতে উল্লেখ করা থাকলেও।

নিম্নলিখিত স্যাম্পেল অনুরোধ শুধুমাত্র programDescriptions এবং advancedSettings আপডেট করে:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings

{
  "programDescriptions": [
    "a new description of the program"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  },
  "signupUrl": "https://www.example.com"
}

এই উদাহরণে, পরিষেবাটি signupUrl উপেক্ষা করে কারণ এটি update_mask-এ অন্তর্ভুক্ত নয়। programDescriptions ফিল্ডটি আগে কনফিগার করা যেকোনও বিবরণ সম্পূর্ণভাবে পরিবর্তন করে।

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "a new description of the program"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  }
}

আপডেট মাস্ক ছাড়াই সম্পূর্ণ প্রতিস্থাপন

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

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{
  "programName": "Updated Program",
  "signupUrl": "https://example.com/updated",
  "programDescriptions": [
    "Updated description"
  ],
  "regionCodes": [
    "US"
  ],
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ]
}

সফল অনুরোধের একটি নমুনা উত্তর এখানে দেওয়া হল:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "Updated Program",
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ],
  "programDescriptions": [
    "Updated description"
  ],
  "signupUrl": "https://example.com/updated",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

লয়ালটি প্রোগ্রাম মুছে ফেলা

আপনার অ্যাকাউন্ট থেকে লয়ালটি প্রোগ্রাম মুছে দিতে, loyaltyPrograms.delete পদ্ধতি ব্যবহার করুন।

এখানে একটি স্যাম্পেল অনুরোধ দেওয়া হল:

HTTP

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

সফল হলে, রেসপন্স বডি খালি থাকে।

পরবর্তী ধাপ

• Google Search-এ অর্গানিক পছন্দমতো সাজানোর জন্য আপনার লয়ালটি প্রোগ্রাম টিয়ারের সাথে স্বতন্ত্র ক্রেতাদের যুক্ত করতে, লয়ালটি কাস্টমার ম্যাচ পরিষেবা সংক্রান্ত গাইড দেখুন।
• আপনার অ্যাকাউন্টের জন্য শপিং প্রোগ্রাম চালু বা বন্ধ করতে, প্রোগ্রাম সাব-API গাইড দেখুন।
• ব্যবসা সেট-আপের বিবরণ, এডিটোরিয়াল নীতি ও রিপোর্টিংয়ের জন্য, Merchant Center সহায়তায় মার্চেন্ট লয়ালটি প্রোগ্রাম সম্পর্কে দেখুন।
• API পদ্ধতি ও রিসোর্স সংজ্ঞা এক্সপ্লোর করতে, Merchant API রেফারেন্স দেখুন।