Search Ads 360 Reporting API में खोज रिपोर्ट बनाना

Search Network में दिखने वाले विज्ञापनों में खोज रिपोर्ट बनाने का तरीका जानने के लिए, नीचे दिए गए सेक्शन पढ़ें 360 Reporting API.

सेवा खोजें

Search Ads 360 Reporting API, Search Ads 360 Reporting API की मदद से रिपोर्टिंग.

SearchAds360Service, एक ही जगह पर ऑब्जेक्ट वापस पाने और रिपोर्टिंग सेवा है इसमें खोज के दो तरीके होते हैं: SearchStream और Search. खोजें हैं Search Ads 360 की क्वेरी भाषा में लिखी गई क्वेरी स्ट्रिंग में पास की जाती है. क्वेरी को इन कामों के लिए तय किया जा सकता है:

  • ऑब्जेक्ट के खास एट्रिब्यूट वापस पाना.
  • तारीख की सीमा के आधार पर ऑब्जेक्ट के लिए परफ़ॉर्मेंस मेट्रिक फिर से पाएं.
  • ऑब्जेक्ट को उनकी विशेषताओं के आधार पर क्रम से लगाएं.
  • अपने नतीजों को उन शर्तों का इस्तेमाल करके फ़िल्टर करें जिनसे पता चलता है कि कौनसे ऑब्जेक्ट दिखाए जाने हैं
  • लौटाए गए ऑब्जेक्ट की संख्या सीमित करें.

खोज के दोनों तरीके, आपकी क्वेरी से मेल खाने वाली सभी लाइनें दिखाते हैं. उदाहरण के लिए, जब campaign.id, campaign.name, और metrics.clicks को वापस पाने का अनुरोध करने पर, एपीआई SearchAds360Row में एक कैंपेन ऑब्जेक्ट है, जिसमें id और name फ़ील्ड हैं सेट है और एक metrics ऑब्जेक्ट है, जिसमें clicks फ़ील्ड सेट मौजूद है.

खोज के तरीके

SearchStream

सिर्फ़ एक अनुरोध भेजता है और स्थायी कनेक्शन शुरू करता है रिपोर्ट का साइज़ चाहे जो भी हो.

  • पूरे नतीजे के साथ डेटा पैकेट तुरंत डाउनलोड होना शुरू हो जाते हैं डेटा बफ़र में कैश मेमोरी में सेव किया जाता है.
  • आपका कोड बिना इंतज़ार किए बफ़र किए गए डेटा को पढ़ना शुरू कर सकता है पूरी स्ट्रीम को खत्म करना है.
Search

पूरी रिपोर्ट डाउनलोड करने के लिए, पेजों में कई नंबर वाले कई अनुरोध भेजता है.

आम तौर पर, SearchStream की परफ़ॉर्मेंस बेहतर होती है, क्योंकि यह अलग-अलग पेजों का अनुरोध करने के लिए दोतरफ़ा-यात्रा नेटवर्क समय की ज़रूरत होती है. हमारा सुझाव है कि आप इनका इस्तेमाल करें SearchStream, 10,000 से ज़्यादा पंक्तियों वाली सभी रिपोर्ट के लिए. कोई अहम जानकारी नहीं है छोटी रिपोर्ट (10,000 से कम पंक्तियां) के तरीकों के बीच परफ़ॉर्मेंस में अंतर होता है.

आपने जिस तरीके का इस्तेमाल किया है उससे आपके एपीआई कोटे और सीमाओं पर कोई असर नहीं पड़ता: एक क्वेरी या रिपोर्ट की गिनती एक कार्रवाई के तौर पर की जाती है, भले ही नतीजे पेज किए गए हों या स्ट्रीम किए गए हों.

उदाहरण खोज क्वेरी

उदाहरण के तौर पर दी गई यह क्वेरी, खाते की पिछले 30 दिनों की परफ़ॉर्मेंस का डेटा दिखाती है अभियान के अनुसार, डिवाइस के आधार पर सेगमेंट किया गया:

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

