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 Reporting API का नया वर्शन अब उपलब्ध है. एपीआई के नए वर्शन में, कस्टम रिपोर्ट बनाने और डेटा को रिपोर्टिंग ऐप्लिकेशन और प्रोसेस में इंटिग्रेट करने की सुविधा मिलती है. Search Ads 360 Reporting API के नए वर्शन पर माइग्रेट करने और उसका इस्तेमाल करने के बारे में ज़्यादा जानें.

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

सेव किए गए कॉलम की सूची पाएं

सेव किए गए ऐसे सभी कॉलम देखने के लिए जो विज्ञापन देने वाले ने बनाए हैं, SavedColumns.list() अनुरोध भेजें. जवाब में, विज्ञापन देने वाले के हर कॉलम के लिए savedColumnName शामिल होता है.

सेव किए गए कॉलम के लिए रिपोर्ट का अनुरोध करना

रिपोर्ट के अनुरोध में, सेव किए गए कॉलम को शामिल करने के लिए, एक ऐसा कॉलम जोड़ें जिसमें savedColumnName एट्रिब्यूट को कॉलम के नाम पर सेट किया गया हो:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

सेव किए गए कॉलम का इस्तेमाल करते समय, इन बातों का ध्यान रखें:

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