이 페이지는 Cloud Translation API를 통해 번역되었습니다.

YouTube 통합 (DV360)

이 페이지에서는 Display & Video 360 (DV360)을 Cortex Framework Data Foundation의 마케팅 워크로드 데이터 소스로 사용하여 YouTube에서 데이터를 가져오는 데 필요한 구성을 설명합니다.

DV360은 Google의 광고 플랫폼으로, 다른 디지털 채널과 함께 YouTube 광고를 관리하여 광고주가 마케팅 활동을 더욱 효과적으로 관리하고 효율성을 높일 수 있도록 지원합니다.

다음 다이어그램은 Cortex Framework Data Foundation의 마케팅 워크로드를 통해 DV360 데이터를 사용하는 방법을 설명합니다.

DV360 데이터 소스

그림 1 DV360 데이터 소스

구성 파일

config.json 파일은 다양한 워크로드에서 데이터를 전송하기 위해 데이터 소스에 연결하는 데 필요한 설정을 구성합니다. 이 파일에는 DV360의 다음 매개변수가 포함됩니다.

   "marketing": {
        "deployDV360": true,
        "DV360": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_DV360"
            }
        }
   }

다음 표에는 각 마케팅 매개변수의 값이 설명되어 있습니다.

매개변수	의미	기본값	설명
`marketing.deployDV360`	DV360 배포	`true`	DV360 데이터 소스의 배포를 실행합니다.
`marketing.DV360.deployCDC`	DV360용 CDC 스크립트 배포	`true`	Cloud Composer에서 DAG로 실행할 DV360 CDC 처리 스크립트를 생성합니다.
`marketing.DV360.datasets.cdc`	DV360용 CDC 데이터 세트	-	DV360용 CDC 데이터 세트
`marketing.DV360.datasets.raw`	DV360용 원시 데이터 세트	-	DV360용 원시 데이터 세트입니다.
`marketing.DV360.datasets.reporting`	DV360 보고 데이터 세트	`REPORTING_DV360`	DV360의 보고 데이터 세트입니다.

데이터 모델

이 섹션에서는 항목 관계 다이어그램 (ERD)을 사용하여 YouTube (DV360 포함) 데이터 모델을 설명합니다.

그림 2 YouTube (DV360 포함): 항목 관계 다이어그램

보고 보기

ERD의 파란색 객체는 집계 측정항목이 포함된 보고 뷰를 나타냅니다. src/marketing/src/DV360/src/reporting/ddls에서 스크립트를 확인하세요.

DV360 원시 데이터 추출 설정

Cortex Framework는 즉시 보고 기능을 사용하여 DV360과 통합됩니다. 빠른 보고서는 DV360의 안정적이고 저렴한 기본 제공 기능으로, 더 크고 복잡한 보고서를 파일 및 다양한 위치에 저장, 예약, 다운로드할 수 있습니다. 각 보고서는 선택한 기간의 데이터가 포함된 동일한 구성의 테이블 이름 접두사로 BigQuery에 내보내기 데이터 테이블을 정기적으로 만듭니다. 이 테이블은 선택한 빈도로 생성됩니다.

권한

즉시 보고를 사용하여 DV360에서 원시 데이터를 내보내려면 다음 권한이 있는 사용자가 필요합니다.

DV360:
- 선택한 파트너 또는 광고주의 표준 액세스
Google Cloud:
- DV360 서비스 계정에 할당된 BigQuery User 역할
- DV360 서비스 계정에 할당된 BigQuery Data Editor 역할

설정

DV360에서 원시 테이블 내보내기를 설정하려면 다음 단계를 따르세요.

BigQuery Exporter 계정 연결, 권한 세부정보 섹션에서 DV360 BigQuery Exporter에 필요한 서비스 계정을 확인합니다. 자세한 내용은 그림 2를 참고하세요.
그림 2. BigQuery Exporter 계정 연결에서 서비스 계정 식별하기
Google Cloud 권한을 가져옵니다. BigQuery Administrator 역할을 가진 사용자가 이전 단계에서 식별된 DV360 서비스 계정에 BigQuery User 및 BigQuery Data Editor 역할을 부여해야 합니다.
BigQuery를 DV360에 연결하고 프로세스에 사용할 원시 데이터 세트를 지정합니다. 오프라인 보고 > BigQuery 사용 설정 섹션의 안내를 따릅니다.

즉시 보고로 이동하여 다음 표의 각 행에 대해 열이 표시된 대로 정확하게 포함된 보고서를 하나씩 만듭니다. src/DV360/config/table_schema 아래의 자세한 열 스키마 정의 파일에 관한 자세한 내용은 CDC 테이블 스키마의 원시 데이터 섹션을 참고하세요.