अनुरोध करें

अनुरोध करने के लिए, आपको customer_id और query स्ट्रिंग पास करनी होगी SearchAds360Service.SearchStream या SearchAds360Service.Search तक इंटरफ़ेस पर कॉपी करने की सुविधा मिलती है.

अनुरोध में Search Ads 360 Reporting API के लिए एक एचटीटीपी POST शामिल है सर्वर को इनमें से किसी एक यूआरएल पर अपलोड करता है:

https://searchads360.googleapis.com/VERSION_NUMBER/customers/CUSTOMER_ID/searchads360:searchStream

https://searchads360.googleapis.com/VERSION_NUMBER/customers/CUSTOMER_ID/searchads360:search

यहां searchStream की रिपोर्ट की परिभाषा का पूरा उदाहरण दिया गया है. एक एचटीटीपी POST अनुरोध:

POST /VERSION_NUMBER/customers/CUSTOMER_ID/searchads360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [OAUTH_2.0_ACCESS_TOKEN]

Parameters:
{
  "query" : "SELECT campaign.name, campaign.status, segments.device,
                    metrics.impressions, metrics.clicks, metrics.ctr,
                    metrics.average_cpc, metrics.cost_micros
            FROM campaign
            WHERE segments.date DURING LAST_30_DAYS"
}

जवाब प्रोसेस करना

SearchAds360Service, SearchAds360Row ऑब्जेक्ट की सूची दिखाता है.

हर SearchAds360Row, क्वेरी से मिला एक ऑब्जेक्ट दिखाता है. हर ऑब्जेक्ट इसमें एट्रिब्यूट का एक ऐसा सेट होता है जो अनुरोध किए गए फ़ील्ड के आधार पर अपने-आप भर जाता है क्वेरी के SELECT क्लॉज़ में मौजूद है. SELECT में शामिल नहीं किए गए एट्रिब्यूट जवाब में मौजूद ऑब्जेक्ट में, क्लॉज़ अपने-आप नहीं भरे जाते.

उदाहरण के लिए, नीचे दी गई क्वेरी हर SearchAds360Row ऑब्जेक्ट को सिर्फ़ campaign.id, campaign.name, और campaign.status. अन्य एट्रिब्यूट, जैसे कि campaign.engine_id या campaign.bidding_strategy_type शामिल नहीं किए गए हैं.

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign

रेफ़रंस के लिए दस्तावेज़

रेफ़रंस सेक्शन इसमें वह सारी जानकारी शामिल होती है जिसकी ज़रूरत आपको हर आर्टफ़ैक्ट के सही तरीके से इस्तेमाल करने के लिए होती है. यहां है हर संसाधन के लिए एक पेज होना चाहिए. उदाहरण के लिए, ad_group और campaign. segments और metrics पेज सभी उपलब्ध सेगमेंट और मेट्रिक फ़ील्ड की सूची बनाना.

कुछ संसाधन, सेगमेंट, और मेट्रिक काम नहीं कर रही हैं और इनका इस्तेमाल नहीं किया जा सकता साथ ही, अन्य क्रिएटर्स भी पूरी तरह से काम करते हैं और एक-दूसरे की मदद करते हैं. हर संसाधन पेज पर यह जानकारी शामिल होती है (अगर उपलब्ध हो और उचित) और बहुत कुछ:

एट्रिब्यूट किए गए संसाधन

कुछ संसाधनों के लिए, आपके पास यह विकल्प हो सकता है कि आप सीधे संसाधनों के फ़ील्ड के साथ-साथ उनके फ़ील्ड भी चुने जा सकते हैं. आपका FROM क्लॉज़. उदाहरण के लिए, campaign संसाधन ad_group संसाधन का एट्रिब्यूट किया गया संसाधन. इसका मतलब है कि आपको अपनेcampaign.idcampaign.bidding_strategy_type आपके FROM क्लॉज़ में ad_group का इस्तेमाल करते समय क्वेरी.

