Google Ad Manager, LineItems जैसी ट्रैफ़िकिंग इकाइयों की रिपोर्टिंग और उनमें हेर-फेर करने के लिए, SOAP एपीआई की सुविधा देता है.
क्लाइंट लाइब्रेरी कई भाषाओं में उपलब्ध हैं. AdX Seller API की तरह, Ad Manager API भी पुष्टि करने के लिए OAuth2 का इस्तेमाल करता है.
अपने पहले एपीआई अनुरोध से शुरू करने के लिए, शुरू करना देखें.
Ad Manager API में रिपोर्टिंग
Ad Manager API ReportService, रिपोर्ट चलाने और डाउनलोड करने के दो तरीके ऑफ़र करता है:
- यूज़र इंटरफ़ेस (यूआई) में क्वेरी बनाना और उसे उसके आईडी के आधार पर चलाना.
- ऐड-हॉक ReportQuery बनाना.
इनमें से किसी भी विकल्प के साथ, एपीआई वर्कफ़्लो में चार चरण होते हैं:
- runReportJob को कॉल करें.
- getReportJobStatus का इस्तेमाल करके, रिपोर्ट की स्थिति की जानकारी देने वाला पोल.
- getReportDownloadUrlWithOptions का इस्तेमाल करके, पूरी रिपोर्ट का यूआरएल पाएं.
- लौटाए गए यूआरएल से रिपोर्ट डाउनलोड करें.
ज़्यादा जानकारी के लिए, रिपोर्टिंग गाइड देखें.
रिपोर्टिंग के टाइम ज़ोन
Ad Exchange Seller REST API के उलट, Ad Manager API रिपोर्ट में डिफ़ॉल्ट रूप से आपके नेटवर्क का टाइम ज़ोन तय होता है. इसमें बदलाव करने के लिए, TimeZoneType
फ़ील्ड सेट करें.
AdX से Ad Manager मेट्रिक और डाइमेंशन मैपिंग
साथ काम करने वाले सभी Ad Exchange विक्रेता REST API की मेट्रिक और डाइमेंशन, अब Ad Manager रिपोर्टिंग एपीआई में मौजूद होते हैं. कुछ नाम बदल गए हैं और कुछ को हटा दिया गया है. जानकारी के लिए, कृपया नीचे दी गई टेबल देखें.
मेट्रिक / कॉलम
इस टेबल में 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 | विज्ञापन अनुरोध CTR |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | विज्ञापन अनुरोध 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 | (नया सुझाव) विज्ञापन 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 | मेल खाने वाला 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 वीटीआर |
डाइमेंशन
इस टेबल में, 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_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | अनुरोध स्रोत |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | साइटें |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| 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 | कीमत तय करने के नियम |