जब तक ज़्यादा जानकारी और सेगमेंट वाले डेटा का अनुरोध नहीं किया जाता, तब तक Search Ads 360 API सिर्फ़ एग्रीगेट किया गया डेटा दिखाता है. उदाहरण के लिए, किसी कीवर्ड रिपोर्ट के क्लिक कॉलम में, आपकी तय की गई समयसीमा के दौरान, किसी कीवर्ड को मिले क्लिक की कुल संख्या दिखती है.
| keywordText | keywordLandingPage | क्लिक |
|---|---|---|
| विजेट | http://www.example.com | 6000 |
हालांकि, अगर आपने किसी कीवर्ड रिपोर्ट का अनुरोध किया है जो तिमाही के हिसाब से सेगमेंट करती है, तो हर कीवर्ड के लिए आपको हर तिमाही के लिए एक लाइन दिखेगी. साथ ही, क्लिक कॉलम में तिमाही का कुल योग दिखेगा.
| keywordText | keywordLandingPage | quarterStart | quarterEnd | क्लिक |
|---|---|---|---|---|
| विजेट | http://www.example.com | 2012-01-01 | 2012-03-31 | 1000 |
| विजेट | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
| विजेट | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
| विजेट | http://www.example.com | 2012-10-01 | 2012-12-31 | 3000 |
ध्यान दें कि सेगमेंट की गई रिपोर्ट में कोई लाइन तब ही दिखती है, जब किसी सेगमेंट के लिए डेटा उपलब्ध हो.
उदाहरण के लिए, floodlightActivity कॉलम वाली कीवर्ड रिपोर्ट में, अगर रिपोर्ट की तारीख की सीमा के लिए कोई मेट्रिक एट्रिब्यूट नहीं की गई है,
तो रिपोर्ट में कीवर्ड और
Floodlight गतिविधि का जोड़ा नहीं दिखेगा.
कुछ सेगमेंट किसी खास कॉलम के साथ काम नहीं करते
कुछ सेगमेंट की वजह से, खास कॉलम से अमान्य डेटा दिख सकता है. उदाहरण के लिए, floodlightActivity के हिसाब से सेगमेंट में बांटने का मतलब सिर्फ़ तब होता है, जब उसे ऐसे कॉलम शामिल किए गए हों जो Floodlight
डेटा की रिपोर्ट करते हैं, जैसे कि dfaActions, dfaRevenue, dfaTransactions,
और dfaWeightedActions. दूसरी तरह के कन्वर्ज़न कॉलम (जैसे कि adWordsConversions) या ऐसे कॉलम जिनमें इंजन की मेट्रिक (जैसे, क्लिक और इंप्रेशन) को रिपोर्ट किया जाता है उनमें Floodlight से रिपोर्ट किया गया डेटा नहीं होता. इसलिए, अगर रिपोर्ट को floodlightActivity के हिसाब से सेगमेंट किया जाता है, तो अमान्य वैल्यू मिलती हैं.
सेगमेंट वाली रिपोर्ट के लिए अनुरोध करने का तरीका
सेगमेंट की गई रिपोर्ट का अनुरोध करने के लिए, ऐसा कॉलम शामिल करें जिसमें रिपोर्ट के टाइप रेफ़रंस में, segment के व्यवहार के तौर पर जानकारी दी गई हो.
नीचे दिया गया एसिंक्रोनस अनुरोध तिमाही के हिसाब से सेगमेंट की गई कीवर्ड रिपोर्ट के लिए है. हर लाइन के क्लिक कॉलम में, उस तिमाही में मिले क्लिक की कुल संख्या होगी:
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345" // Replace with your IDs
},
"reportType": "keyword",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "keywordText" },
{ "columnName": "keywordLandingPage" },
{ "columnName": "quarterStart" },
{ "columnName": "quarterEnd" },
{ "columnName": "clicks" },
]
"timeRange" : {
"startDate" : "2012-01-01",
"endDate" : "2012-12-31"
},
"downloadFormat": "csv",
"maxRowsPerFile": 5000000,
"statisticsCurrency": "agency",
"verifySingleTimeZone": false,
"includeRemovedEntities": false
}
एक से ज़्यादा सेगमेंट के लिए अनुरोध करना
एक अनुरोध में एक से ज़्यादा सेगमेंट कॉलम शामिल किए जा सकते हैं. निम्न पर ध्यान दें:
-
हमारा सुझाव है कि हफ़्ते, महीने या तिमाही के हिसाब से सेगमेंट करने पर, शुरू और खत्म, दोनों कॉलम शामिल करें. उदाहरण के लिए, तिमाही की किसी रिपोर्ट में,
quarterStartऔरquarterEnd, दोनों कॉलम शामिल करें. इन दोनों कॉलम को शामिल करने पर, अवधि के शुरू और खत्म होने की तारीख दिखेगी. इससे यह पुष्टि करने में मदद मिलेगी कि आपने हर पूरी अवधि का डेटा शामिल किया है. -
आप एक ही अनुरोध में अलग-अलग तरह के समय से जुड़े सेगमेंट शामिल नहीं कर सकते. उदाहरण के लिए, एक ही अनुरोध में, तिमाही और महीने के हिसाब से सेगमेंट नहीं किया जा सकता.
-
हर अतिरिक्त सेगमेंट के साथ, पंक्तियों की संख्या बहुत ज़्यादा बढ़ सकती है.