Search Ads 360 Reporting API के पुराने वर्शन को बंद किया जा रहा है. इसे 30 जून, 2024 को बंद कर दिया जाएगा. ध्यान दें कि Search Ads 360 Conversion API पर इसका कोई असर नहीं पड़ा है. साथ ही, यह पहले की तरह काम करता रहेगा. सभी नए रिपोर्टिंग डेवलपमेंट में, Search Ads 360 Reporting API के नए वर्शन का इस्तेमाल होना चाहिए.

अप्रैल 2024 से, रिपोर्ट का अनुरोध करते समय, काम न करने वाला ApiVersion गड़बड़ी दिखेगी. विवरण यहां देखें.

हमारा यह सुझाव भी है कि आप Search Ads 360 पर लागू होने वाले सभी मौजूदा वर्शन को एपीआई के नए वर्शन पर माइग्रेट करें. ज़्यादा जानकारी के लिए, Search Ads 360 Reporting API का नया वर्शन शुरू करने का तरीका और माइग्रेशन गाइड देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

समस्या निवारण करना

अगर आपको Search Ads 360 एपीआई का इस्तेमाल करते समय कोई समस्या आती है, तो इस समस्या को हल करने के सेक्शन को देखें.

अगर कोई समस्या है जिसे आप इस साइट पर दिए गए रिसॉर्स पढ़ने के बाद हल नहीं कर सकते हैं, तो सहायता टीम से संपर्क करें और यह जानकारी तैयार करें:

Search Ads 360 एजेंसी का आईडी और विज्ञापन देने वाले का आईडी जिसे आप ऐक्सेस करना चाहते हैं
Google API (एपीआई) कंसोल का प्रोजेक्ट नंबर
उस Google खाते का उपयोगकर्ता नाम जिसका इस्तेमाल आप एपीआई ऐक्सेस करने के लिए कर रहे हैं.
इस खाते को Search Ads 360 को ऐक्सेस करने की अनुमति दी गई है. यह वही खाता है जिसका इस्तेमाल अनुमति सेट अप करने के लिए किया जाता है.
आपके अनुरोध का कोड स्निपेट
JSON के रिस्पॉन्स
अगर जवाब कोई गड़बड़ी है, तो गड़बड़ी का मैसेज शामिल करना न भूलें. न कि सिर्फ़ संख्या वाला गड़बड़ी कोड.

प्राधिकरण त्रुटियां

यहां आम तौर पर, अनुमति से जुड़ी कुछ गड़बड़ियां मिली हैं:

मैसेज	ब्यौरा
`Access Not Configured. Please use Google API Console to activate the API for your project.`	यह गड़बड़ी तब होती है, जब आपने अपने खाते के लिए Search Ads 360 एपीआई को चालू न किया हो. पक्का करें कि आपने ये काम पूरे कर लिए हों: Google के एपीआई कंसोल पर जाएं. अपना प्रोजेक्ट चुनें. अगर आपने अब तक कोई प्रोजेक्ट नहीं बनाया है, तो अपने क्लाइंट के लिए प्रोजेक्ट बनाएं लेख पढ़ें. बाईं ओर साइडबार में, एपीआई और अनुमति को बड़ा करें. इसके बाद, एपीआई पर क्लिक करें. एपीआई की सूची में, पक्का करें कि Search Ads 360 एपीआई की स्थिति चालू हो.
`Invalid grant`	यह गड़बड़ी तब होती है, जब आपका रीफ़्रेश टोकन मान्य नहीं होता. आप नीचे दिए गए तरीके से, Search Ads 360 से जुड़ी यूटिलिटी स्क्रिप्ट को लागू करके, रीफ़्रेश टोकन पा सकते हैं: `sa360Api.py --login` अनुमति के लिए, सुझाए गए वर्कफ़्लो के बारे में ज़्यादा जानें.
`Invalid client no application name`	यह गड़बड़ी तब होती है, जब आपने Google API (एपीआई) कंसोल में प्रोजेक्ट को सेट अप करते समय, उसका नाम नहीं बताया होता है. इस गड़बड़ी को ठीक करने के लिए, Google API Console की सहमति वाली स्क्रीन पर अपने प्रॉडक्ट का नाम डालें.
अनुमति से जुड़ी दूसरी तरह की गड़बड़ियां	अपना क्लाइंट आईडी और क्लाइंट सीक्रेट फिर से पाने और रीफ़्रेश टोकन पाने के लिए, Google API (एपीआई) कंसोल में साइन इन करते समय उस Google खाते का इस्तेमाल करना न भूलें जिसे Search Ads 360 का ऐक्सेस दिया गया है.

