লয়ালটি প্রোগ্রামগুলির সংক্ষিপ্ত বিবরণ

লয়ালটি প্রোগ্রাম ব্যবহার করে গুগলে আপনার স্টোরের সুবিধাগুলো তুলে ধরুন। আপনি বিনামূল্যে শিপিং, রিডিমযোগ্য পয়েন্ট এবং সদস্যদের জন্য বিশেষ মূল্যছাড়ের মতো বিভিন্ন সুবিধা জমা দিতে পারেন। আপনার লয়ালটি প্রোগ্রামের সুবিধাগুলো গুগল সার্চ, শপিং ট্যাব এবং গুগল ওয়ালেট সহ গুগলের বিভিন্ন প্ল্যাটফর্মে ফ্রি লিস্টিং, শপিং বিজ্ঞাপন এবং লোকাল ইনভেন্টরি বিজ্ঞাপনে প্রদর্শিত হতে পারে।

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

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

মূল ধারণা

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

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

পূর্বশর্ত

মার্চেন্ট এপিআই ব্যবহার করে লয়্যালটি প্রোগ্রাম পরিচালনা করার আগে, নিশ্চিত করুন যে আপনি নিম্নলিখিত শর্তগুলো পূরণ করেছেন:

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

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

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 মেথডটি ব্যবহার করুন। প্রোগ্রামের বিবরণ, সাইনআপ ইউআরএল, এবং প্রোগ্রামের স্তর ও তাদের স্বতন্ত্র সুবিধা ও শর্তাবলীর মতো বিবরণ উল্লেখ করুন।

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

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

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} এর জায়গায় আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের অনন্য শনাক্তকারীটি বসান।

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

{
  "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 ব্যবহার করে আংশিক আপডেট করুন, অথবা মাস্কটি বাদ দিয়ে সম্পূর্ণ প্রতিস্থাপন করুন।

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

একটি 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}

সফল হলে, প্রতিক্রিয়া অংশটি খালি থাকে।

পরবর্তী পদক্ষেপ

পরবর্তী
Manage customer loyalty data