Display & Video 360 전송 예약

Display & Video 360용 BigQuery Data Transfer Service 커넥터를 사용하면 Display & Video 360 보고와 구성 데이터의 반복되는 로드 작업을 자동으로 예약하고 관리할 수 있습니다.

지원되는 보고서

Display & Video 360용 BigQuery Data Transfer Service는 다음과 같은 보고 옵션을 지원합니다.

데이터 전송 v2(디스플레이 및 동영상 DTv2) 파일

Display & Video 360 보고서가 BigQuery 테이블 및 뷰로 변환되는 방식은 Display & Video 360 데이터 변환을 참조하세요.

Display & Video 360은 최대 60일 동안 데이터 전송 파일을 보관합니다.

보고 옵션	지원
일정	매일, 데이터 전송이 처음 만들어진 시간(기본값) 시간을 구성할 수 있습니다.
새로고침 기간	지난 2일 구성할 수 없음
최대 백필 기간	최근 60일

보고 옵션

지원

일정

매일, 데이터 전송이 처음 만들어진 시간(기본값)

시간을 구성할 수 있습니다.

새로고침 기간

지난 2일

구성할 수 없음

최대 백필 기간

최근 60일

지원되는 구성 데이터

보고 데이터 외에도 BigQuery Data Transfer Service는 Display & Video 360에서 다음 구성 데이터를 전송합니다. 구성 데이터는 Display & Video 360 API v3에서 검색됩니다.

각 구성 데이터 유형에 대한 자세한 내용은 다음 링크를 참조하세요.

시작하기 전에

Display & Video 360 데이터 전송을 만들기 전에 다음 기본 요건 및 정보를 검토하세요.

기본 요건

BigQuery Data Transfer Service 사용 설정에 필요한 모든 작업을 완료했는지 확인합니다.
Display & Video 360 데이터를 저장할 BigQuery 데이터 세트를 만듭니다.
Display & Video 360 파트너 ID 또는 광고주 ID가 있는지 확인합니다. 파트너 ID가 계층 구조의 상위 항목입니다.
Display & Video API에서 파트너 또는 광고주 데이터에 액세스할 수 있는 읽기 권한이 있는지 확인합니다.
조직에서 Display & Video 360 데이터 전송 v2(Display & Video 360 DTv2) 파일에 액세스할 수 있어야 합니다. 이러한 파일은 Display & Video 360팀에서 Cloud Storage 버킷에 전달합니다. Display & Video 360 DTv2 파일에 대한 액세스 요청은 Display & Video 360과 직접 계약했는지 여부에 따라 다릅니다. 두 경우 모두 추가 수수료가 부과될 수 있습니다.
- Display & Video 360과 계약한 경우 Display & Video 360 지원팀에 문의하여 Display & Video 360 DTv2 파일을 설정하세요.
- Display & Video 360과 계약을 맺지 않은 경우 Display & Video 360 DTv2 파일에 액세스하려면 대행사에 문의하세요.
- 이 단계를 완료하면 설정이 파트너 또는 광고주용인지 여부에 따라 다음 Cloud Storage 버킷 이름 중 하나를 받게 됩니다.
  - gs://dcdt_-dbm_partnerPARTNER_ID
  - gs://dcdt_-dbm_advertiserADVERTISER_ID
참고: Google Cloud팀은 사용자를 대신하여 Display & Video 360 DTv2 파일에 대한 액세스 권한을 생성하거나 부여할 수 없습니다. Display & Video 360 DTv2 파일에 액세스하려면 Display & Video 360 지원팀 또는 대행사에 문의하세요.
Pub/Sub의 전송 실행 알림을 설정하려면 pubsub.topics.setIamPolicy 권한이 있어야 합니다. 자세한 내용은 BigQuery Data Transfer Service 실행 알림을 참조하세요.

Display & Video 360 ID 찾기

Display & Video 360 ID를 검색하려면 Google Cloud 콘솔의 Cloud Storage 버킷 페이지로 이동하여 Display & Video 360 데이터 전송 Cloud Storage 버킷의 파일을 조사합니다. Display & Video 360 ID는 제공된 Cloud Storage 버킷의 파일을 일치시키는 데 사용됩니다. ID는 파일 이름에 포함되며 Cloud Storage 버킷 이름에는 포함되지 않습니다. 예를 들면 다음과 같습니다.

이름이 dbm_partner123_activity_*인 파일에서 ID는 123입니다.
이름이 dbm_advertiser567_activity_*인 파일에서 ID는 567입니다.

파일 이름 프리픽스 찾기

드물지만 Cloud Storage 버킷에 있는 파일의 이름이 Google Marketing Platform 서비스팀에서 사용자에게 설정한 커스텀 비표준 파일 이름인 경우가 있습니다. 예를 들면 다음과 같습니다.

