लॉयल्टी कस्टमर मैच सेवा के बारे में खास जानकारी

इस गाइड में, Merchant API में लॉयल्टी कस्टमर मैच सेवा इस्तेमाल करने का तरीका बताया गया है. इस सेवा की मदद से कारोबारी या कंपनियां, ग्राहक की लॉयल्टी से जुड़े डेटा को मैनेज कर सकती हैं. जैसे, उपयोगकर्ता के आइडेंटिफ़ायर और टियर की जानकारी. इससे उन्हें Google Search पर, लोगों की दिलचस्पी के हिसाब से खोज के नतीजे दिखाने में मदद मिलती है. इसके लिए, उन्हें Google Ads खाते की ज़रूरत नहीं होती.

खास जानकारी

लॉयल्टी डेटा अपलोड करने के लिए, लॉयल्टी कस्टमर मैच सेवा का इस्तेमाल करें. इसके बाद, इस डेटा का इस्तेमाल Google Search पर लॉयल्टी प्रोग्राम को मनमुताबिक बनाने की सुविधाओं को उपलब्ध कराने के लिए किया जाता है. जैसे, सदस्यों के लिए खास तौर पर तय की गई कीमत दिखाना. आपने ManageLoyaltyCustomerMatch कस्टम तरीके का इस्तेमाल करके, खरीदारों को लॉयल्टी प्रोग्राम के टियर से जोड़ा है. इससे आपको यूज़र आइडेंटिफ़ायर के आधार पर, खरीदारों के लॉयल्टी स्टेटस को जोड़ने, अपडेट करने या हटाने की सुविधा मिलती है.

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

  • यूनिफ़ाइड इंटरफ़ेस: ग्राहक के लॉयल्टी टियर की जानकारी जोड़ने, अपडेट करने या हटाने के लिए एक यूनीक एंडपॉइंट.
  • निजता को प्राथमिकता देने वाला डिज़ाइन: उपयोगकर्ता की निजता को सुरक्षित रखने और खाते की बिना अनुमति के जांच को रोकने के लिए, एपीआई GET या LIST कार्रवाइयों का समर्थन नहीं करता है. इससे यह पक्का होता है कि डेटा को बिना ऑडिट या वापस पाए मैनेज किया जाता है.
  • पहचान करने के कई विकल्प: कम से कम एक मान्य आइडेंटिफ़ायर का इस्तेमाल करके उपयोगकर्ताओं को मैच करें. जैसे, ईमेल पता, घर का पता या फ़ोन नंबर.
  • सहमति के आधार पर प्रोसेसिंग: यह सेवा, खरीदार के डेटा को सिर्फ़ तब सेव और इस्तेमाल करती है, जब असली उपयोगकर्ता ने Google को ज़रूरी सहमति दी हो. खाते की पहचान या सहमति की स्थिति की जांच से बचाने के लिए, अगर कोई मैच नहीं मिलता है या सहमति नहीं दी जाती है, तो सेवा चुपचाप तरीके से सफलता का मैसेज दिखाती है.

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

लॉयल्टी कस्टमर मैच सेवा का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी करें:

  • खाता सेटअप करना: पक्का करें कि आपका Merchant Center खाता चालू हो. लॉयल्टी कस्टमर मैच सेवा का इस्तेमाल करने के लिए, आपको Google Ads खाता बनाने की ज़रूरत नहीं है.
  • लॉयल्टी प्रोग्राम कॉन्फ़िगरेशन: अपने Merchant Center खाते में लॉयल्टी प्रोग्राम चालू करें. साथ ही, पक्का करें कि आपने लॉयल्टी टियर तय किए हों.
  • टियर के क्रम के बारे में जानकारी: Merchant Center के यूज़र इंटरफ़ेस (यूआई) में, लॉयल्टी टियर के क्रम के बारे में जानकारी रखें. एपीआई, इस सटीक क्रम का इस्तेमाल अपने एनम मैपिंग के लिए करता है.

तरीका: ManageLoyaltyCustomerMatch

ManageLoyaltyCustomerMatch तरीके का इस्तेमाल, ग्राहक की लॉयल्टी से जुड़ी असोसिएशनशिप को मैनेज करने के लिए किया जाता है. उपयोगकर्ता से मिले इनपुट के आधार पर, यह सेवा अपने-आप यह तय करती है कि किसी खरीदार के लॉयल्टी टियर की स्थिति को डालना है, अपडेट करना है या हटाना है. यह ऑपरेशन आईडम्पोटेंट है: एक जैसे अनुरोधों को बार-बार करने से, एक ही अनुरोध का असर होता है.

