Method: customers.generateIvtReport

특정 플랫폼의 무효 트래픽 수에 대한 일별 요약을 검색하기 위해 쿼리 실행을 시작합니다. 지정된 BigQuery 대상 테이블에 결과가 기록됩니다. 반환된 작업 이름을 사용하여 쿼리 완료 상태를 폴링할 수 있습니다.

출력 표에는 기간의 각 날짜에 대해 5개의 행이 포함됩니다. 4개 기기 유형에 대한 행 1개, 모든 기기 유형에 대해 행 1개 '전체' 행은 그날의 기기 유형 4개의 합계입니다. 따라서 각 열에는 총 노출수가 두 배로 포함됩니다. 개인 정보 보호 제한으로 인해 ADH에서 행을 수정하는 경우 필터링된 행 요약(날짜가 없는 행)에는 수정된 행의 합계가 포함됩니다.

HTTP 요청

POST https://adsdatahub.googleapis.com/v1/{name=customers/*}:generateIvtReport

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

요청을 보낸 Ads Data Hub 고객입니다. 형식은 고객/[customerId]의 형태입니다(예: &customers/123').

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "adsDataCustomerId": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "destTable": string,

  // Union field platform_dimensions can be only one of the following:
  "googleAdsDimensions": {
    object (GoogleAdsDimensions)
  },
  "dv360YoutubeDimensions": {
    object (Dv360Dimensions)
  },
  "ytReserveDimensions": {
    object (YouTubeReserveDimensions)
  }
  // End of list of possible types for union field platform_dimensions.
}
필드
adsDataCustomerId

string (int64 format)

광고 데이터를 소유한 연결된 Ads Data Hub 고객 ID입니다.
startDate

object (Date)

생성된 보고서의 첫날입니다.
endDate

object (Date)

생성된 보고서의 마지막 날(포함)
timeZone

string

선택사항. 보고서 시작일 및 종료일의 시간대입니다. 지정하지 않으면 기본값은 'UTC&#39'입니다.
destTable

string

'project.dataset.table_name' 형식의 쿼리 결과 대상 BigQuery 테이블 지정된 경우 프로젝트는 고객의 ADH 계정에 대해 명시적으로 허용되어야 합니다. 프로젝트를 지정하지 않으면 제공된 고객의 기본 프로젝트가 사용됩니다. 프로젝트 및 데이터 세트를 모두 지정하지 않으면 기본 프로젝트 및 데이터 세트가 사용됩니다.
통합 필드 platform_dimensions는 선택적 플랫폼별 슬라이싱을 사용하여 보고할 플랫폼입니다. 플랫폼을 선택하지 않으면 오류가 발생합니다. platform_dimensions은 다음 중 하나여야 합니다.
googleAdsDimensions

object (GoogleAdsDimensions)

Google Ads 플랫폼 보고서
dv360YoutubeDimensions

object (Dv360Dimensions)

플랫폼 DV360에 대해 보고합니다.
ytReserveDimensions

object (YouTubeReserveDimensions)

YTR 플랫폼을 보고합니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

Google Ads 측정기준

Google Ads 플랫폼의 필터링 측정기준

JSON 표현 
{
  "campaignIds": [
    string
  ],
  "metricType": enum (MetricType)
}
필드
campaignIds[]

string (int64 format)

Google Ads 캠페인 ID입니다(선택사항). 비워 두면 지정된 기간의 모든 캠페인이 보고됩니다.
metricType

enum (MetricType)

측정하고 보고할 플랫폼을 지정합니다.

MetricType

측정하고 보고할 플랫폼을 지정합니다.

열거형
METRIC_TYPE_UNSPECIFIED 지정되지 않은 측정항목 유형입니다.
METRIC_TYPE_IMPRESSION Google Ads 노출 데이터입니다.
METRIC_TYPE_YOUTUBE_VIEW YouTube 조회수(즉, TrueView 조회수)입니다.

DV360크기

DV360 플랫폼의 필터링 측정기준

JSON 표현 
{
  "lineItemIds": [
    string
  ],
  "metricType": enum (MetricType)
}
필드
lineItemIds[]

string (int64 format)

DV360 광고 항목 ID(선택사항) 비워 두면 지정된 기간의 모든 광고 항목이 보고됩니다.
metricType

enum (MetricType)

측정하고 보고할 플랫폼을 지정합니다.

YouTube ReserveDimension

YouTube Reserve 플랫폼의 필터링 측정기준

JSON 표현 
{
  "orderIds": [
    string
  ],
  "metricType": enum (MetricType)
}
필드
orderIds[]

string (int64 format)

YouTube Reserve 주문 ID입니다(선택사항). 비워 두면 지정된 기간의 모든 주문이 보고됩니다.
metricType

enum (MetricType)

측정하고 보고할 플랫폼을 지정합니다.