이름이 dbm_partner123456custom_activity_*인 파일에서 프리픽스는 dbm_partner123456custom입니다.

파일 이름 프리픽스와 관련된 지원이 필요하면 Display & Video 360 지원팀에 문의하세요.

Display & Video 360 데이터 전송 설정

다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔의 데이터 전송 페이지로 이동합니다.

데이터 전송으로 이동
전송 만들기를 클릭합니다.
전송 만들기 페이지에서 다음을 수행합니다.
- 소스 유형 섹션의 소스에서 Display & Video 360 - 미리보기를 선택합니다.
- 전송 구성 이름 섹션의 표시 이름에 데이터 전송 이름을 입력합니다. 전송 이름은 나중에 수정해야 할 경우를 대비해 간편하게 전송을 식별할 수 있는 값이면 됩니다.
일정 옵션 섹션에서 다음을 수행합니다.
- 지금 시작 또는 설정 시간에 시작을 선택한 다음 시작일과 실행 시간을 제공합니다.
- 반복 빈도에서 데이터 전송을 실행할 빈도 옵션을 선택합니다. 일을 선택한 경우 UTC로 유효한 시간을 제공합니다.
  - 시간
  - 일
  - 주문형
대상 설정 섹션의 대상 데이터 세트 메뉴에서 데이터를 저장하기 위해 만든 데이터 세트를 선택합니다.
데이터 소스 세부정보 섹션에서 다음을 수행합니다.
- Display & Video 360 ID 필드에 파트너 ID 또는 광고주 ID를 입력합니다.
- 선택사항: 알림 옵션 섹션에서 다음을 수행합니다.
  - 전환을 클릭하여 이메일 알림을 사용 설정합니다. 이 옵션을 사용 설정하면 전송 실행이 실패할 때 전송 관리자에게 이메일 알림이 발송됩니다.
  - 전환 버튼을 클릭하여 Pub/Sub 알림을 사용 설정합니다. Cloud Pub/Sub 주제 선택에서 주제 이름을 선택하거나 주제 만들기를 클릭합니다. 이 옵션은 전송에 대한 Pub/Sub 실행 알림을 구성합니다.
저장을 클릭합니다.

bq

bq mk 명령어를 입력하고 전송 생성 플래그 --transfer_config를 지정합니다. 다음 플래그는 필수입니다.

--data_source
--target_dataset
--display_name
--params

  bq mk --transfer_config \
  --project_id=PROJECT_ID \
  --target_dataset=DATASET \
  --display_name=NAME \
  --params='PARAMETERS' \
  --data_source=DATA_SOURCE

각 항목의 의미는 다음과 같습니다.

PROJECT_ID: 프로젝트 ID입니다.
DATASET. 데이터 전송 구성의 대상 데이터 세트입니다.
NAME: 데이터 전송 구성의 표시 이름입니다. 전송 이름은 나중에 수정해야 할 경우를 대비해 간편하게 전송을 식별할 수 있는 값이면 됩니다.
PARAMETERS: JSON 형식으로 생성된 데이터 전송 구성의 파라미터입니다. 예를 들면 --params='{"param":"param_value"}'입니다. Display & Video 360 전송의 경우 bucket 및 displayvideo_id 매개변수가 필요합니다. file_name_prefix 매개변수는 선택사항이며 커스텀 파일 이름인 경우에만 드물게 사용됩니다.
DATA_SOURCE: 데이터 소스 — displayvideo입니다.

예를 들어 다음 명령어는 Display & Video 360 ID 123456, Cloud Storage 버킷 dcdt_-dbm_partner123456, 대상 데이터 세트 mydataset를 사용하여 My Transfer라는 Display & Video 360 데이터 전송을 만듭니다.

기본 프로젝트에 데이터 전송이 생성됩니다.

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

명령어를 실행한 후 다음과 같은 메시지가 수신됩니다.

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

메시지 안내를 따라 명령줄에 인증 코드를 붙여넣습니다.

API

projects.locations.transferConfigs.create 메서드를 사용하고 TransferConfig 리소스의 인스턴스를 지정합니다.

데이터 쿼리

BigQuery로 전송되는 데이터는 수집 시간으로 파티션을 나눈 테이블에 기록됩니다. 자세한 내용은 파티션을 나눈 테이블 소개를 참조하세요.

테이블을 직접 쿼리하는 대신 자동 생성된 뷰를 쿼리하는 것이 좋습니다. 그러나 테이블을 직접 쿼리하려면 쿼리에서 _PARTITIONTIME 유사 열을 사용해야 합니다. 자세한 내용은 파티션을 나눈 테이블 쿼리를 참조하세요.