This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
[[["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\u003eAds Data Hub Customer resource provides access to customer-level information and operations.\u003c/p\u003e\n"],["\u003cp\u003eCustomers are uniquely identified by a \u003ccode\u003ename\u003c/code\u003e in the format \u003ccode\u003ecustomers/[customerId]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA variety of methods are available for managing and interacting with customer data, including retrieving customer details, exporting job history, generating reports, and submitting data.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods focus on importing specific data types such as Brand Lift, Brand Safety Scores, and vendor reports.\u003c/p\u003e\n"],["\u003cp\u003eCustomer methods also provide functionalities like describing valid DV360 advertiser IDs and checking import completion status.\u003c/p\u003e\n"]]],["The document defines the \"Customer\" resource in Ads Data Hub, identified by a unique name, customer ID, and display name. Key actions include: retrieving customer details; listing accessible customers; exporting job history to BigQuery; and generating reports for DV360 invalid traffic and general invalid traffic. Also supported are methods to import customer-generated reports like brand lift, brand safety scores, vendor summary, and ID mapping reports. There is also a method to describe valid DV360 advertiser IDs.\n"],null,["- [Resource: Customer](#Customer)\n - [JSON representation](#Customer.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Customer An Ads Data Hub customer.\n\n| JSON representation |\n|-------------------------------------------------------------------------|\n| ``` { \"name\": string, \"customerId\": string, \"displayName\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Name that uniquely identifies a customer. It should have the form customers/\\[customerId\\], e.g. 'customers/123'. |\n| `customerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Ads Data Hub customer ID. |\n| `displayName` | `string` Descriptive customer name. |\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| [describeValidDv360AdvertiserIds](/ads-data-hub/reference/rest/v1/customers/describeValidDv360AdvertiserIds) | Describes the valid DV360 AdvertiserIds |\n| [describeValidFrequencyLimitingEventMatchers](/ads-data-hub/reference/rest/v1/customers/describeValidFrequencyLimitingEventMatchers)` ` **(deprecated)** | Lists valid event matchers along with their metadata for frequency capping audience lists. |\n| [exportJobHistory](/ads-data-hub/reference/rest/v1/customers/exportJobHistory) | Exports job history of a customer account to customer-selected BigQuery dataset. |\n| [generateDv360IvtVideoViewabilityReport](/ads-data-hub/reference/rest/v1/customers/generateDv360IvtVideoViewabilityReport) | Starts the execution of a query to retrieve invalid traffic viewability metrics for the DV360 platform. |\n| [generateIvtReport](/ads-data-hub/reference/rest/v1/customers/generateIvtReport) | Starts the execution of a query to retrieve a day-by-day summary of invalid traffic counts for a specific platform. |\n| [get](/ads-data-hub/reference/rest/v1/customers/get) | Retrieves the requested Ads Data Hub customer. |\n| [getImportCompletionStatus](/ads-data-hub/reference/rest/v1/customers/getImportCompletionStatus) | Returns the percentage of Google data across all customers that has successfully been ingested into ADH on the given date. |\n| [list](/ads-data-hub/reference/rest/v1/customers/list) | Lists Ads Data Hub customers to which the current user has access. |\n| [submitBrandLiftBenchmark](/ads-data-hub/reference/rest/v1/customers/submitBrandLiftBenchmark) | Starts ADH import of a specified BigQuery table populated with the quarterly brand lift benchmark report generated by the customer. |\n| [submitBrandLiftStudyReport](/ads-data-hub/reference/rest/v1/customers/submitBrandLiftStudyReport) | Starts ADH import of a specified BigQuery table populated with the brand lift study report generated by the customer. |\n| [submitBrandSafetyScores](/ads-data-hub/reference/rest/v1/customers/submitBrandSafetyScores) | Starts ADH import of a specified BigQuery table populated with the vendor's Brand Safety score file. |\n| [submitVendorAggregatesReport](/ads-data-hub/reference/rest/v1/customers/submitVendorAggregatesReport) | Starts ADH import of a specified BigQuery table populated with the vendor's summary report for a given metric. |\n| [submitVendorReportIdMapping](/ads-data-hub/reference/rest/v1/customers/submitVendorReportIdMapping) | Starts ADH import of a specified BigQuery table populated with the mapping between customer defined report ID and Google campaign ID. |"]]
