इस गाइड में, Google Ads की क्वेरी के लिए भाषा की क्वेरी का एक सेट दिया गया है. इसमें बताया गया है कि Google Ads के यूज़र इंटरफ़ेस (यूआई) में स्क्रीन के जैसा डेटा कैसे दिखाया जाए. साथ ही, भौगोलिक कॉन्सटेंट को खोजने का तरीका भी बताया गया है. अपनी पसंद के मुताबिक क्वेरी तैयार करने के लिए, इन क्वेरी का इस्तेमाल उसी तरह या शुरुआती पॉइंट के तौर पर किया जा सकता है.
Google Ads यूज़र इंटरफ़ेस (यूआई) स्क्रीन की कॉपी बनाना
इस सेक्शन में, एपीआई क्वेरी के बारे में जानकारी दी गई है. ये क्वेरी, Google Ads यूज़र इंटरफ़ेस (यूआई) की डिफ़ॉल्ट स्क्रीन जैसा ही डेटा दिखाती हैं. अगर आपको ऐसा ऐप्लिकेशन बनाना है जो Google Ads से मिलते-जुलते मेट्रिक और डेटा दिखाता है, तो ये क्वेरी एपीआई से मिलता-जुलता डेटा पाने में आपकी मदद कर सकती हैं.
कैंपेन
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट कैंपेन की खास जानकारी देने वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.optimization_score, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT campaign.name, campaign_budget.amount_micros, campaign.status, campaign.optimization_score, campaign.advertising_channel_type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.bidding_strategy_type FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != 'REMOVED' " }'
विज्ञापन ग्रुप
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट विज्ञापन ग्रुप की खास जानकारी देने वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group.name, campaign.name, ad_group.status, ad_group.type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM ad_group WHERE segments.date DURING LAST_7_DAYS AND ad_group.status != 'REMOVED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group.name, campaign.name, ad_group.status, ad_group.type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM ad_group WHERE segments.date DURING LAST_7_DAYS AND ad_group.status != 'REMOVED' " }'
विज्ञापन
यूज़र इंटरफ़ेस (यूआई) में, विज्ञापनों की खास जानकारी देने वाली डिफ़ॉल्ट स्क्रीन.
ध्यान दें कि यह क्वेरी खास तौर पर बड़े किए गए टेक्स्ट विज्ञापन के अलग-अलग कॉम्पोनेंट को फे़च करती है, जो यूज़र इंटरफ़ेस (यूआई) स्क्रीन के विज्ञापन कॉलम में एक साथ रेंडर होते हैं.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group_ad.ad.expanded_text_ad.headline_part1, ad_group_ad.ad.expanded_text_ad.headline_part2, ad_group_ad.ad.expanded_text_ad.headline_part3, ad_group_ad.ad.final_urls, ad_group_ad.ad.expanded_text_ad.description, ad_group_ad.ad.expanded_text_ad.description2, campaign.name, ad_group.name, ad_group_ad.policy_summary.approval_status, ad_group_ad.ad.type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM ad_group_ad WHERE segments.date DURING LAST_7_DAYS AND ad_group_ad.status != 'REMOVED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group_ad.ad.expanded_text_ad.headline_part1, ad_group_ad.ad.expanded_text_ad.headline_part2, ad_group_ad.ad.expanded_text_ad.headline_part3, ad_group_ad.ad.final_urls, ad_group_ad.ad.expanded_text_ad.description, ad_group_ad.ad.expanded_text_ad.description2, campaign.name, ad_group.name, ad_group_ad.policy_summary.approval_status, ad_group_ad.ad.type, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM ad_group_ad WHERE segments.date DURING LAST_7_DAYS AND ad_group_ad.status != 'REMOVED' " }'
सर्च कीवर्ड
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट सर्च कीवर्ड की खास जानकारी वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group_criterion.keyword.text, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.keyword.match_type, ad_group_criterion.approval_status, ad_group_criterion.final_urls, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM keyword_view WHERE segments.date DURING LAST_7_DAYS AND ad_group_criterion.status != 'REMOVED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group_criterion.keyword.text, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.keyword.match_type, ad_group_criterion.approval_status, ad_group_criterion.final_urls, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM keyword_view WHERE segments.date DURING LAST_7_DAYS AND ad_group_criterion.status != 'REMOVED' " }'
खोज के लिए इस्तेमाल हुए शब्द
यूज़र इंटरफ़ेस (यूआई) में, खोज के लिए इस्तेमाल हुए शब्दों की डिफ़ॉल्ट जानकारी वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT search_term_view.search_term, segments.keyword.info.match_type, search_term_view.status, campaign.name, ad_group.name, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM search_term_view WHERE segments.date DURING LAST_7_DAYS
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT search_term_view.search_term, segments.keyword.info.match_type, search_term_view.status, campaign.name, ad_group.name, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM search_term_view WHERE segments.date DURING LAST_7_DAYS " }'
ऑडियंस
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट ऑडियंस की खास जानकारी वाली स्क्रीन.
ध्यान दें कि Reporting API अपने मानदंड आईडी के हिसाब से ऑडियंस दिखाता है. उनके डिसप्ले नेम पाने के लिए, कोड और फ़ॉर्मैट पेज पर दी गई रेफ़रंस टेबल में दिए गए आईडी देखें. यह तय करने के लिए कि किस मापदंड टाइप टेबल का इस्तेमाल करना है, ad_group_criterion.type
फ़ील्ड को बंद करें.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group_criterion.resource_name, ad_group_criterion.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM ad_group_audience_view WHERE segments.date DURING LAST_7_DAYS
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group_criterion.resource_name, ad_group_criterion.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM ad_group_audience_view WHERE segments.date DURING LAST_7_DAYS " }'
उम्र (डेमोग्राफ़िक्स)
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट उम्र के डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) की खास जानकारी देने वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group_criterion.age_range.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM age_range_view WHERE segments.date DURING LAST_7_DAYS
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group_criterion.age_range.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM age_range_view WHERE segments.date DURING LAST_7_DAYS " }'
लिंग (डेमोग्राफ़िक्स)
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट रूप से, लिंग के आधार पर डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह) की खास जानकारी देने वाली स्क्रीन.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT ad_group_criterion.gender.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM gender_view WHERE segments.date DURING LAST_7_DAYS
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT ad_group_criterion.gender.type, campaign.name, ad_group.name, ad_group_criterion.system_serving_status, ad_group_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros, campaign.advertising_channel_type FROM gender_view WHERE segments.date DURING LAST_7_DAYS " }'
देश या इलाके
यूज़र इंटरफ़ेस (यूआई) में डिफ़ॉल्ट जगहों की खास जानकारी वाली स्क्रीन.
ध्यान दें कि Reporting API अपने मानदंड आईडी के हिसाब से जगहों की जानकारी दिखाता है. उनके डिसप्ले नेम पाने के लिए, जियो टारगेट डेटा में campaign_criterion.location.geo_target_constant
देखें या geo_target_constant
संसाधन के बारे में क्वेरी करने के लिए एपीआई का इस्तेमाल करें.
यूज़र इंटरफ़ेस (यूआई) स्क्रीन
एपीआई क्वेरी
जीएक्यूएल
SELECT campaign_criterion.location.geo_target_constant, campaign.name, campaign_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM location_view WHERE segments.date DURING LAST_7_DAYS AND campaign_criterion.status != 'REMOVED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data '{ "query": " SELECT campaign_criterion.location.geo_target_constant, campaign.name, campaign_criterion.bid_modifier, metrics.clicks, metrics.impressions, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM location_view WHERE segments.date DURING LAST_7_DAYS AND campaign_criterion.status != 'REMOVED' " }'
भौगोलिक स्थिरांक खोजना
कोड और फ़ॉर्मैट पेज पर, एपीआई में इस्तेमाल किए जाने वाले ज़्यादातर कॉन्सटेंट के लिए रेफ़रंस टेबल दी जाती हैं. हालांकि, Google Ads क्वेरी लैंग्वेज का इस्तेमाल करके डाइनैमिक तौर पर कुछ कॉन्स्टेंट देखे जा सकते हैं.
इस सैंपल में, किसी जगह को उसके संसाधन के नाम या उसके डिसप्ले नेम से खोजने का तरीका बताया गया है.
संसाधन के नाम के हिसाब से
माउंटेन व्यू, कैलिफ़ोर्निया के संसाधन नाम geoTargetConstants/1014044
के आधार पर देखें.
जीएक्यूएल
SELECT geo_target_constant.canonical_name, geo_target_constant.country_code, geo_target_constant.id, geo_target_constant.name, geo_target_constant.status, geo_target_constant.target_type FROM geo_target_constant WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data "{ \"query\": \" SELECT geo_target_constant.canonical_name, geo_target_constant.country_code, geo_target_constant.id, geo_target_constant.name, geo_target_constant.status, geo_target_constant.target_type FROM geo_target_constant WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044' \" }"
डिसप्ले नाम के हिसाब से
अमेरिका के "माउंटेन व्यू" को एक शहर के नाम के रूप में देखें.
जीएक्यूएल
SELECT geo_target_constant.canonical_name, geo_target_constant.country_code, geo_target_constant.id, geo_target_constant.name, geo_target_constant.status, geo_target_constant.target_type FROM geo_target_constant WHERE geo_target_constant.country_code = 'US' AND geo_target_constant.target_type = 'City' AND geo_target_constant.name = 'Mountain View' AND geo_target_constant.status = 'ENABLED'
cURL
curl -f --request POST "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \ --data "{ \"query\": \" SELECT geo_target_constant.canonical_name, geo_target_constant.country_code, geo_target_constant.id, geo_target_constant.name, geo_target_constant.status, geo_target_constant.target_type FROM geo_target_constant WHERE geo_target_constant.country_code = 'US' AND geo_target_constant.target_type = 'City' AND geo_target_constant.name = 'Mountain View' AND geo_target_constant.status = 'ENABLED' \" }"