string Partner ID of the buyer (usually reflects the buyer's partner ID in DV360).
Inventory Source ID
string Inventory Source ID. This field maps to the Deal ID field from the request.
Environment
string Environment type, for example, mobile or desktop. This field related to the Device Type field from the request. Mapping can be found in the Entity Mapping section.
UTC Week
string The date of the first day of the week represents the week in report row.
UTC Month
string The year month of the report row, in the format of YYYY/MM.
Impressions
string (int64 format) Impression value in specified date/hour/week.
Impression Cost (USD)
number (double format) Impression cost in specified date/hour/week, currency in USD.
Invalid Impressions
string (int64 format) Invalid traffic impression in the specified week.
Invalid Impression Cost (USD)
string (int64 format) Invalid traffic impression in the specified week, currency in USD.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eThe DV360 Exchange Reporting API allows you to generate and retrieve reports on campaign performance data.\u003c/p\u003e\n"],["\u003cp\u003eWhen requesting reports with detailed dimensions like creative or deal IDs, be aware of potential processing time and rate limits.\u003c/p\u003e\n"],["\u003cp\u003eReports provide insights into various metrics such as impressions, cost, and invalid traffic, broken down by dimensions like publisher, creative, country, and environment.\u003c/p\u003e\n"],["\u003cp\u003eReport data is organized into rows with specific fields containing information like event date, creative type, and inventory source.\u003c/p\u003e\n"],["\u003cp\u003eYou can access detailed documentation on generating and retrieving reports, as well as understanding the data fields and their mappings, through the provided links.\u003c/p\u003e\n"]]],[],null,["# Use cases\n\nHere are some common use cases of the DV360 Exchange Reporting API.\n\nGenerate report\n---------------\n\nRefer to the [`generateReport`](/display-video/exchange-reporting/reference/rest/v1alpha1/exchanges/generateReport) documentation for\ninstructions on how to generate a report.\n\nGet report (formerly pull report)\n---------------------------------\n\nRefer to the [`getReport`](/display-video/exchange-reporting/reference/rest/v1alpha1/exchanges.reports/get) documentation for instructions on how\nto pull a report.\n| **Warning:** Since exchanges are pulling data for all advertisers, if you have heavy loaded dimensions, such as creative ID or deal ID, the report could take a long time to generate and your client caller could be rate limited.\n\nColumns of Report Row in the Report File\n----------------------------------------\n\n| Fields | Notes |\n|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| UTC Event Date | **string** Date of the report in the format YYYYMMDD. |\n| UTC Event Hour | **string** Hour of the report. Used in hourly reports, representing the hour of the day. Values from 0 to 23, 0 representing \\[0:00:00 \\~ 1:00:00) UTC. |\n| Publisher ID | **string** Publisher ID, for example, \"10005_1350300\". |\n| Creative ID | **string** ([int64](/discovery/v1/type-format) format) Creative ID. |\n| Creative Type | **string** Creative type of the report row, for example, image or audio. Mapping can be found in the [Entity Mapping section](/display-video/exchange-reporting/guides/reports/entity-mapping#creative_type). |\n| Country ID | **string** Country (Region) ID. The mapping can be accessed through Entity reader files through [DV360 API](/display-video/api/guides/how-tos/erf-migration#geolocation) or [DoubleClick Bid Manager API](/bid-manager/guides/entity-read/overview). |\n| Partner ID | **string** Partner ID of the buyer (usually reflects the buyer's partner ID in DV360). |\n| Inventory Source ID | **string** Inventory Source ID. This field maps to the Deal ID field from the request. |\n| Environment | **string** Environment type, for example, mobile or desktop. This field related to the Device Type field from the request. Mapping can be found in the [Entity Mapping section](/display-video/exchange-reporting/guides/reports/entity-mapping#environment). |\n| UTC Week | **string** The date of the first day of the week represents the week in report row. |\n| UTC Month | **string** The year month of the report row, in the format of YYYY/MM. |\n| Impressions | **string** ([int64](/discovery/v1/type-format) format) Impression value in specified date/hour/week. |\n| Impression Cost (USD) | **number** ([double](/discovery/v1/type-format) format) Impression cost in specified date/hour/week, currency in USD. |\n| Invalid Impressions | **string** ([int64](/discovery/v1/type-format) format) Invalid traffic impression in the specified week. |\n| Invalid Impression Cost (USD) | **string** ([int64](/discovery/v1/type-format) format) Invalid traffic impression in the specified week, currency in USD. |"]]