कन्वर्ज़न अपलोड करने से जुड़ी गड़बड़ियां

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

गड़बड़ी का कोड	मैसेज	ब्यौरा
`0x00000101`	`Click ID '{ID}' is not found`	आपने `update` अनुरोध में जो क्लिक आईडी दिया है वह मान्य नहीं है. कन्वर्ज़न पूरा करने के बाद, कन्वर्ज़न को फिर से अपलोड करें: पुष्टि की गई कि क्लिक आईडी, कन्वर्ज़न अपलोड करने से चार घंटे पहले जनरेट किया गया था. एपीआई कन्वर्ज़न सेवा को चालू किया गया. अगर आपको खास विज़िट के लिए कन्वर्ज़न एट्रिब्यूट करना है, तो कन्वर्ज़न अपलोड करने से पहले, विज़िट के बाद कम से कम 30 मिनट इंतज़ार करें. अगर विज़िट के 30 मिनट बाद अपलोड किया जाता है, तो हो सकता है कि Search Ads 360, विज़िट के क्लिक आईडी की पहचान न कर पाए. कभी-कभी ऐसा हो सकता है कि आपको Search Ads 360 से क्लिक आईडी की पहचान करने में चार घंटे तक इंतज़ार करना पड़े. पुष्टि की गई कि क्लिक, मान्य पैरामीटर से लिया गया है जो `gclsrc` पैरामीटर से पता चलता है. पुष्टि की गई है कि आपने विज्ञापन देने वाले के आईडी वाले कॉलम में, विज्ञापन देने वाले के बारे में सही जानकारी दी है. पुष्टि करें कि आपका क्लिक आईडी पिछले 90 दिनों में जनरेट किया गया था.
`0x0000010E`	`Floodlight activity name '{name}' is not found`	`segmentationName` कॉलम में दी गई Floodlight गतिविधि का नाम गलत है या यह अब तक उपलब्ध नहीं है. अगर आपको यह गड़बड़ी दिखती है, तो सामान्य समस्याओं की जांच करें: नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं, इसलिए पक्का करें कि आपका अनुरोध केस से पूरी तरह मेल खाता हो. पक्का करें कि आपने Floodlight गतिविधि के नाम में, प्रिंट न किया जा सकने वाला यूनिकोड वर्ण या डबल स्पेस शामिल न किए हों. पक्का करें कि आपने Floodlight गतिविधि का नाम बताया है, न कि Floodlight कॉलम का. देखें कि विज्ञापन देने वाले के लिए, Floodlight गतिविधि मौजूद है. इसमें `advertiserId` कॉलम में बताया गया है. (यह संभव है कि आपने गलत विज्ञापनदाता बताया हो.) Floodlight गतिविधि बनाने या उसमें बदलाव करने के बाद, गतिविधि के लिए कन्वर्ज़न अपलोड करने से पहले कुछ घंटे इंतज़ार करें.
`0x00000115`	`Custom dimension '{name}' is not found`	पक्का करें कि आपके तय किए गए कस्टम Floodlight वैरिएबल को `clickId` के लिए, विज्ञापन देने वाले के लिए, मेट्रिक के बजाय डाइमेंशन के तौर पर सेट अप किया गया हो. इसे `clickId` के लिए, `criterionId` या `productGroupId` के तौर पर सेट किया गया है.
`0x00000116`	`Custom metric '{name}' is not found`	पक्का करें कि आपने जो कस्टम Floodlight वैरिएबल तय किया है उसे विज्ञापन देने वाले के लिए, मेट्रिक (डाइमेंशन नहीं) के तौर पर सेट अप किया गया है. इसे `clickId`, `criterionId` या `productGroupId` से जोड़ा जा रहा है, जिसे कन्वर्ज़न के लिए एट्रिब्यूट किया जा रहा है.
`0x0000011A`	`The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}`	किसी व्यक्ति ने पहले ही `conversionId` कॉलम में बताए गए, उसी दायरे और विज्ञापन देने वाले के कन्वर्ज़न आईडी के लिए, कन्वर्ज़न अपलोड कर लिया है. "विज्ञापन देने वाले का कन्वर्ज़न आईडी" वह आईडी होता है जो आप जनरेट करते हैं. Search Ads 360 के लिए यह ज़रूरी है कि दिए गए दायरे में, यह आईडी खास हो. Search Ads 360 कन्वर्ज़न आईडी, Search Ads 360 से जनरेट होता है. यह यूनीक होने की गारंटी देता है.
`0x0000011B`	`Advertiser conversion ID '{ID}' is not found`	आपके `update` के अनुरोध ने ऐसे विज्ञापन देने वाले का कन्वर्ज़न आईडी अपडेट करने की कोशिश की जो मौजूद नहीं है. पक्का करें कि आपने सही आईडी डाला हो.
`0x0000011D`	`User does not have permission to view advertiser {advertiser ID}`	आपका क्लाइंट जिस Google खाते का इस्तेमाल कर रहा है उसके पास अनुरोध में बताए गए विज्ञापन देने वाले को देखने की अनुमति नहीं है. अपना क्लाइंट आईडी और क्लाइंट सीक्रेट पाने के लिए, Google API (एपीआई) कंसोल में साइन इन करते समय और रीफ़्रेश टोकन मिलने पर, ऐसे Google खाते का इस्तेमाल करें जिसे आपने विज्ञापन देने वाले के पास, ऐक्सेस दिया हो.
`0x0000011F`	`Advertiser conversion ID is already specified in this request`	अनुरोध में दो या उससे ज़्यादा कन्वर्ज़न, एक ही दायरे और विज्ञापन देने वाले का कन्वर्ज़न आईडी बताते हैं. विज्ञापन देने वाले का कन्वर्ज़न आईडी, एक आईडी होता है, जिसे आप जनरेट करते हैं और जिसे `conversionId` कॉलम में बताते हैं. Search Ads 360 के लिए यह ज़रूरी है कि दिए गए दायरे के लिए, यह आईडी यूनीक हो.
`0x0000011E`	`The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)`	फ़्लडलाइट गतिविधि आईडी या दिया गया नाम, आपके बताए गए कन्वर्ज़न टाइप से मेल नहीं खाता.

जवाब कोड और गड़बड़ी के मैसेज की शिकायत करें

अगर किसी रिपोर्ट का अनुरोध करने पर आपको किसी गड़बड़ी का मैसेज मिलता है, तो गड़बड़ी के बारे में ज़्यादा जानकारी पाने के लिए, Search Ads 360 एपीआई में रिस्पॉन्स कोड और गड़बड़ी के स्टैंडर्ड मैसेज देखें.

Search Ads 360 यूज़र इंटरफ़ेस (यूआई) का डेटा, एपीआई की ओर से दी गई रिपोर्ट से मेल नहीं खाता

Search Ads 360 यूज़र इंटरफ़ेस (यूआई) का डेटा, डिफ़ॉल्ट रूप से एपीआई से मिले डेटा से मेल खाना चाहिए. अगर रिपोर्ट के अनुरोध में includeRemovedEntities को true पर सेट किया जाता है, तो पक्का करें कि हटाया गया दिखाएं चेकबॉक्स को यूज़र इंटरफ़ेस (यूआई) में भी चुना गया हो.