Search Ads 360 की क्वेरी लैंग्वेज की मदद से, Search Ads 360 Reporting API का इस्तेमाल करके, रिपोर्टिंग डेटा और संसाधन का मेटाडेटा पाने के लिए, खोज क्वेरी बनाई जा सकती हैं.
सेवाएं खोजना
Search Ads 360 क्वेरी लैंग्वेज का इस्तेमाल करके, एपीआई से क्वेरी की जा सकती है. इसके लिए, इनका इस्तेमाल किया जा सकता है:
SearchAds360Service
इस सेवा का इस्तेमाल करके, संसाधनों और उनसे जुड़े एट्रिब्यूट, सेगमेंट, और मेट्रिक के बारे में क्वेरी करें. इसके दो तरीके हैं,
Search
औरSearchStream
.SearchAds360Service
क्वेरी,SearchAds360Row
के इंस्टेंस की सूची दिखाती हैं:- हर लाइन किसी रिसॉर्स को दिखाती है.
- अनुरोध किए जाने पर, लाइनों में एट्रिब्यूट और मेट्रिक फ़ील्ड शामिल होते हैं.
- सेगमेंट का अनुरोध करने पर, हर सेगमेंट-रिसॉर्स टुपल के लिए अतिरिक्त पंक्तियां शामिल की जाती हैं.
ज़्यादा जानकारी के लिए, सर्च रिपोर्ट बनाना लेख देखें.
SearchAds360FieldService
उपलब्ध फ़ील्ड और संसाधनों के बारे में मेटाडेटा के लिए क्वेरी करने के लिए, इस सेवा का इस्तेमाल करें. यह सेवा, क्वेरी वाले फ़ील्ड का एक कैटलॉग उपलब्ध कराती है. इसमें, फ़ील्ड के साथ-साथ उनके टाइप और काम करने के तरीके के बारे में जानकारी भी दी जाती है.
SearchAds360FieldService
,SearchAds360Field
के इंस्टेंस की सूची दिखाता है:- हर फ़ील्ड में, अनुरोध किए गए फ़ील्ड के बारे में जानकारी होती है.
ज़्यादा जानने के लिए, संसाधन का मेटाडेटा वापस पाना लेख पढ़ें.
बुनियादी क्वेरी के उदाहरण
नीचे दिए गए सेक्शन में, क्वेरी के बुनियादी उदाहरण दिए गए हैं. इनका इस्तेमाल करके, अपनी क्वेरी बनाई जा सकती हैं.
किसी संसाधन के एट्रिब्यूट के लिए क्वेरी करना
यह campaign
रिसॉर्स के एट्रिब्यूट के लिए एक बुनियादी क्वेरी है, जो कैंपेन आईडी, नाम, और स्थिति दिखाती है:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- लौटाए गए हर
SearchAds360Row
में एकcampaign
ऑब्जेक्ट होता है. - पंक्तियों में चुने गए फ़ील्ड (इसमें दिए गए कैंपेन का
resource_name
भी शामिल है) अपने-आप भर जाते हैं. - कैंपेन आईडी के हिसाब से क्वेरी का क्रम.
क्वेरी में इस्तेमाल किए जा सकने वाले अन्य उपलब्ध फ़ील्ड के लिए, campaign
देखें.
मेट्रिक के लिए क्वेरी
यह campaign
संसाधन के एट्रिब्यूट से जुड़ी मेट्रिक के लिए बुनियादी क्वेरी है:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- क्वेरी से,
PAUSED
स्टेटस वाले और 1,000 से ज़्यादा इंप्रेशन वाले कैंपेन मिलते हैं. - दिखाए गए हर
SearchAds360Row
में, चुनी गई मेट्रिक से भराmetrics
फ़ील्ड होता है. - कैंपेन आईडी के हिसाब से क्वेरी का क्रम.
अपनी क्वेरी में इस्तेमाल की जा सकने वाली अन्य उपलब्ध मेट्रिक के लिए, metrics
देखें.
सेगमेंट के लिए क्वेरी
यह campaign
संसाधन के एट्रिब्यूट से जुड़े सेगमेंट के लिए बुनियादी क्वेरी है:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- क्वेरी से,
PAUSED
स्टेटस वाले और 1,000 से ज़्यादा इंप्रेशन वाले कैंपेन मिलते हैं. - यह डेटा को तारीख के हिसाब से सेगमेंट में बांटता है.
- सेगमेंटेशन की वजह से, हर
SearchAds360Row
किसी कैंपेन और तारीख के सेगमेंट के टुपल को दिखाता है. - कैंपेन आईडी के हिसाब से क्वेरी का क्रम.
अपनी क्वेरी में इस्तेमाल किए जा सकने वाले सेगमेंट की सूची के लिए, segments
देखें. साथ ही, अपनी रिपोर्ट को सेगमेंट में बांटने के बारे में ज़्यादा जानकारी के लिए, सेगमेंटेशन देखें.
मिलते-जुलते संसाधन के एट्रिब्यूट के लिए क्वेरी
यह campaign
रिसॉर्स पर एक बुनियादी क्वेरी है, जो उपलब्ध होने पर bidding_strategy
रिसॉर्स के एट्रिब्यूट को जोड़ती है. इस तरह के मिलते-जुलते संसाधन को एट्रिब्यूट किया गया संसाधन कहा जाता है.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- क्वेरी, चुने गए हर कैंपेन से कैंपेन एट्रिब्यूट और उनसे जुड़े एट्रिब्यूट चुनती है.
- दिखाया गया हर
SearchAds360Row
, चुने गए कैंपेन एट्रिब्यूट के साथ-साथ, बिडिंग की चुनी गई रणनीति के एट्रिब्यूट,bidding_strategy.name
से भरे हुएcampaign
ऑब्जेक्ट को दिखाता है.
कैंपेन क्वेरी के लिए, एट्रिब्यूट किए गए कौनसे संसाधन उपलब्ध हैं, यह जानने के लिए campaign
देखें.
फ़ील्ड मेटाडेटा के लिए क्वेरी
फ़ील्ड का मेटाडेटा पाने के लिए, SearchAds360FieldService
का इस्तेमाल किया जा सकता है.
फ़ील्ड मेटाडेटा के लिए यह एक बुनियादी क्वेरी है:
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- RESOURCE या FIELD को किसी संसाधन (जैसे,
customer
याcampaign
) या फ़ील्ड (जैसे,campaign.id
,metrics.impressions
याad_group.id
) से बदलें.
फ़ील्ड मेटाडेटा को वापस पाने के बारे में ज़्यादा जानने के लिए, संसाधन का मेटाडेटा वापस पाना लेख पढ़ें.
ज़्यादा जानें
Search Ads 360 Reporting API में क्वेरी बनाने के तरीके के बारे में ज़्यादा जानें: