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

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

खास जानकारी

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

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

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

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

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

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

तरीका: ManageLoyaltyCustomerMatch

ManageLoyaltyCustomerMatch तरीका, ग्राहक की लॉयल्टी से जुड़े असोसिएशन को मैनेज करने के लिए, मुख्य इंटरफ़ेस के तौर पर काम करता है. दिए गए इनपुट के आधार पर, सेवा अपने-आप तय करती है कि किसी ग्राहक के लॉयल्टी टियर की स्थिति को जोड़ना है, अपडेट करना है या हटाना है. यह कार्रवाई, एक ही अनुरोध को बार-बार भेजने पर भी एक ही नतीजे देती है: repeated identical requests have the same effect as a single request.

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

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"

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

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

LoyaltyTier ईनम वैल्यू

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

ManageLoyaltyCustomerMatch के रिस्पॉन्स के मुख्य हिस्से को समझना

The ManageLoyaltyCustomerMatch तरीका, a 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 उपयोगकर्ता को मैच करें
    • अनुरोध में loyaltyTier को NON_MEMBER पर सेट करें

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

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

उदाहरण

TIER1, कारोबारी के पहले तय किए गए टियर से मेल खाता है. इसे "बेसिक" कहा जाता है. वहीं, TIER2, दूसरे टियर से मेल खाता है. इसे "प्रीमियम" कहा जाता है

किसी ग्राहक को 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 UNAUTHENTICATED क्रेडेंशियल अमान्य हैं या मौजूद नहीं हैं.
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 के लिए मान्य ईनम वैल्यू नहीं है. अगर सिर्फ़ एक टियर उपलब्ध होने पर, 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 लाख अनुरोध और हर मिनट 10 हज़ार अनुरोध है. अपने कोटे की निगरानी और जांच करने का तरीका जानने के लिए, कोटे और सीमाएं लेख पढ़ें.

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

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

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

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