파트너 또는 광고주 필터를 하나 이상 추가합니다. 3단계의 BigQuery 링크 권한과 일치하는지 확인합니다.

보고서의 시간대 설정으로 광고주 시간대를 선택합니다. 자세한 내용은 다음 섹션 추가 고려사항을 참고하세요.

테이블 접두사	포함할 필드
`lineitem_details`	날짜 광고 항목 ID 광고 항목 캠페인 ID 캠페인 광고 항목 유형 광고 항목 시작일 광고 항목 종료일	노출수
`lineitem_insights`	날짜 광고 항목 ID 기기 유형 브라우저 환경 국가 파트너 ID 파트너 파트너 통화 광고주 ID Advertiser 광고주 통화 캠페인 ID 캠페인 게재 신청서 ID 게재 신청서 광고 항목 광고 항목 유형 광고 항목 시작일 광고 항목 종료일	노출수 클릭수 수익 (USD) 참여 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`adgroup_insights_by_age_gender`	날짜 YouTube 광고그룹 ID 연령 (YouTube) 성별 광고 항목 ID 파트너 ID 파트너 파트너 통화 AdvertiserID Advertiser 광고주 통화 게재 신청서 ID 게재 신청서 광고 항목 YouTube 광고 그룹	수익 (USD) 노출수 클릭수 참여도 (YouTube) 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`adgroup_insights_by_audience`	날짜 YouTube 광고그룹 ID 잠재고객 세그먼트 잠재고객 세그먼트 유형 광고 항목 ID 파트너 ID 파트너 PartnerCurrency 광고주 ID Advertiser 광고주 통화 게재 신청서 ID 게재 신청서 광고 항목	노출수 클릭수 YouTube 광고 그룹 수익 (USD) 참여도 (YouTube) 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`adgroup_insights_by_adformat`	날짜 YouTube 광고그룹 ID YouTube 광고 형식 광고 항목 ID 파트너 ID 파트너 파트너 통화 광고주 ID Advertiser 광고주 통화 게재 신청서 ID 게재 신청서 광고 항목	노출수 클릭수 YouTube 광고 그룹 수익 (USD) 참여도 (YouTube) 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`adgroup_insights_by_placement`	날짜 YouTube 광고그룹 ID 게재위치 (모든 YouTube 채널) 게재위치 이름 (모든 YouTube 채널) 광고 항목 ID PartnerID 파트너 파트너 통화 광고주 ID Advertiser 광고주 통화 게재 신청서 ID 게재 신청서 광고 항목	노출수 YouTube 광고 그룹 수익 (USD) 참여도 (YouTube) 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`adgroup_insights_by_adtype`	날짜 YouTube 광고그룹 ID YouTube 광고 유형 광고 항목 ID 파트너 ID 파트너 파트너 통화 광고주 ID Advertiser 광고주 통화 게재 신청서 ID 게재 신청서 광고 항목	노출수 클릭수 YouTube 광고 그룹 수익 (USD) 참여도 (YouTube) 수익 (파트너 통화) 수익 (광고주 통화) TrueView: 조회수
`ad_insights`	날짜 YouTube 광고 ID 광고 항목 ID 파트너 ID 파트너 파트너 통화 광고주 ID Advertiser AdvertiserCurrency 게재 신청서 ID 게재 신청서 광고 항목 YouTube 광고그룹 ID YouTube 광고 그룹 YouTube 광고	노출수 클릭수 수익 (USD) 참여도 (YouTube) 수익 (파트너 통화) 수익 (AdvCurrency) TrueView: 조회수

일정을 설정하고 이전 데이터를 입력합니다. 1단계에서 구성한 것과 동일한 BigQuery 링크와 이전 표에 표시된 것과 정확히 동일한 테이블 접두사를 사용해야 합니다. 자세한 내용은 다음 섹션 추가 고려사항을 참고하세요.
- 백필 실행을 수동으로 트리거하거나 예약된 내보내기가 시작될 때까지 기다립니다. 어느 쪽이든 데이터는 BigQuery 연결에 구성된 원시 데이터 세트에 자동으로 저장됩니다.

추가 고려사항

시간대 선택과 관련하여 다음 사항을 참고하세요.

일부 보고서 유형의 경우 내보내기를 설정할 때 날짜의 광고주 시간대 또는 UTC 시간대를 선택할 수 있습니다. 하지만 YouTube 관련 보고서는 광고주 시간대만 지원합니다. 따라서 내보내기를 설정할 때 광고주 시간대 설정을 선택해야 합니다.
보고서 내보내기는 일일 수준으로 사전 집계되므로 Cortex Framework는 시간대 변환 없이 제공된 날짜를 직접 사용합니다. 보고된 시간대 정보를 해석하는 것은 개발자의 책임입니다.

이전 데이터 예약 및 백필에 관한 정보는 다음을 참고하세요.

