# SubmitBrandLiftReportMetadata

- [JSON representation](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SCHEMA_REPRESENTATION)
- [SubmitBrandLiftBenchmarkRequest](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftBenchmarkRequest)
  - [JSON representation](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftBenchmarkRequest.SCHEMA_REPRESENTATION)
- [SubmitBrandLiftStudyReportRequest](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftStudyReportRequest)
  - [JSON representation](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftStudyReportRequest.SCHEMA_REPRESENTATION)

Metadata for customer brand lift report submission request associated with each operation.

| JSON representation |
|---|
| ``` { "startTime": string, "endTime": string, // Union field `request` can be only one of the following: "benchmark": { object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftBenchmarkRequest`) }, "studyReport": { object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftStudyReportRequest`) } // End of list of possible types for union field `request`. } ``` |

| Fields ||
|---|---|
| `startTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Import start time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `endTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Import end time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| Union field `request`. Request of submitting a brand lift report. This will be either a benchmark or a study report. `request` can be only one of the following: ||
| `benchmark` | ``object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftBenchmarkRequest`)`` Request for brand lift quarter benchmark report submission. |
| `studyReport` | ``object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/SubmitBrandLiftReportMetadata#SubmitBrandLiftStudyReportRequest`)`` Request for brand lift study report submission. |

## SubmitBrandLiftBenchmarkRequest

Request to submit a customer generated brand lift quarter benchmark report.

| JSON representation |
|---|
| ``` { "customer": string, "year": integer, "quarter": integer, "sourceTable": string, "instance": string } ``` |

| Fields ||
|---|---|
| `customer` | `string` Required. Ads Data Hub customer making the request. This is in the form of 'customers/\[customerId\]'. e.g. 'customers/123'. |
| `year` | `integer` Required. Year that the benchmark report is for. In the format of YYYY(e.g., 2023). |
| `quarter` | `integer` Required. Quarter that the benchmark report is for. Allowed values are 1, 2, 3, 4. e.g., when submitting report for 2023 Q1, the value should be 1. |
| `sourceTable` | `string` Required. Source BigQuery table for query results in the format 'project.dataset.table_name'. The project, dataset, and table_name must all be provided explicitly. Please refer to Brand Lift Benchmark Schema on ADH Dev Site for detailed schema requirements about the table. |
| `instance` | `string` Optional. The name of the submission feed instance. This shouldn't be populated for the production brand lift feed, but can be filled out with a prearranged instance name when a vendor works with Google to test a new or alternate version of their submission feed. |

## SubmitBrandLiftStudyReportRequest

Request to submit a customer generated brand lift study report.

| JSON representation |
|---|
| ``` { "customer": string, "date": { object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/Date`) }, "sourceTable": string, "instance": string } ``` |

| Fields ||
|---|---|
| `customer` | `string` Required. Ads Data Hub customer making the request. This is in the form of 'customers/\[customerId\]'. e.g. 'customers/123'. |
| `date` | ``object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/Date`)`` Required. Date that the study report is for. |
| `sourceTable` | `string` Required. Source BigQuery table for query results in the format 'project.dataset.table_name'. The project, dataset, and table_name must all be provided explicitly. Please refer to Brand Lift Benchmark Schema on ADH Dev Site for detailed schema requirements about the table. |
| `instance` | `string` Optional. The name of the submission feed instance. This shouldn't be populated for the production brand lift feed, but can be filled out with a prearranged instance name when a vendor works with Google to test a new or alternate version of their submission feed. |