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

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

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

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

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

ज़रूरी एट्रिब्यूट 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 का रेफ़रंस देखें.