एट्रिब्यूट किए गए संसाधन सेक्शन में, एट्रिब्यूट किए गए उपलब्ध संसाधनों की सूची होती है. नहीं सभी संसाधनों ने संसाधन को एट्रिब्यूट किया है.

संसाधन फ़ील्ड वाला कॉलम

संसाधन फ़ील्ड कॉलम में, संसाधन के सभी फ़ील्ड शामिल होते हैं. हर संसाधन फ़ील्ड, फ़ील्ड के बारे में ज़्यादा जानकारी देता है. इसमें, फ़ील्ड के ब्यौरा, कैटगरी, डेटा टाइप, यूआरएल टाइप, और फ़िल्टर करने लायक, चुनने लायक, और दोहराए जाने वाले सेटिंग की सुविधा मिलती है.

सेगमेंट कॉलम

दिए गए संसाधन से सभी सेगमेंट फ़ील्ड नहीं चुने जा सकते.

सेगमेंट कॉलम में segments फ़ील्ड की सूची होती है, जिसका इस्तेमाल वही SELECT क्लॉज़ है जो संसाधन के फ़ील्ड में मौजूद है. हर फ़ील्ड, फ़ुल फ़ील्ड के बारे में जानकारी. इसमें फ़ील्ड का ब्यौरा, कैटगरी, डेटा टाइप, टाइप वगैरह शामिल हैं यूआरएल के साथ-साथ, फ़िल्टर किया जा सकता है, चुना जा सकता है, क्रम से लगाया जा सकता है, और दोहराया जा सकता है. अगर आप अपने FROM क्लॉज़ में संसाधन का इस्तेमाल करके, हां/नहीं ड्रॉपडाउन का इस्तेमाल किया जा सकता है जो सेगमेंट उपलब्ध नहीं हैं उन्हें फ़िल्टर करने के लिए.

मेट्रिक कॉलम

दिए गए संसाधन से, सभी मेट्रिक फ़ील्ड को नहीं चुना जा सकता.

मेट्रिक कॉलम में metrics फ़ील्ड की सूची होती है. इनका इस्तेमाल वही SELECT क्लॉज़ है जो संसाधन के फ़ील्ड में मौजूद है. हर फ़ील्ड, फ़ुल फ़ील्ड के बारे में जानकारी. इसमें फ़ील्ड का ब्यौरा, कैटगरी, डेटा टाइप, टाइप वगैरह शामिल हैं यूआरएल के साथ-साथ, फ़िल्टर किया जा सकता है, चुना जा सकता है, क्रम से लगाया जा सकता है, और दोहराया जा सकता है. अगर आप अपने FROM क्लॉज़ में संसाधन का इस्तेमाल करके, हां/नहीं ड्रॉपडाउन का इस्तेमाल करके जो मेट्रिक उपलब्ध नहीं हैं उन्हें फ़िल्टर करें.

सेगमेंट में बांटने के संसाधन

कुछ संसाधनों में ऐसे संसाधन फ़ील्ड होते हैं जिन्हें सेगमेंट में बांटा जा सकता है. इन्हें तब चुना जा सकता है, जब संसाधन आपके FROM क्लॉज़ में है. उदाहरण के लिए, अगर आपने campaign संसाधन फ़ील्ड चुना है, जैसे campaign.name, जब अपने FROM क्लॉज़ में campaign_budget का इस्तेमाल करके, campaign.resource_name अपने-आप वापस आ जाएगा और को सेगमेंट में बांटे जाएंगे. ऐसा इसलिए, क्योंकि campaign campaign_budget के सेगमेंटिंग संसाधन.

संसाधनों को सेगमेंट में बांटना सेक्शन में, सेगमेंट करने के लिए उपलब्ध संसाधनों की सूची होती है. नहीं सभी संसाधनों में सेगमेंटिंग संसाधन हैं.

इन्हें चुना जा सकता है

कुछ segments फ़ील्ड अन्य संसाधनों, सेगमेंट और मेट्रिक.

