ग्राहक सूची से जुड़ी समस्याओं को हल करना

इस गाइड का इस्तेमाल करके, कम मैच रेट और कस्टमर मैच इंटिग्रेशन में आने वाली सामान्य गड़बड़ियों को ठीक करें.

मैच रेट की पुष्टि करना

मैच रेट की पुष्टि करने से पहले, पक्का करें कि अपलोड करने का काम पूरा हो गया हो.

कई वजहों से, आपका मैच रेट उम्मीद से कम हो सकता है. जैसे:

  • डेटा को अपलोड करने से पहले हैश नहीं किया गया था.
  • डेटा को हैश करने से पहले, उसे सही तरीके से फ़ॉर्मैट नहीं किया गया था.
  • आपने किसी दूसरे सिस्टम में मौजूद मैच रेट से तुलना की है.
  • आपने एक ही UserIdentifier ऑब्जेक्ट में कई उपयोगकर्ता आइडेंटिफ़ायर जोड़ने की कोशिश की है. इसके बजाय, एक UserData ऑब्जेक्ट में कई UserIdentifier ऑब्जेक्ट जोड़ें. जैसा कि इस कोड के उदाहरण में दिखाया गया है.

विज्ञापन देने वाला व्यक्ति या कंपनी, अपनी सूची में शामिल लोगों में से 1% से लेकर 99% तक लोगों तक पहुंच सकती है. यह इस बात पर निर्भर करता है कि Google Search, Gmail या YouTube पर उसके उपयोगकर्ता कितने सक्रिय हैं. कम मैच रेट की समस्या हल करने के बारे में ज़्यादा जानकारी के लिए, सहायता केंद्र पर जाएं.

मैच रेट और सूची के साइज़ में अंतर

सूची के साइज़ और मैच रेट में अलग-अलग वैल्यू दिखती हैं. मैच रेट में, Google खाता इस्तेमाल करने वाले सभी लोगों को शामिल किया जाता है. भले ही, कस्टमर मैच के लिए सूची के ज़रिए उन तक न पहुंचा जा सके. सूची के साइज़ में, उन सक्रिय उपयोगकर्ताओं को शामिल किया जाता है जिनका Google खाता मैच हुआ है. साथ ही, उन्हें दिलचस्पी के मुताबिक विज्ञापन दिखाए जा सकते हैं.

आम तौर पर होने वाली गड़बड़ियों को डीबग करना

गड़बड़ी
USER_PERMISSION_DENIED अगर किसी ऐसी सूची में बदलाव करने की कोशिश की जाती है जिसे किसी दूसरे खाते से बनाया गया है, तो आपको अनुमतियों से जुड़ी गड़बड़ियां दिख सकती हैं. सिर्फ़ उस सूची में बदलाव किया जा सकता है जिसे आपने बनाया है.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS एक ही external_id का इस्तेमाल करके कई जॉब बनाने की कोशिश करने पर, यह गड़बड़ी हो सकती है.
CONFLICTING_OPERATION यह गड़बड़ी तब हो सकती है, जब एक ही जॉब में remove और create ऑपरेशनों को एक साथ इस्तेमाल किया गया हो.
TOO_MANY_USER_IDENTIFIERS एक जॉब में create कार्रवाइयों में कुल 1,00,000 से ज़्यादा user_identifiers शामिल हैं. अनुरोध को कई हिस्सों में बांटें, ताकि वह तय सीमा से ज़्यादा न हो.
CONCURRENT_MODIFICATION यह गड़बड़ी तब हो सकती है, जब एक ही सूची पर एक साथ कार्रवाई करने की कोशिश की जाए.
RESOURCE_EXHAUSTED यह गड़बड़ी तब हो सकती है, जब बहुत ज़्यादा अनुरोध भेजे जाते हैं. सुझाए गए इस्तेमाल के फ़्लो के हिसाब से, कार्रवाइयों को बैच में करके इस समस्या को कम किया जा सकता है. एपीआई की सीमाओं और कोटे के बारे में सबसे सही तरीके जानने के लिए, गाइड देखें.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE यह गड़बड़ी तब होती है, जब आपके Google Cloud प्रोजेक्ट (या लेगसी डेवलपर टोकन, जिसे 9 सितंबर, 2026 को बंद कर दिया गया था) में 1 अक्टूबर, 2025 से 31 मार्च, 2026 के बीच, ग्राहक मिलान के लिए कोई अनुरोध नहीं किया गया हो. आपको कस्टमर मैच के वर्कफ़्लो के लिए, Data Manager API का इस्तेमाल करना होगा.

समस्या हल करने के लिए अतिरिक्त सहायता

अगर आपको अब भी समस्याएं आ रही हैं, तो कस्टमर मैच समस्या हल करने वाले टूल का इस्तेमाल करके हमसे संपर्क करें.