लॉयल्टी प्रोग्राम की खास जानकारी

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

Merchant API की मदद से, कारोबारी या कंपनियां और उनकी ओर से काम करने वाले तीसरे पक्ष के लॉयल्टी प्रोग्राम उपलब्ध कराने वाले लोग, LoyaltyProgramService का इस्तेमाल करके लॉयल्टी प्रोग्राम को प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए कॉन्फ़िगर और मैनेज कर सकते हैं. इस सेवा की मदद से, लॉयल्टी प्रोग्राम बनाए, वापस पाए, सूची में शामिल किए, अपडेट किए, और मिटाए जा सकते हैं.

अहम जानकारी: यह सेवा सिर्फ़ चुनिंदा कारोबारियों या कंपनियों के लिए उपलब्ध है. इस प्रोग्राम में शामिल होने के लिए, सहायता टीम से संपर्क करें. इसके लिए, Shopping API के सहायता फ़ॉर्म में जाकर, अनुमति वाली सूची में शामिल होने का अनुरोध सबमिट करें. यह फ़ॉर्म, समस्या/सवाल क्या है? > Allowlist request > Other.

कारोबार की ज़रूरी शर्तों और नीति के दिशा-निर्देशों के बारे में ज़्यादा जानने के लिए, Merchant Center के सहायता केंद्र में कारोबारी या कंपनी के लॉयल्टी प्रोग्राम के बारे में जानकारी लेख पढ़ें.

मुख्य सिद्धांत

लॉयल्टी प्रोग्राम का इस्तेमाल करते समय, इन बातों और सीमाओं का ध्यान रखें:

• खाते के लेवल पर आइडेंटिफ़ायर: Merchant API, लॉयल्टी प्रोग्राम की पहचान, Merchant Center खाते के आईडी के हिसाब से करता है.
• एक प्रोग्राम की सीमा: Merchant API की मदद से, कारोबारी या कंपनी के हर खाते के लिए सिर्फ़ एक लॉयल्टी प्रोग्राम सेट अप किया जा सकता है.
• खाते का सीधा मालिकाना हक: लॉयल्टी प्रोग्राम को सीधे तौर पर टारगेट किए गए कारोबारी खाते (accounts/{ACCOUNT_ID}) पर कॉन्फ़िगर किया जाना चाहिए. यह सेवा, उप-खातों के लिए ऐडवांस खाता लेवल पर लॉयल्टी प्रोग्राम मैनेज करने की सुविधा नहीं देती. तीसरे पक्ष की लॉयल्टी सेवा देने वाली कंपनियां, कारोबारी या कंपनी के खाते का ऐक्सेस पाकर, कारोबारी या कंपनी की ओर से प्रोग्राम को मैनेज कर सकती हैं.
• संपादकीय समीक्षा: लॉयल्टी प्रोग्राम बनाने या उसे अपडेट करने के बाद, प्रोग्राम की समीक्षा की जाती है. review_result.review_status फ़ील्ड से पता चलता है कि प्रोग्राम UNDER_REVIEW, APPROVED या REJECTED है.
• इन देशों/इलाकों में यह सुविधा उपलब्ध है: कारोबारी या कंपनी के लॉयल्टी प्रोग्राम, इन देशों में उपलब्ध हैं: ऑस्ट्रेलिया, ब्राज़ील, कनाडा, फ़्रांस, जर्मनी, भारत, इटली, मेक्सिको, नीदरलैंड्स, दक्षिण कोरिया, स्पेन, यूनाइटेड किंगडम, और अमेरिका.
• टियर से जुड़ी ज़रूरी शर्तें: टियर में शामिल होने के लिए, कोई शुल्क नहीं लिया जा सकता. इसके लिए, सदस्यता शुल्क देना पड़ सकता है. साथ ही, खर्च की सीमा तय करनी पड़ सकती है या कारोबारी या कंपनी के ब्रैंड वाले क्रेडिट कार्ड की ज़रूरत पड़ सकती है. पेशे के आधार पर तय किए गए टियर (जैसे, छात्र-छात्रा या सैनिक के लिए उपलब्ध टियर) इस्तेमाल नहीं किए जा सकते.
• फ़ायदे और सुविधाएं: प्रोग्राम में मुफ़्त शिपिंग, रिडीम किए जा सकने वाले पॉइंट, और सदस्यों के लिए तय की गई कीमत की सुविधा मिलती है. विज्ञापनों में, प्रोग्राम में शामिल सदस्यों के लिए उपलब्ध कीमत दिखाने के लिए, सामान्य कीमत या सेल वाली कीमत पर कम से कम 5% या 5 मुद्रा इकाइयों की छूट देना ज़रूरी है.

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

Merchant API की मदद से लॉयल्टी प्रोग्राम मैनेज करने से पहले, पक्का करें कि आपने ये ज़रूरी शर्तें पूरी की हों:

• आपके पास एक चालू Merchant Center खाता होना चाहिए. अगर आप तीसरे पक्ष की लॉयल्टी सेवा देने वाली कंपनी हैं, तो आपके पास कारोबारी या कंपनी के खाते का ऐक्सेस होना चाहिए.
• अपने खाते के लिए, लॉयल्टी प्रोग्राम का ऐड-ऑन चालू करें. इनमें से किसी एक विकल्प का इस्तेमाल करके, ऐड-ऑन चालू किया जा सकता है:
  • Merchant Center का यूज़र इंटरफ़ेस (यूआई): Merchant Center की सहायता टीम से संपर्क करें और लॉयल्टी प्रोग्राम सेट अप करें लेख में दिए गए निर्देशों का पालन करें.
  • Programs sub-API: प्रोग्राम को प्रोग्राम के हिसाब से चालू करें. इसके बारे में Programs sub-API में प्रोग्राम चालू करना लेख में बताया गया है.

Programs सब-एपीआई का इस्तेमाल करके, लॉयल्टी प्रोग्राम ऐड-ऑन चालू करने के लिए यहां अनुरोध का एक सैंपल दिया गया है:

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 तरीके का इस्तेमाल करें. प्रोग्राम के ब्यौरे, साइन अप करने का यूआरएल, और प्रोग्राम के टियर के बारे में जानकारी दें. साथ ही, उनके खास फ़ायदों और ज़रूरी शर्तों के बारे में भी बताएं.

ज़रूरी 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 पर लोगों को उनकी दिलचस्पी के हिसाब से नतीजे दिखाने के लिए, खरीदारों को अपने लॉयल्टी प्रोग्राम के टियर से जोड़ें. इसके लिए, लॉयल्टी कस्टमर मैच सर्विस की गाइड देखें.
• अपने खाते के लिए शॉपिंग प्रोग्राम चालू या बंद करने के लिए, प्रोग्राम सब-एपीआई गाइड देखें.
• कारोबार के सेटअप की जानकारी, संपादकीय नीतियां, और रिपोर्टिंग के बारे में जानने के लिए, Merchant Center के सहायता केंद्र में कारोबारी या कंपनी के लॉयल्टी प्रोग्राम के बारे में जानकारी लेख पढ़ें.
• एपीआई के तरीकों और संसाधन की परिभाषाओं के बारे में जानने के लिए, Merchant API का रेफ़रंस देखें.