यहां दिए गए अनुरोध में, एपीआई के ज़रिए ग्राहकों के लॉयल्टी प्रोग्राम के असोसिएशन मैनेज करने का तरीका दिखाया गया है:

POST https://merchantapi.googleapis.com/{api_version}/accounts/{account_id}/loyaltyCustomers:manage

इस अनुरोध में, पाथ के लिए ज़रूरी इन पैरामीटर के बारे में बताया गया है:

  • api_version: एपीआई वर्शन, जैसे कि v1.
  • account_id: Merchant Center खाते का आईडी.

अनुरोध के मुख्य हिस्से में loyaltyCustomer ऑब्जेक्ट शामिल करें.

{
    "userIdentifier": {
      "emailAddress": "string",
      "address": {
        "addressLines": ["string"],
        "locality": "string",
        "administrativeArea": "string",
        "postalCode": "string",
        "regionCode": "string"
      },
      "phoneNumber": "string"
    },
    "loyaltyTier": "LoyaltyTier",
    "pointBalance": "integer"
  }

loyaltyCustomer फ़ील्ड

  • userIdentifier: यह आइडेंटिफ़ायर का वह सेट होता है जिसका इस्तेमाल, ग्राहक को मैच करने के लिए किया जाता है. userIdentifier में कम से कम एक फ़ील्ड की वैल्यू देना ज़रूरी है. साथ ही, वह वैल्यू मान्य होनी चाहिए.
  • loyaltyTier: ग्राहक से जोड़ने के लिए लॉयल्टी टियर. यह Merchant Center में टियर के सेटअप के क्रम से मैप होता है. ज़्यादा जानकारी के लिए, loyaltyTier मैपिंग के बारे में जानकारी लेख पढ़ें. किसी मौजूदा असोसिएशन को हटाने के लिए, NON_MEMBER का इस्तेमाल करें.
  • pointBalance: ग्राहक के मौजूदा पॉइंट का बैलेंस.

userIdentifier फ़ील्ड

इन फ़ील्ड में से कम से कम एक फ़ील्ड की वैल्यू देना ज़रूरी है:

  • emailAddress: खरीदार का ईमेल पता.
  • address: खरीदार का पता. PostalCode डालना ज़रूरी है.
  • phoneNumber: खरीदार का फ़ोन नंबर. E.164 फ़ॉर्मैट का इस्तेमाल करने का सुझाव दिया जाता है.

loyaltyTier मैपिंग को समझना

एपीआई, कस्टम नामों का इस्तेमाल नहीं करता है. loyaltyTier ईनम वैल्यू (TIER1 से TIER7 तक) सिमैंटिक लेबल हैं. ये Merchant Center के यूज़र इंटरफ़ेस (यूआई) में असाइन किए गए कस्टम नामों (जैसे, "गोल्ड रीवार्ड") या कस्टम लेबल (जैसे, "gold_tier") का इस्तेमाल नहीं करते. इसके बजाय, वे उस क्रम में मैप किए जाते हैं जिस क्रम में आपने Merchant Center में लॉयल्टी प्रोग्राम की सेटिंग में अपने टियर तय किए हैं:

  • TIER1: यह Merchant Center में कॉन्फ़िगर किए गए लॉयल्टी प्रोग्राम में शामिल पहले टियर से मेल खाता है.
  • TIER2: यह Merchant Center में कॉन्फ़िगर किए गए लॉयल्टी प्रोग्राम में शामिल दूसरे टियर से मेल खाता है.
  • TIER3 से TIER7 तक: ये Merchant Center में लॉयल्टी प्रोग्राम के कॉन्फ़िगरेशन में लिस्ट किए गए तीसरे से सातवें टियर के लिए होते हैं.

उदाहरण:

अगर आपके Merchant Center लॉयल्टी प्रोग्राम में टियर इस क्रम में तय किए गए हैं:

  1. टियर का नाम: "सिल्वर स्टेटस", टियर का लेबल: "silver"
  2. टियर का नाम: "गोल्ड मेंबर", टियर का लेबल: "gold"
  3. टियर का नाम: "Platinum Elite", टियर का लेबल: "platinum"