segments पेज में हर segments फ़ील्ड के लिए, इसके साथ चुनने की सुविधा शामिल होती है, जिसे बड़ा किया जा सकता है यह नीति, काम करने वाले सभी संसाधन फ़ील्ड, metrics फ़ील्ड, और अन्य segments की सूची बनाती है फ़ील्ड शामिल किए जा सकते हैं जिन्हें अपने SELECT क्लॉज़ में शामिल किया जा सकता है.

सेगमेंट करने की सुविधा

आप segments.FIELD_NAME फ़ील्ड को आपकी क्वेरी के SELECT क्लॉज़ में जोड़ा जाता है.

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

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

SearchAds360Service.SearchStream से मिले नतीजे कुछ दिखते हैं इस JSON स्ट्रिंग की तरह:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    },
    ...
  ]
}

segments पर जाकर देखें सेगमेंट फ़ील्ड की सूची देखें जिसका इस्तेमाल किया जा सकता है.

एक से ज़्यादा सेगमेंट

अपनी क्वेरी के SELECT क्लॉज़ में एक से ज़्यादा सेगमेंट तय किए जा सकते हैं. कॉन्टेंट बनाने रिस्पॉन्स में, फ़ाइल के हर कॉम्बिनेशन के लिए एक SearchAds360Row ऑब्जेक्ट होता है FROM क्लॉज़ में बताए गए मुख्य संसाधन का इंस्टेंस और चुने गए हर segment फ़ील्ड की value.

उदाहरण के लिए, निम्न क्वेरी के प्रत्येक संयोजन के लिए एक पंक्ति दिखाएगी campaign, segments.ad_network_type, और segments.date.

SELECT
  segments.ad_network_type
  segments.date
FROM campaign

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

इस उदाहरण में दी गई क्वेरी के नतीजे, हर कैंपेन के लिए एक पंक्ति के तौर पर आते हैं, न कि एक लाइन के लिए campaign.status फ़ील्ड की एक अलग वैल्यू.

SELECT
  campaign.status,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

इंप्लिसिट सेगमेंटेशन

हर रिपोर्ट को शुरुआत में, FROM में दिए गए संसाधन के हिसाब से सेगमेंट किया जाता है क्लॉज़. मेट्रिक को इस संसाधन के resource_name फ़ील्ड के हिसाब से बांटा गया है

उदाहरण के तौर पर दी गई यह क्वेरी, अपने-आप ad_group.resource_name नतीजे दिखाती है. इसका इस्तेमाल करके, ad_group लेवल पर मेट्रिक को सेगमेंट में बांटा जाता है.

SELECT metrics.impressions
FROM ad_group

दिखाई गई JSON स्ट्रिंग इसके जैसी दिखती है:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

तारीख के मुख्य सेगमेंट

कोई तारीख बताने के लिए, WHERE क्लॉज़ में तारीख के मुख्य सेगमेंट का इस्तेमाल किया जा सकता है या समयावधि.

नीचे दिए गए सेगमेंट फ़ील्ड को तारीख के मुख्य सेगमेंट कहा जाता है: segments.date, segments.week, segments.month, segments.quarter, और segments.year.

उदाहरण के तौर पर दी गई यह क्वेरी, पिछले 30 दिनों के कैंपेन की clicks मेट्रिक दिखाती है.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

तारीख के मुख्य सेगमेंट वाले फ़ील्ड, उस सामान्य नियम का अपवाद हैं जिसे आपने अपने WHERE खंड में सेगमेंट फ़ील्ड का तब तक उपयोग नहीं कर सकता, जब तक आप फ़ील्ड में अपने SELECT खंड में डालें. ज़्यादा जानकारी के लिए, पाबंदी वाले फ़िल्टर देखें जानकारी.

