Google Ad Manager, रिपोर्टिंग और ट्रैफ़िकिंग इकाइयों में बदलाव करने के लिए SOAP API उपलब्ध कराता है. जैसे, LineItems.
क्लाइंट लाइब्रेरी कई भाषाओं में उपलब्ध हैं. AdX Seller API की तरह ही, Ad Manager API भी पुष्टि करने के लिए OAuth2 का इस्तेमाल करता है.
एपीआई के लिए पहला अनुरोध करने के लिए, शुरू करना लेख पढ़ें.
Ad Manager API में रिपोर्टिंग
Ad Manager API ReportService की मदद से, रिपोर्ट को चलाने और डाउनलोड करने के दो तरीके हैं:
- यूज़र इंटरफ़ेस में क्वेरी बनाना और उसे उसके आईडी के आधार पर चलाना.
- एड हॉक ReportQuery बनाना.
इनमें से किसी भी विकल्प का इस्तेमाल करने पर, एपीआई वर्कफ़्लो में चार चरण होते हैं:
- runReportJob को कॉल करें.
- getReportJobStatus का इस्तेमाल करके, रिपोर्ट की स्थिति के लिए पोल करें.
- getReportDownloadUrlWithOptions का इस्तेमाल करके, पूरी रिपोर्ट का यूआरएल पाएं.
- जवाब में मिले यूआरएल से रिपोर्ट डाउनलोड करें.
ज़्यादा जानकारी के लिए, रिपोर्टिंग गाइड देखें.
रिपोर्टिंग के टाइम ज़ोन
Ad Exchange सेलर REST API के उलट, Ad Manager API में रिपोर्ट आपके नेटवर्क के समय क्षेत्र के हिसाब से डिफ़ॉल्ट रूप से सेट होती हैं. इसे बदलने के लिए, TimeZoneType फ़ील्ड सेट करें.
AdX से Ad Manager की मेट्रिक और डाइमेंशन मैपिंग
Ad Exchange Seller REST API के साथ काम करने वाली सभी मेट्रिक और डाइमेंशन अब Ad Manager Reporting API में मौजूद हैं. कुछ नाम बदल गए हैं और कुछ को बंद कर दिया गया है. ज़्यादा जानकारी के लिए, कृपया यहां दी गई टेबल देखें.
मेट्रिक / कॉलम
इस टेबल में, AdX मेट्रिक को Ad Manager कॉलम से मैप किया गया है.
| AdX मेट्रिक | Ad Manager कॉलम | Ad Manager क्वेरी टूल का नाम |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | ऐक्टिव व्यू की सुविधा चालू होने पर मिले इंप्रेशन |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | ऐक्टिव व्यू से मेज़र किए गए इंप्रेशन |
| ACTIVE_VIEW_MEASURABLE_RATIO | (अब इस्तेमाल नहीं किया जाता) | (अब इस्तेमाल नहीं किया जाता) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | ऐक्टिव व्यू के हिसाब से देखे गए इंप्रेशन |
| ACTIVE_VIEW_VIEWABLE_RATIO | (अब इस्तेमाल नहीं किया जाता) | (अब इस्तेमाल नहीं किया जाता) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | औसतन कितने सेकंड तक विज्ञापन देखा गया |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | विज्ञापन इंप्रेशन |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | विज्ञापन eCPM |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | विज्ञापन अनुरोध |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | कवरेज |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | विज्ञापन अनुरोध सीटीआर |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | विज्ञापन अनुरोध ईसीपीएम |
| क्लिक | AD_EXCHANGE_CLICKS | क्लिक |
| COST_PER_CLICK | AD_EXCHANGE_CPC | सीपीसी |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | डील के लिए विज्ञापन अनुरोध |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | डील के लिए बिड रिस्पॉन्स |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | डील का मैच रेट |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | डील से मेल खाने वाले अनुरोध |
| आय | AD_EXCHANGE_ESTIMATED_REVENUE | अनुमानित रेवेन्यू |
| INDIVIDUAL_AD_IMPRESSIONS | (अब इस्तेमाल नहीं किया जाता) | (अब इस्तेमाल नहीं किया जाता) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | विज्ञापन सीटीआर |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (नया सुझाव) AD_EXCHANGE_AD_ECPM | (नया सुझाव) विज्ञापन ईसीपीएम |
| LIFT_RATE | AD_EXCHANGE_LIFT | लिफ़्ट |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | मेल खाने वाले अनुरोध |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | क्लिक मिलने की दर (सीटीआर) |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | मेल खाने वाला ईसीपीएम |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | वीडियो छोड़ने की दर |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | वीडियो ड्रॉप-ऑफ़ रेट |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | वीडियो क्वार्टाइल 1 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | वीडियो क्वार्टाइल 3 |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | TrueView स्किप दर |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | TrueView के व्यू |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView VTR |
आयाम
इस टेबल में, AdX डाइमेंशन को Ad Manager डाइमेंशन से मैप किया गया है .
| AdX डाइमेंशन | Ad Manager डाइमेंशन | Ad Manager क्वेरी टूल का नाम |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | वेब प्रॉपर्टी |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | विज्ञापन दिखाने की जगहें |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | टैग |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (उपलब्ध नहीं है) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | इन्वेंट्री के साइज़ |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | विज्ञापनदाता डोमेन |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | विज्ञापन देने वाले लोग या कंपनियां |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | विज्ञापन देने वाले व्यक्ति या कंपनी के वर्टिकल |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | एजेंसियां |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (उपलब्ध नहीं है) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | ब्रैंड |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (उपलब्ध नहीं है) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | ब्रैंडिंग के टाइप |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (उपलब्ध नहीं है) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | खरीदार के नेटवर्क |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (उपलब्ध नहीं है) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | देश |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | क्रिएटिव साइज़ |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (उपलब्ध नहीं है) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (उपलब्ध नहीं है) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | चैनल |
| DATE | AD_EXCHANGE_DATE | दिन |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | डील आईडी |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | डील के नाम |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (उपलब्ध नहीं है) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | DFP विज्ञापन यूनिट |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | अनुरोध के सोर्स |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | साइटें |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | डीएसपी |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | एक्सपैंड किए जा सकने वाले टाइप |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | इन्वेंट्री का मालिकाना हक |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | नेटवर्क पार्टनर के नाम |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | ऐप्लिकेशन के नाम |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | मोबाइल और इंटरनेट सेवा देने वाली कंपनी के नाम |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | डिवाइस |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | अलग-अलग तरह की इन्वेंट्री |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | ऑपरेटिंग सिस्टम |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | बैंडविड्थ |
| MONTH | AD_EXCHANGE_MONTH | महीने |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | डिवाइस की कैटगरी |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (उपलब्ध नहीं है) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | प्रॉडक्ट |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (उपलब्ध नहीं है) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | लक्ष्यीकरण प्रकार |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (उपलब्ध नहीं है) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | लेन-देन के प्रकार |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (उपलब्ध नहीं है) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | यूआरएल |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (उपलब्ध नहीं है) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | वीडियो विज्ञापन की अवधि |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | वीडियो विज्ञापन के टाइप |
| WEEK | AD_EXCHANGE_WEEK | हफ़्ते |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (उपलब्ध नहीं है) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | कीमत तय करने के नियम |