इसके बाद, accounts.loyaltyCustomers.manage एपीआई कॉल में जाकर:

  • किसी ग्राहक को "सिल्वर स्टेटस" असाइन करने के लिए, आपको loyaltyTier: TIER1 का इस्तेमाल करना होगा.
  • किसी ग्राहक को "गोल्ड मेंबर" के तौर पर असाइन करने के लिए, आपको loyaltyTier: TIER2 का इस्तेमाल करना होगा.
  • किसी ग्राहक को "प्लैटिनम एलिट" टियर असाइन करने के लिए, आपको loyaltyTier: TIER3 का इस्तेमाल करना होगा.

LoyaltyTier enum वैल्यू

  • TIER1
  • TIER2
  • TIER3
  • TIER4
  • TIER5
  • TIER6
  • TIER7
  • NON_MEMBER (इसका इस्तेमाल, ग्राहक के लॉयल्टी प्रोग्राम से जुड़े खाते को हटाने के लिए किया जाता है)

ManageLoyaltyCustomerMatch के जवाब के मुख्य हिस्से को समझना

ManageLoyaltyCustomerMatch तरीका, ManageLoyaltyCustomerMatchResponse ऑब्जेक्ट दिखाता है:

{
  "loyaltyCustomer": {
    // loyaltyCustomer object from the request
  }
}

संभावित जवाबों के बारे में ज़रूरी बातें:

  • अपसर्ट (डेटा सेव किया गया) की प्रोसेस पूरी हुई: किसी ग्राहक के लॉयल्टी टियर के जुड़ाव को सेव करने या अपडेट करने के लिए, इन शर्तों को पूरा करें:

    • आपने दिए गए userIdentifier का इस्तेमाल करके, किसी Google उपयोगकर्ता को मैच किया हो
    • आपने अनुरोध में loyaltyTier को NON_MEMBER के अलावा किसी मान्य वैल्यू पर सेट किया हो
    • मैच किए गए उपयोगकर्ता ने लॉयल्टी डेटा के इस्तेमाल के लिए सहमति दी हो

जवाब में, आपके अनुरोध से मिला loyaltyCustomer ऑब्जेक्ट शामिल होता है. इससे पता चलता है कि डेटा को प्रोसेस कर लिया गया है और उसे सेव कर लिया गया है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
     "emailAddress": "customer@example.com"
    },
    "loyaltyTier": "TIER2",
    "pointBalance": 1500
    }
}
  • लॉयल्टी प्रोग्राम से जुड़ा डेटा मिटाना: अगर आपको किसी खरीदार के लिए, कारोबारी या कंपनी के लॉयल्टी प्रोग्राम से जुड़ा मौजूदा डेटा मिटाना है, तो आपको ये शर्तें पूरी करनी होंगी:
    • आपने दिए गए userIdentifier का इस्तेमाल करके, Google उपयोगकर्ता को मैच किया हो
    • NON_MEMBER को किए गए अनुरोध में, आपने loyaltyTier सेट किया हो

रिस्पॉन्स, एक खाली JSON ऑब्जेक्ट है:

{}
  • कोई मैच नहीं मिला / सहमति नहीं दी गई (साइलेंट सक्सेस): अगर दिया गया userIdentifier, किसी Google खाते से मैच नहीं होता है या मैच किए गए उपयोगकर्ता ने लॉयल्टी डेटा के इस्तेमाल की सहमति नहीं दी है, तो एपीआई, HTTP 200 OK स्टेटस दिखाता है. साथ ही, एक खाली JSON ऑब्जेक्ट दिखाता है: {}. ऐसा इंसर्ट करने और हटाने, दोनों के लिए होता है.

उदाहरण

TIER1 का मतलब कारोबारी या कंपनी के पहले टियर से है, जिसे "Basic" कहा जाता है. वहीं, TIER2 का मतलब दूसरे टियर से है, जिसे "Premium" कहा जाता है

किसी ग्राहक को TIER2 में जोड़ने या ईमेल पते का इस्तेमाल करके उसकी स्थिति अपडेट करने के लिए, यह अनुरोध भेजें:

POST
"https://merchantapi.googleapis.com/v1/accounts/{account_id}/loyaltyCustomers:manage"
  -d '{
      "userIdentifier": {
        "emailAddress": "customer@example.com"
      },
      "loyaltyTier": "TIER2",
      "pointBalance": 1500
  }'