तारीख के सेगमेंट के मुख्य नियम:

  • आप अपने WHERE क्लॉज़ में कोर तारीख फ़ील्ड को शामिल किए बिना भी इस्तेमाल कर सकते हैं SELECT क्लॉज़. अगर आप चाहें, तो फ़ील्ड को दोनों क्लॉज़ में भी शामिल किया जा सकता है.

    उदाहरण के तौर पर दी गई यह क्वेरी, तारीख के दौरान कैंपेन के नाम के हिसाब से clicks मेट्रिक दिखाती है रेंज. ध्यान दें कि segments.date को SELECT क्लॉज़ में शामिल नहीं किया गया है.

    SELECT
    campaign.name,
    metrics.clicks
FROM campaign
WHERE segments.date > '2022-02-01'
  AND segments.date < '2022-03-01'

  • अगर आप अपने SELECT क्लॉज़ में मुख्य तारीख फ़ील्ड शामिल करते हैं, तो आपको आपके WHERE क्लॉज़ में दी गई तारीख की सीमा या तारीख की सीमा तय की गई है. SELECT और WHERE क्लॉज़ का मेल खाना ज़रूरी नहीं है.

    उदाहरण के तौर पर दी गई क्वेरी, कैंपेन के नाम के हिसाब से clicks मेट्रिक दिखाती है. इन मेट्रिक को इनके आधार पर बांटा गया है महीना, तारीख की सीमा में सभी दिनों के लिए.

    SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2022-02-01'
  AND segments.date < '2022-03-01'

ISO 8601 तारीख

तारीख और तारीख की सीमा तय करने के लिए, YYYY-MM-DD (ISO 8601) फ़ॉर्मैट का इस्तेमाल किया जा सकता है, उदाहरण के लिए:

WHERE segments.date BETWEEN '2022-06-01' AND '2022-06-30'

WHERE segments.date >= '2022-06-01' AND segments.date <= '2022-06-30'

तारीख के उन मुख्य सेगमेंट के लिए जिन्हें एक समयावधि (segments.week, segments.month, segments.quarter) आप = ऑपरेटर का इस्तेमाल समयावधि का पहला दिन, उदाहरण के लिए:

WHERE segments.month = '2022-06-01'

पहले से तय तारीखें

पहले से तय की गई इन तारीखों और तारीख की सीमाओं का भी इस्तेमाल किया जा सकता है:

पहले से तय तारीखें
TODAY ऑफ़र सिर्फ़ आज के लिए.
YESTERDAY सिर्फ़ बीते कल के लिए.
LAST_7_DAYS पिछले सात दिनों का डेटा जिसमें आज का दिन शामिल नहीं है.
LAST_BUSINESS_WEEK पिछले पांच दिन के कारोबारी हफ़्ते (सोमवार से शुक्रवार).
THIS_MONTH मौजूदा महीने के सभी दिन.
LAST_MONTH पिछले महीने के सभी दिन.
LAST_14_DAYS आज को छोड़कर पिछले 14 दिन.
LAST_30_DAYS आज को छोड़कर पिछले 30 दिन.
THIS_WEEK_SUN_TODAY पिछले रविवार और मौजूदा दिन के बीच का समय.
THIS_WEEK_MON_TODAY पिछले सोमवार और मौजूदा दिन के बीच की अवधि.
LAST_WEEK_SUN_SAT पिछले रविवार से शुरू होने वाली सात दिन की अवधि.
LAST_WEEK_MON_SUN पिछले सोमवार से शुरू होने वाले सात दिन की अवधि.

उदाहरण:

WHERE segments.date DURING LAST_30_DAYS

शून्य मेट्रिक

किसी क्वेरी को लागू करने पर, आपको कुछ क्वेरी के लिए शून्य वैल्यू वाली मेट्रिक दिख सकती हैं इकाइयां. अपनी क्वेरी में शून्य मेट्रिक को मैनेज करने का तरीका जानें.

UNKNOWN enum टाइप

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

अगर किसी संसाधन का टाइप UNKNOWN है, तो भी मेट्रिक चुनी जा सकती हैं, लेकिन नीचे दी गई बातों का ध्यान रखना ज़रूरी है:

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