내보내기 기간으로 지난 7일을, 내보내기 빈도로 일일을 선택하는 것이 좋습니다. 데이터 정확성과 저장용량 비용 간의 균형을 맞추려면 내보내기 기간과 내보내기 빈도를 선택해야 합니다. 모든 설정은 CDC 프로세스에서 작동합니다.
인스턴트 보고는 BigQuery로 내보낼 때 최대 14일의 데이터 내보내기를 지원하지만 DV360에서는 보고서 날짜로부터 최대 31일 후까지 데이터를 약간 업데이트할 수 있습니다. 여러 광고주의 내보내기를 설정하면 각 광고주의 날짜가 해당 광고주의 시간대에 표시됩니다.
예약되지 않은 일회성으로 이전 데이터가 필요한 경우 인스턴트 보고를 사용하면 최대 2년 분량의 데이터를 BigQuery 테이블로 직접 내보낼 수 있습니다. DV360 UI에서 수동으로 한 번 이상 이 작업을 실행해야 합니다.

데이터 최신 상태 및 지연

일반적으로 Cortex Framework 데이터 소스의 데이터 최신성은 업스트림 연결에서 허용하는 사항과 DAG 실행 빈도에 따라 제한됩니다. 업스트림 빈도, 리소스 제약조건, 비즈니스 요구사항에 맞게 DAG 실행 빈도를 조정합니다.

DV360 인스턴트 보고의 경우 데이터 업데이트 빈도는 BigQuery 내보내기를 설정할 때의 내보내기 빈도 설정에 따라 달라지며, 이는 일일, 주간 또는 월간일 수 있습니다.

구성

이 섹션에서는 데이터 프로세스의 구성을 설명합니다.

Cloud Composer 연결

Cloud Composer에서 다음 연결을 만듭니다. 자세한 내용은 Cloud Composer 문서를 참고하세요.

연결 이름	목적
`dv360_cdc_bq`	원시 데이터 세트 > CDC 데이터 세트 전송
`dv360_reporting_bq`	CDC 데이터 세트 > 보고 데이터 세트 전송

원시 테이블 스키마에서 CDC 테이블 스키마로

디렉터리 src/DV360/config/table_schema에는 DV360에서 내보낸 테이블 세트당 하나의 스키마 파일 (동일한 접두사로 식별됨)이 포함되어 있습니다. 각 스키마 파일에는 ColumnName 및 ColumnDataType라는 두 열이 포함됩니다.

처리 설정

src/DV360/config/ingestion_settings.yaml 파일에는 소스에서 CDC로 데이터 파이프라인을 제어하는 추가 설정이 포함되어 있습니다.

CDC 테이블의 소스

이 섹션에는 DV360 내보내기 테이블을 처리하는 방법과 관련 CDC 프로세스 동작을 제어하는 항목이 있습니다. 각 항목은 내보내기 접두사로 식별되는 하나의 즉시 보고 보고서에 해당합니다.

다음 매개변수는 각 항목의 Source to CDC 설정을 제어합니다.

매개변수	설명
`base_table`	CDC 변환 후 원시 데이터가 저장되는 CDC 데이터 세트의 테이블입니다 (예: `customer`).
`load_frequency`	이 항목의 DAG가 CDC 테이블을 채우기 위해 실행되는 빈도입니다. 가능한 값에 관한 자세한 내용은 Airflow 문서를 참고하세요.
`raw_table_prefix`	이 BigQuery Export를 설정하기 위해 상응하는 실시간 보고 보고서에서 사용하는 접두사입니다.
`row_identifiers`	이 테이블의 고유한 레코드를 형성하는 열 (쉼표로 구분됨)입니다.
`partition_details`	선택사항: 성능 고려사항으로 인해 이 테이블을 파티션화하려는 경우 자세한 내용은 테이블 파티션을 참고하세요.
`cluster_details`	선택사항: 성능 고려사항으로 인해 이 테이블을 클러스터링하려면 클러스터 설정에서 자세한 내용을 참고하세요.

보고서 설정

보고 설정 파일 src/DV360/config/reporting_settings.yaml를 사용하여 Cortex Framework가 DV360 최종 보고 영역의 데이터를 생성하는 방식을 구성하고 제어할 수 있습니다. 이 파일은 보고 레이어 BigQuery 객체(테이블, 뷰,함수 또는 저장 프로시저)가 생성되는 방식을 제어합니다.

자세한 내용은 보고서 설정 파일 맞춤설정을 참고하세요.

다음 단계

다른 데이터 소스 및 워크로드에 관한 자세한 내용은 데이터 소스 및 워크로드를 참고하세요.
프로덕션 환경에서 배포하는 단계에 관한 자세한 내용은 Cortex Framework Data Foundation 배포 기본 요건을 참고하세요.