जब किसी उपयोगकर्ता का डेटा मैच हो जाता है और उसने सहमति दे दी होती है, तो एपीआई यह रिस्पॉन्स देता है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "emailAddress": "customer@example.com"
    },
    "loyaltyTier": "TIER2",
    "pointBalance": 1500
  }
}

अगर कोई मैच नहीं मिलता है या उपयोगकर्ता ने सहमति नहीं दी है, तो एपीआई यह जवाब देता है:

{}

फ़ोन नंबर का इस्तेमाल करके, किसी खरीदार के लॉयल्टी प्रोग्राम से जुड़ाव को हटाने के लिए, यह अनुरोध भेजें:

POST
"https://merchantapi.googleapis.com/v1/accounts/{account_id}/loyaltyCustomers:manage" \
  -d '{
      "userIdentifier": {
        "phoneNumber": "+18005550132"
      },
      "loyaltyTier": "NON_MEMBER"
  }'

रिकॉर्ड मौजूद था या नहीं, इससे कोई फ़र्क़ नहीं पड़ता. एपीआई, यहां दिया गया जवाब देता है:

{}

एक से ज़्यादा आइडेंटिफ़ायर का इस्तेमाल करके किसी ग्राहक को जोड़ने या अपडेट करने के लिए, यह अनुरोध भेजें:

POST
"https://merchantapi.googleapis.com/v1/accounts/{account_id}/loyaltyCustomers:manage" \
  -d '{
      "userIdentifier": {
        "emailAddress": "user@example.com",
        "address": {
          "postalCode": "94043",
          "regionCode": "US"
        }
      },
      "loyaltyTier": "TIER1"
  }'

जवाब, पहले उदाहरण जैसा ही है. यह इस बात पर निर्भर करता है कि क्वेरी, डेटा से कितनी मिलती-जुलती है और उपयोगकर्ता ने डेटा ऐक्सेस करने की सहमति दी है या नहीं.

गड़बड़ी ठीक करना

एपीआई, स्टैंडर्ड एचटीटीपी कोड का इस्तेमाल करता है. गड़बड़ी के मैसेज में आम तौर पर ये स्ट्रिंग शामिल होती हैं:

एचटीटीपी कोड गड़बड़ी की स्ट्रिंग ब्यौरा
400 INVALID_ARGUMENT user_identifier या loyalty_tier एट्रिब्यूट की वैल्यू मौजूद नहीं है या आइडेंटिफ़ायर खाली है.
401 प्रमाणीकरण नहीं किया गया क्रेडेंशियल अमान्य हैं या मौजूद नहीं हैं.
403 PERMISSION_DENIED जिस उपयोगकर्ता की पुष्टि की गई है उसके पास, बताए गए Merchant Center खाते का ऐक्सेस नहीं है.
404 NOT_FOUND आपने जो लॉयल्टी टियर लेबल दिया है वह आपके कॉन्फ़िगरेशन में मौजूद नहीं है.
412 FAILED_PRECONDITION आपने अपने खाते में लॉयल्टी प्रोग्राम कॉन्फ़िगर नहीं किया है.
429 RESOURCE_EXHAUSTED कोटे की तय सीमा पूरी हो गई है.

गड़बड़ी के उदाहरण

404 NOT_FOUND: के लिए उदाहरण

किसी ऐसे खाता आईडी के लिए मान्य अनुरोध जिसमें लॉयल्टी प्रोग्राम कॉन्फ़िगर नहीं किया गया है.

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 404,
    "message": "The loyalty program is not found for account: {account_id}.",
    "status": "NOT_FOUND",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "notFound",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "ACCOUNT_ID": "{account_id}",
          "REASON": "NOT_FOUND_LOYALTY_PROGRAM"
        }
      }
    ]
  }
}

वजह: पाथ में मौजूद कारोबारी या कंपनी के खाते में, लॉयल्टी प्रोग्राम चालू नहीं है.

400 INVALID_ARGUMENT: के उदाहरण

अगर अनुरोध में loyaltyTier फ़ील्ड के लिए अमान्य वैल्यू शामिल है, तो गड़बड़ी होती है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "emailAddress": "customer@example.com"
    },
    "loyaltyTier": "TIER11",
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "Invalid value at 'loyalty_customer.loyalty_tier' (type.googleapis.com/google.shopping.merchant.loyaltycustomers.v1.LoyaltyCustomer.LoyaltyTier), \"TIER11\"",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "loyalty_customer.loyalty_tier",
            "description": "Invalid value at 'loyalty_customer.loyalty_tier' (type.googleapis.com/google.shopping.merchant.loyaltycustomers.v1.LoyaltyCustomer.LoyaltyTier), \"TIER11\""
          }
        ]
      }
    ]
  }
}

वजह: TIER11, loyaltyTier के लिए मान्य enum वैल्यू नहीं है. अगर सिर्फ़ एक टियर उपलब्ध है और आपने TIER2 तय किया है, तो भी यही गड़बड़ी हो सकती है.

अनुरोध के मुख्य हिस्से में ज़रूरी loyaltyTier फ़ील्ड मौजूद न होने पर, यह गड़बड़ी होती है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "emailAddress": "customer@example.com"
    },
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "[loyalty_customer.loyalty_tier] Required field not provided: loyalty_customer.loyalty_tier",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "required",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "FIELD_LOCATION": "loyalty_customer.loyalty_tier",
          "REASON": "MISSING_REQUIRED_FIELD"
        }
      }
    ]
  }
}

वजह: loyaltyTier फ़ील्ड को भरना ज़रूरी है.

अगर पते का आइडेंटिफ़ायर अधूरा है, तो गड़बड़ी होती है. जैसे, जब postalCode फ़ील्ड मौजूद नहीं होता है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "address": {
        "locality": "Sunnyvale",
        "administrativeArea": "CA",
        "regionCode": "US"
      }
    },
    "loyaltyTier": "TIER1",
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "[loyalty_customer.user_identifier] The format of loyalty_customer.user_identifier does not match the expected format ... Value: at least one valid user identifier should be provided.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "invalid",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "FIELD_NAME": "loyalty_customer.user_identifier",
          "REASON": "INVALID_VALUE"
        }
      }
    ]
  }
}

वजह: पता दिया गया है, लेकिन इसमें ज़रूरी postalCode फ़ील्ड मौजूद नहीं है. इसलिए, इसे मान्य आइडेंटिफ़ायर नहीं माना जाता.

अगर आपने कॉन्फ़िगर किए गए प्रोग्राम के लिए, सीमा से बाहर के टियर इंडेक्स का अनुरोध किया है, तो गड़बड़ी होती है:

स्थिति: कारोबारी या कंपनी ने Merchant Center में सिर्फ़ एक टियर कॉन्फ़िगर किया है.

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "emailAddress": "customer@example.com"
    },
    "loyaltyTier": "TIER2",
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "[loyalty_customer.loyalty_tier] The format of loyalty_customer.loyalty_tier does not match the expected format `valid LoyaltyTier`. Value: TIER2.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "invalid",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "FIELD_NAME": "loyalty_customer.loyalty_tier",
          "PATTERN": "valid LoyaltyTier",
          "FIELD_VALUE": "TIER2",
          "REASON": "INVALID_VALUE"
        }
      }
    ]
  }
}

वजह: TIER2 का अनुरोध किया गया है, लेकिन खाते से लिंक किए गए लॉयल्टी प्रोग्राम में दूसरा टियर तय नहीं किया गया है.

अगर अनुरोध में गलत तरीके से बनाया गया emailAddress शामिल है, तो गड़बड़ी होती है:

{
  "loyaltyCustomer": {
    "userIdentifier": {
      "emailAddress": "customer@google"
    },
    "loyaltyTier": "TIER1",
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "[loyalty_customer.user_identifier] The format of loyalty_customer.user_identifier does not match the expected format `email_address: \t \"customer@google\"\n`. Value: at least one valid user identifier should be provided.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "invalid",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "FIELD_NAME": "loyalty_customer.user_identifier",
          "REASON": "INVALID_VALUE"
        }
      }
    ]
  }
}

वजह: ईमेल पते का फ़ॉर्मैट अमान्य है.

अगर userIdentifier ऑब्जेक्ट खाली है, तो गड़बड़ी होती है:

{
  "loyaltyCustomer": {
    "userIdentifier": {},
    "loyaltyTier": "TIER1",
    "pointBalance": 100
  }
}

एपीआई, गड़बड़ी का यह जवाब दिखाता है:

