Method: customers.submitBrandLiftStudyReport

  • The submitBrandLiftStudyReport method initiates the import of a brand lift study report from a specified BigQuery table into Ads Data Hub (ADH).

  • The HTTP request uses a POST method and includes the customer identifier in the URL path.

  • The request body requires the date of the study report and the source BigQuery table in the format 'project.dataset.table_name', with an optional instance name.

  • A successful response contains an instance of Operation.

  • The request requires the https://www.googleapis.com/auth/adsdatahub OAuth scope for authorization.

Starts ADH import of a specified BigQuery table populated with the brand lift study report generated by the customer. This is called by the customer to trigger ADH to import the report.

HTTP request

POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandLiftStudyReport

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. Ads Data Hub customer making the request. This is in the form of 'customers/[customerId]'. e.g. 'customers/123'.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "date": {
    object (Date)
  },
  "sourceTable": string,
  "instance": string
}
Fields
date

object (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.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adsdatahub