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

इस गाइड में, 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
  }
}

जवाबों के लिए ज़रूरी बातें

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

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

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

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

• खाता मिटाने की प्रोसेस पूरी हो गई है: अगर किसी ग्राहक के लिए, कारोबारी या कंपनी के साथ लॉयल्टी प्रोग्राम का मौजूदा खाता मिटाना है, तो ये शर्तें पूरी होनी चाहिए:
  • आपने Google उपयोगकर्ता को दिए गए userIdentifier से मैच किया हो
  • 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"
  }'

जवाब, पहले उदाहरण की तरह है. यह मैच और सहमति पर निर्भर करता है.

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

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

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

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 के यूज़र इंटरफ़ेस (यूआई) में, हमेशा अपने लॉयल्टी टियर के क्रम की पुष्टि करें. इससे यह पक्का किया जा सकेगा कि एपीआई कॉल में, TIER1 से TIER7 तक की एनम वैल्यू का सही इस्तेमाल किया जा रहा है. यह मैपिंग, यूज़र इंटरफ़ेस (यूआई) में तय किए गए क्रम के हिसाब से होती है, न कि उनके नामों के हिसाब से.

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