{
  "error": {
    "code": 400,
    "message": "[loyalty_customer.user_identifier] Required field not provided: loyalty_customer.user_identifier",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "required",
        "domain": "merchantapi.googleapis.com",
        "metadata": {
          "FIELD_LOCATION": "loyalty_customer.user_identifier",
          "REASON": "MISSING_REQUIRED_FIELD"
        }
      }
    ]
  }
}

वजह: userIdentifier ऑब्जेक्ट मौजूद है, लेकिन इसमें कोई असली पहचानकर्ता फ़ील्ड नहीं है.

आइडेंटिफ़ायर की पुष्टि करने के बारे में जानकारी:

  • एपीआई, आइडेंटिफ़ायर के फ़ॉर्मैट की बुनियादी जांच करता है. उदाहरण के लिए, ईमेल का स्ट्रक्चर, पतों में postalCode की मौजूदगी.
  • हालांकि, शुरुआती जांच में पास होने वाले कुछ आइडेंटिफ़ायर, किसी भी Google उपयोगकर्ता खाते से मेल नहीं खाते. इसके अलावा, ऐसा भी हो सकता है कि वे बैकएंड मैचिंग सिस्टम के पहचाने गए फ़ॉर्मैट में न हों. ऐसे मामलों में, आपको साइलेंट सक्सेस का खाली जवाब {} मिलेगा. साथ ही, एचटीटीपी स्टेटस 200 OK मिलेगा.

सबसे सही तरीके

अपने इंटिग्रेशन को ऑप्टिमाइज़ करने के लिए, इन सबसे सही तरीकों को अपनाएं.

  • बड़े पैमाने पर इंटिग्रेशन के लिए: एपीआई, हर अनुरोध के आधार पर काम करता है. इसलिए, बड़े डेटासेट के लिए ज़रूरी थ्रूपुट पाने के लिए, क्लाइंट-साइड पैरललिज़्म ज़रूरी है. आपको इंटिग्रेशन को इस तरह से डिज़ाइन करना चाहिए कि एक साथ कई अनुरोधों को मैनेज किया जा सके. साथ-साथ लोड होने की सुविधा का इस्तेमाल करके, ज़्यादा वॉल्यूम को मैनेज करने के लिए, अपने इंटिग्रेशन को स्ट्रक्चर करने के बारे में जानकारी पाने के लिए, एक साथ कई अनुरोध भेजने का तरीका जानने के लिए हमारी गाइड पढ़ें.

  • कोटा मैनेजमेंट: डिफ़ॉल्ट कोटा 10,00,000 अनुरोध/दिन और 10,000 अनुरोध/मिनट है. अपने कोटे को मॉनिटर और उनकी जांच करने का तरीका जानने के लिए, कोटे और सीमाएं लेख पढ़ें.

  • ईमेल पते को प्राथमिकता दें: जब भी हो सके, userIdentifier में खरीदार का emailAddress शामिल करें. ईमेल पते आम तौर पर, उपयोगकर्ताओं को उनके Google खातों से मैच करने के लिए सबसे सटीक और भरोसेमंद आइडेंटिफ़ायर होते हैं.

  • खाली जवाबों को मैनेज करें: अपने ऐप्लिकेशन को इस तरह से डिज़ाइन करें कि वह खाली {} जवाबों को सही तरीके से समझ सके. यह समझें कि इसका मतलब है कि निजता की वजहों से डेटा सेव नहीं किया गया है (कोई मैच नहीं मिला या सहमति नहीं मिली). अनुरोध को फिर से न भेजें.

  • टियर के क्रम की पुष्टि करें: Merchant Center के यूज़र इंटरफ़ेस (यूआई) में, लॉयल्टी टियर के क्रम की हमेशा पुष्टि करें. इससे यह पक्का किया जा सकेगा कि एपीआई कॉल में, TIER7 एनम वैल्यू के ज़रिए सही TIER1 का इस्तेमाल किया जा रहा है. यह मैपिंग, यूज़र इंटरफ़ेस (यूआई) में तय किए गए क्रम के हिसाब से होती है, न कि उनके नामों के हिसाब से.

  • गड़बड़ियों पर नज़र रखें: एपीआई के जवाबों को लॉग करें और उन पर नज़र रखें. साथ ही, इंटिग्रेशन से जुड़ी समस्याओं का पता लगाने के लिए, 4xx गड़बड़ियों पर ध्यान दें. खास तौर पर, 404 गड़बड़ियों पर ध्यान दें, जिनसे टियर के बारे में गलत जानकारी मिलने का पता चल सकता है.