- 리소스: Report
- ReportDefinition
- 크기
- 측정항목
- 필터
- FieldFilter
- Field
- 작업
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- 날짜
- RelativeDateRange
- 정렬
- 메서드
리소스: Report
Report 리소스
| JSON 표현 |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| 필드 | |
|---|---|
name |
식별자. 보고서의 리소스 이름입니다. 보고서 리소스 이름의 형식은 |
reportId |
출력 전용입니다. 보고서 ID입니다. |
reportDefinition |
필수 항목입니다. 보고서의 보고서 정의입니다. |
displayName |
선택사항입니다. 보고서의 표시 이름입니다. |
updateTime |
출력 전용입니다. 이 보고서가 마지막으로 수정된 시점입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
createTime |
출력 전용입니다. 이 보고서가 생성된 시점입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
locale |
출력 전용입니다. 이 보고서의 언어입니다. 언어는 요청 시 사용자의 언어로 설정됩니다. 언어는 수정할 수 없습니다. |
ReportDefinition
보고서 실행 방법에 대한 정의입니다.
| JSON 표현 |
|---|
{ "dimensions": [ enum ( |
| 필드 | |
|---|---|
dimensions[] |
필수 항목입니다. 보고할 측정기준 목록입니다. 비어 있으면 보고서에 측정기준이 없고 모든 측정항목이 합계가 됩니다. |
metrics[] |
필수 항목입니다. 보고할 측정항목 목록입니다. 비어 있으면 보고서에 측정항목이 없습니다. |
filters[] |
선택사항입니다. 이 보고서의 필터입니다. |
timeZoneSource |
선택사항입니다. 이 보고서의 시간대를 가져올 위치입니다. 기본값은 태평양 시간대 (PT)입니다. 소스가 PROVIDED인 경우 보고서 정의의 timeZone 필드도 시간대를 설정해야 합니다. |
timeZone |
선택사항입니다. timeZoneSource가 PROVIDED인 경우 이 보고서에 사용할 시간대입니다. 다른 시간대 소스의 경우 비워 둡니다. IANA 형식의 시간대입니다. 예를 들면 'America/New_York'입니다. |
currencyCode |
선택사항입니다. 이 보고서의 ISO 4217 통화 코드입니다. 지정하지 않으면 계정 통화 코드가 기본값으로 사용됩니다. |
dateRange |
필수 항목입니다. 이 보고서의 기본 기간입니다. |
sorts[] |
선택사항입니다. 이 보고서에 적용할 기본 정렬입니다. |
측정기준
보고 측정기준
| 열거형 | |
|---|---|
DIMENSION_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
ADVERTISER_DOMAIN |
광고주의 도메인입니다. |
COUNTRY |
국가의 표시 이름입니다. |
CURATION_DATA_SEGMENT_ID |
큐레이터가 만든 데이터 세그먼트의 ID입니다. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS |
실시간 선별의 데이터 세그먼트 요청 응답 상태입니다. 자세한 내용은 https://developers.google.com/authorized-buyers/curation/get-started/start를 참고하세요. |
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME |
실시간 선별에서 데이터 세그먼트 요청의 응답 상태를 현지화한 표시 이름입니다. 자세한 내용은 https://developers.google.com/authorized-buyers/curation/get-started/start를 참고하세요. |
CURATOR_FEE_TYPE |
큐레이션 서비스 유형 (예: 패키징 또는 데이터 세그먼트)입니다. |
DATE |
날짜. |
DEAL_ID |
거래 ID입니다. |
DEAL_NAME |
거래 이름 |
DETECTED_ADVERTISER_NAME |
감지된 광고주의 표시 이름입니다. |
DSP_NAME |
DSP의 표시 이름입니다. |
DSP_SEAT_ID |
DSP 시트 ID입니다. |
ENVIRONMENT |
노출이 발생한 사용자 기기 및 컨테이너 환경입니다. 지원되는 값은 'app' 및 'web'입니다. |
ENVIRONMENT_NAME |
노출이 발생한 사용자 기기 및 컨테이너 환경의 현지화된 표시 이름입니다. 지원되는 값은 'app' 및 'web'입니다. |
HOLDING_COMPANY_NAME |
지주 회사의 표시 이름입니다. |
HOUR |
시간. |
MOBILE_APP_ID |
모바일 앱 ID입니다. |
MOBILE_APP_NAME |
모바일 앱 이름 |
MOBILE_OS |
모바일 운영체제 |
MONTH |
월을 탭합니다. |
PACKAGE_FEE_VISIBILITY |
패키지 수수료의 공개 상태 (예: 공개 또는 비공개) |
PLATFORM |
플랫폼(예: '데스크톱'과 '모바일') |
PUBLISHER_DOMAIN |
게시자 도메인입니다. |
PUBLISHER_ID |
게시자 식별자입니다. |
PUBLISHER_NAME |
게시자 이름입니다. |
WEEK |
주 |
측정항목
보고서 측정항목
| 열거형 | |
|---|---|
METRIC_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
ACTIVE_VIEW_MEASURABILITY_RATE |
Active View 측정 가능 노출률 |
ACTIVE_VIEW_MEASURABLE |
측정 가능 Active View |
ACTIVE_VIEW_VIEWABILITY_RATE |
Active View 조회가능 노출률입니다. |
ACTIVE_VIEW_VIEWABLE |
조회 가능 Active View 노출수 |
AUCTIONS_WON |
낙찰받은 입찰 수 |
BIDS |
입찰가 |
BIDS_IN_AUCTION |
입찰에 참여한 입찰가의 수 |
BID_REQUESTS |
입찰 요청 |
CLICKS |
클릭수 |
CURATION_PARTNER_FEE |
큐레이터 수수료 패키지의 공개 상태가 비공개로 설정된 경우 0.00으로 수정됩니다. PACKAGE_FEE_VISIBILITY 측정기준을 사용하여 패키지 수수료가 공개되었는지 확인합니다. |
DATA_SEGMENT_REQUESTS |
실시간 선별에서 전송된 데이터 세그먼트 요청 수입니다. |
IMPRESSIONS |
노출수 |
SPEND |
요청에 지정된 보고 통화로 표시된 지출입니다. 기본값은 USD입니다. |
필터
하나 이상의 필드에 대한 필터입니다.
| JSON 표현 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fieldFilter": { object ( |
| 필드 | |
|---|---|
| 유형에 따라 기본 필터가 결합되는 방식이 결정됩니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
fieldFilter |
단일 필드의 필터입니다. |
notFilter |
결과가 부정되는 필터입니다. |
andFilter |
결과가 AND 연산되는 필터 목록입니다. |
orFilter |
결과가 OR 연산되는 필터 목록입니다. |
| 상호 배타적 필드의 끝입니다. | |
FieldFilter
특정 필드의 필터입니다.
| JSON 표현 |
|---|
{ "field": { object ( |
| 필드 | |
|---|---|
field |
필수 항목. 필터링할 필드입니다. |
operation |
필수 항목입니다. 이 필터의 작업입니다. |
values[] |
필수 항목입니다. 필터링할 값입니다. |
필드
보고서의 측정기준 또는 측정항목입니다.
| JSON 표현 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "dimension": enum ( |
| 필드 | |
|---|---|
| 측정기준 또는 측정항목입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
dimension |
이 필드가 나타내는 측정기준입니다. |
metric |
이 필드가 나타내는 측정항목입니다. |
| 상호 배타적 필드의 끝입니다. | |
작업
지원되는 필터 작업입니다.
| 열거형 | |
|---|---|
IN |
스칼라 피연산자의 경우 피연산자가 제공된 필터 값 집합에 있는지 확인합니다. 목록 피연산자의 경우 피연산자의 요소가 제공된 필터 값 집합에 있는지 확인합니다. 기본값 |
NOT_IN |
스칼라 피연산자의 경우 피연산자가 제공된 필터 값 집합에 없는지 확인합니다. 목록 피연산자의 경우 피연산자의 요소가 제공된 필터 값 집합에 없는지 확인합니다. |
CONTAINS |
스칼라 문자열 피연산자의 경우 피연산자에 제공된 필터 하위 문자열이 포함되어 있는지 확인합니다. 문자열 목록 피연산자의 경우 피연산자의 문자열에 제공된 필터 하위 문자열이 포함되어 있는지 확인합니다. |
NOT_CONTAINS |
스칼라 문자열 피연산자의 경우 피연산자에 제공된 필터 하위 문자열이 포함되어 있지 않은지 확인합니다. 문자열 목록 피연산자의 경우 피연산자의 문자열에 제공된 필터 하위 문자열이 포함되어 있지 않은지 확인합니다. |
LESS_THAN |
피연산자가 제공된 필터 값보다 작습니다. |
LESS_THAN_EQUALS |
피연산자가 제공된 필터 값보다 작거나 같습니다. |
GREATER_THAN |
피연산자가 제공된 필터 값보다 큽니다. |
GREATER_THAN_EQUALS |
피연산자가 제공된 필터 값보다 크거나 같습니다. |
BETWEEN |
피연산자가 제공된 필터 값 사이에 있습니다. |
MATCHES |
피연산자가 정규 표현식 또는 정규 표현식 집합과 일치합니다 (하나가 일치해야 함). |
NOT_MATCHES |
피연산자가 정규 표현식 또는 정규 표현식 집합과 일치하지 않습니다 (일치하는 항목이 없어야 함). |
ReportValue
보고서의 단일 값을 나타냅니다.
| JSON 표현 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "intValue": string, "doubleValue": number, "stringValue": string, "boolValue": boolean, "intListValue": { object ( |
| 필드 | |
|---|---|
| 필드 값은 필드의 데이터 형식에 따라 달라집니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
intValue |
정수 값 |
doubleValue |
double 값입니다. |
stringValue |
문자열 값의 경우 |
boolValue |
불리언 값입니다. |
intListValue |
정수 값 목록입니다. |
stringListValue |
문자열 값 목록입니다. |
doubleListValue |
Double 값 목록입니다. |
bytesValue |
바이트 값입니다. base64 인코딩 문자열입니다. |
| 상호 배타적 필드의 끝입니다. | |
IntList
정수 값 목록입니다.
| JSON 표현 |
|---|
{ "values": [ string ] } |
| 필드 | |
|---|---|
values[] |
값 |
StringList
문자열 값 목록입니다.
| JSON 표현 |
|---|
{ "values": [ string ] } |
| 필드 | |
|---|---|
values[] |
값 |
DoubleList
이중 값 목록입니다.
| JSON 표현 |
|---|
{ "values": [ number ] } |
| 필드 | |
|---|---|
values[] |
값 |
FilterList
필터 목록입니다.
| JSON 표현 |
|---|
{
"filters": [
{
object ( |
| 필드 | |
|---|---|
filters[] |
필수 항목입니다. 필터 목록입니다. |
TimeZoneSource
보고서의 시간대를 결정하는 소스입니다.
| 열거형 | |
|---|---|
TIME_ZONE_SOURCE_UNSPECIFIED |
지정되지 않은 기본값입니다. |
AD_EXCHANGE |
태평양 시간대(PT)를 사용합니다. |
UTC |
UTC 시간대를 사용합니다. |
PROVIDED |
ReportDefinition.time_zone 필드에 제공된 시간대를 사용합니다. 요청 시 날짜가 동적으로 계산되므로 보고서를 실행하는 데 시간이 더 오래 걸릴 수 있습니다. |
CURATOR |
큐레이터의 계정 설정에 있는 시간대를 사용합니다. |
DateRange
보고서의 기간입니다.
| JSON 표현 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "fixed": { object ( |
| 필드 | |
|---|---|
| 고정 또는 상대 기간입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
fixed |
고정 기간 |
relative |
상대 기간입니다. |
| 상호 배타적 필드의 끝입니다. | |
FixedDateRange
두 고정 날짜 사이의 기간입니다 (종료일 포함).
| JSON 표현 |
|---|
{ "startDate": { object ( |
| 필드 | |
|---|---|
startDate |
필수 항목입니다. 이 기간의 시작일입니다. |
endDate |
필수 항목입니다. 이 기간의 종료일 (해당 날짜 포함)입니다. |
날짜
생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0(예: 기념일)
- 연도만, 월과 일은 0
- 연도와 월, 일은 0(예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON 표현 |
|---|
{ "year": integer, "month": integer, "day": integer } |
| 필드 | |
|---|---|
year |
날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day |
월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다. |
RelativeDateRange
상대 기간 옵션입니다.
| 열거형 | |
|---|---|
RELATIVE_DATE_RANGE_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
TODAY |
보고서가 실행된 날짜입니다. |
YESTERDAY |
보고서가 실행되는 날짜의 전날입니다. |
THIS_WEEK_TO_DATE |
보고서가 실행되는 날짜를 포함하여 해당 주의 시작일부터의 데이터입니다. |
THIS_WEEK_TO_YESTERDAY |
보고서가 실행되는 달력상 주의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다. |
THIS_MONTH_TO_DATE |
보고서가 실행된 달의 시작일부터 보고서가 실행된 날까지(해당 날짜 포함)입니다. |
THIS_MONTH_TO_YESTERDAY |
보고서가 실행된 달의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다. |
THIS_QUARTER_TO_DATE |
보고서가 실행되는 분기의 시작일부터 보고서가 실행되는 날짜까지(해당 날짜 포함)입니다. |
THIS_QUARTER_TO_YESTERDAY |
보고서가 실행되는 분기의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다. |
THIS_YEAR_TO_DATE |
보고서가 실행된 연도의 시작일부터 보고서가 실행된 날짜까지(해당 날짜 포함)입니다. |
THIS_YEAR_TO_YESTERDAY |
보고서가 실행되는 연도의 시작일부터 보고서가 실행되기 전날까지(해당 날짜 포함)입니다. |
LAST_WEEK |
보고서가 실행되는 주 이전의 전체 주 (월요일부터 일요일까지)입니다. |
LAST_WEEK_STARTING_SUNDAY |
보고서가 실행되는 주 이전의 전체 주 (일요일부터 토요일까지)입니다. |
LAST_MONTH |
보고서가 실행되는 달의 이전 달 전체입니다. |
LAST_QUARTER |
보고서가 실행되는 분기 이전의 전체 분기입니다. |
LAST_YEAR |
보고서가 실행되는 연도 이전의 전체 연도입니다. |
LAST_7_DAYS |
보고서 실행일 이전 7일 |
LAST_30_DAYS |
보고서 실행일 이전 30일 |
LAST_60_DAYS |
보고서 실행일 이전 60일 |
LAST_90_DAYS |
보고서 실행일 이전 90일 |
LAST_93_DAYS |
보고서 실행일 이전 93일 |
LAST_180_DAYS |
보고서 실행일 이전 180일 |
LAST_360_DAYS |
보고서 실행일 이전 360일 |
LAST_365_DAYS |
보고서 실행일 이전 365일 |
LAST_3_MONTHS |
보고서가 실행되는 달 이전의 전체 3개월입니다. |
LAST_6_MONTHS |
보고서가 실행되는 달 이전의 전체 6개월입니다. |
LAST_12_MONTHS |
보고서가 실행되는 달 이전의 12개월 전체입니다. |
ALL_AVAILABLE |
보고서 실행일 3년 전부터 보고서 실행일 전날까지(해당 날짜 포함)입니다. |
정렬
보고서의 정렬을 나타냅니다.
| JSON 표현 |
|---|
{
"field": {
object ( |
| 필드 | |
|---|---|
field |
필수 항목입니다. 정렬할 필드 (측정기준 또는 측정항목)입니다. |
descending |
선택사항입니다. 정렬 순서입니다. true이면 내림차순으로 정렬됩니다. |
메서드 |
|
|---|---|
|
Report 객체를 만듭니다. |
|
Report 객체를 삭제합니다. |
|
Report 객체를 가져옵니다. |
|
Report 객체를 나열합니다. |
|
Report 객체를 업데이트합니다. |
|
기존 보고서의 실행을 비동기식으로 시작합니다. |