베타 기능은 네트워크에서 사용하지 못할 수도 있습니다. 언제 이 기능을 일반적으로 사용할 수 있는지 알아보려면 출시 노트를 확인하세요.
데이터 전송 보고서 파일에서는 광고 캠페인의 데이터를 집계되지 않은 이벤트 수준의 형태로 제공합니다. 해당 데이터는 기본적으로 Ad Manager 광고 서버 로그에서 가져온 원시 콘텐츠이며, 이벤트 유형별로 별도의 파일이 생성됩니다. 데이터 전송 파일에는 초 단위까지 정확한 이벤트 데이터가 포함되어 있으며 기기, 지역 및 이벤트와 관련된 기타 정보를 선택적으로 포함할 수 있습니다. 파트너는 Ad Manager에서 데이터 전송 파일에 표시할 광고 단위를 승인해야 합니다.
시작하기
데이터 전송 보고서 파일에는 추가 비용이 부과됩니다. 이 기능을 사용 설정하려면 계정 관리자에게 문의하세요. 기능이 사용 설정되면 데이터 전송 파일 형식을 설정할 수 있습니다. Google Ad Manager에서는 데이터 전송을 위한 두 가지 옵션인 CSV 및 Parquet을 제공합니다.
추출, 변환 및 로드(ETL)를 관리하고, 대용량 파일을 지원하며, 텍스트 파일을 가공하고, 중간 크기의 데이터 스토어를 설계 및 관리하고, 스크립트를 설계 및 구현할 수 있는 역량을 조직이 보유하지 않은 경우 승인된 Google Marketing Platform 파트너의 도움을 받아보세요.
이용 가능한 데이터 전송 보고서 파일
각 데이터 전송 파일에는 각기 다른 이벤트에 대한 정보가 포함되어 있습니다. 각 파일 형식에 입력란을 추가하여 해당 이벤트와 관련된 상황 정보를 확인할 수 있습니다.
Backfill 파일이 있는 경우, 동적 할당을 통해 Ad Exchange나 애드센스에서 게재된 노출수가 Network 파일에 포함되지 않습니다. 동적으로 할당된 노출수에 관한 정보를 보려면 Backfill 파일을 사용하세요.데이터 전송 파일에 포함된 데이터 정보
- 지연 데이터
몇 시간 지연은 정상 범주이지만 가끔 데이터 전송 파일의 처리가 평소보다 시간이 더 오래 걸리는 경우도 있습니다. 데이터가 지연되는 경우 다음 시간별 배치 파일에 정확한 타임스탬프와 함께 데이터가 표시됩니다. 이는 예를 들어 처리가 지연된 경우 주로 오전 8시에서 오전 9시의 타임스탬프가 있는 파일에 간혹 더 이른 시간의 타임스탬프가 있을 수 있음을 의미합니다. -
활동이 없는 시간
특정 시간 동안 아무 활동이 없으면 헤더 데이터만 포함된 빈 데이터 전송 파일이 게시됩니다. - 날짜 및 날짜 경계
특정일의 첫 번째 시간별 파일에는 일반적으로 태평양 표준시로 자정부터 오전 1시까지의 이벤트가 포함되지만, 이벤트 타임스탬프는 게시자의 네트워크 시간대로 표시됩니다. 예를 들어 게시자가 동부 표준시를 사용하는 경우 첫 번째 시간별 파일에 오전 3시부터 오전 4시까지의 이벤트가 표시됩니다. 이전 3시간 동안의 이벤트는 실제로는 전날의 파일에 들어 있습니다. 따라서 파일 이름에 표시된 것과 다른 날짜의 타임스탬프가 있을 수 있습니다. 항상 파일이 게시된 시간이나 파일 이름이 아닌, 파일에 포함된 이벤트의 타임스탬프를 참조하세요. - 데이터 전송의 마스터/컴패니언 보고
데이터 전송 파일에는 마스터 및 컴패니언 광고 소재가 모두 표시되지만 쿼리 도구에서는 정보가 마스터/컴패니언으로 분류되지 않는 이상, 마스터/컴패니언 광고 소재 세트에 대해 게재된 노출(각 광고 소재에 대한 노출이 아님)만 반영합니다.
IsCompanion은 컴패니언 광고 소재 노출에 대해 'TRUE'입니다. CreativeId 입력란은 광고 소재 세트 ID가 아니라 마스터 및 컴패니언 광고 소재에 대한 개별 광고 소재 ID를 포함합니다. 데이터 전송에는 컴패니언 노출을 마스터 노출과 연관할 수 있는 광고 소재 세트 ID를 위한 추가 입력란이 없습니다. - Ad Manager 보고와의 불일치
악성 트래픽(스팸 데이터)은 Ad Manager 보고서 또는 API에서 생성한 보고서에서 주기적으로 삭제됩니다. 데이터 전송 파일의 게시 일정으로 인해 이러한 정리 내용이 일부 반영되지 않을 수 있습니다. 따라서 데이터 전송에 노출, 클릭 또는 기타 이벤트가 약간 많이 표시될 수 있습니다. 불일치가 발생하는 경우 그 정도는 대개 ~1%입니다.데이터 전송에서는 게재된 모든 노출의 코드 제공을 매회 반영하지만 Ad Manager 보고서에서는 요청당 코드 제공을 1회로 계산하므로
CodeServes데이터 전송 파일에는 Ad Manager 보고서의 '코드 제공 횟수' 측정항목보다 큰 값이 표시될 수 있습니다. Google Ads 텍스트 광고와 같은 일부 광고 소재 형식의 경우 하나의 요청에 여러 노출을 포함할 수 있습니다.KeyPart필드 값을 기준으로 데이터 전송 파일을 그룹화하여 비교할 순 노출수를 찾으세요.
CSV 및 Parquet 출력 형식의 장단점
| CSV(쉼표로 구분된 값) | Parquet(열 기반 스토리지) | |
|---|---|---|
| 가독성 및 접근성 | 인간이 읽기 쉬우며 기본 텍스트 편집기나 스프레드시트 소프트웨어로 쉽게 열고 수정할 수 있습니다. | 보기 및 수정하는 데 특수 도구가 필요하며 기술에 능숙하지 않은 사용자는 쉽게 액세스할 수 없습니다. |
| 범용성 및 호환성 | 거의 모든 데이터 분석 및 처리 도구에서 광범위하게 지원됩니다. | 특히 이전 시스템에서는 완전한 호환성을 위해 추가 라이브러리 또는 소프트웨어가 필요할 수 있습니다. |
| 단순성 및 사용 편의성 | 간단한 구조로, 특히 소규모 데이터 세트나 빠른 탐색 분석에 대해 이해하고 작업하기 쉽습니다. | 특히 열 기반 스토리지에 익숙하지 않은 사용자의 경우 처음 구현하는 것이 더 복잡할 수 있습니다. |
| 성능 및 효율성 | 행 기반 스토리지와 압축 부족으로 인해 대규모 데이터 세트의 속도가 느릴 수 있습니다. | 열 기반 스토리지와 효율적인 압축 기술을 통해 대규모 데이터 처리 및 분석에 뛰어난 성능을 제공합니다. |
| 스토리지 효율성 | 기본 제공 압축이 없고 중복 데이터 저장 가능성이 있으므로 스토리지 효율이 떨어집니다. | 열 기반 스토리지와 고급 압축 알고리즘으로 인해 스토리지 효율성이 높아 스토리지 비용이 절감됩니다. 특히 대규모 데이터 세트의 경우 Parquet 파일의 크기가 CSV 파일보다 50~75% 더 작을 수 있습니다. |
CSV에서 이미 데이터 전송을 사용 설정한 경우 계정 관리자에게 문의하여 Parquet에 액세스할 수 있습니다.
샘플 파일 다운로드
이러한 샘플 파일을 CSV 또는 Parquet으로 다운로드하여 각 데이터 전송 보고 파일에 포함된 데이터 및 필드를 미리 볼 수 있습니다.
| 이벤트 유형 | 파일 이름 및 형식 | 제공 정보 | 샘플 파일 |
|---|---|---|---|
| 가능한 입찰 | NetworkBackfillBidsJoinable |
입찰가에 대한 정보입니다. 다른 데이터 전송 파일과 결합할 수 있습니다. 시간당 파일 1개. |
|
| CodeServe | NetworkCodeServes |
다운로드 여부와 관계없이 Ad Manager로부터의 모든 응답을 기록합니다. 시간당 파일 2개. 참고: 요청 및 CodeServe 파일은 추가 비용 없이 노출 파일에 포함됩니다. |
|
| 노출 | NetworkImpressions |
다운로드된 노출에 관한 정보입니다. 시간당 파일 2개. |
|
| 요청 | NetworkRequests |
유효 노출 또는 잔여 노출인지와 관계없이 Ad Manager로부터 수신한 모든 광고 요청을 기록합니다. 시간당 파일 2개. 참고: 요청 및 CodeServe 파일은 추가 비용 없이 노출 파일에 포함됩니다. |
|
| Active View | NetworkActiveViews |
Active View 대상 Ad Manager 기반 노출에 관한 정보입니다. 시간당 파일 2개. |
|
| 입찰 수 | NetworkBackfillBids (베타) |
Authorized Buyers 및 공개 입찰 입찰가 관련 정보. 시간당 파일 1개. |
|
| Click | NetworkClicks |
클릭에 관한 정보입니다. 시간당 파일 2개. |
|
| 낙찰을 위한 최소 입찰가 | NetworkMinimumBidToWin (베타) |
하나 이상의 잔여 광고 항목이 경쟁할 때 구매자가 낙찰받는 데 필요한 최소 입찰가를 보고합니다. 시간당 파일 1개. |
|
| 리치 미디어 전환 | NetworkRichMediaConversions |
표준 및 맞춤 작업(예: 재생 및 일시중지), 작업 지속 시간과 같은 Studio 이벤트에 관한 정보입니다. 시간당 파일 2개. |
|
| 동영상 전환 | NetworkVideoConversions |
작업(예: 재생 및 일시중지), 콘텐츠 ID, 광고 모음 포지셔닝 등과 같은 동영상 관련 이벤트에 관한 정보. 동영상 이벤트 모두 보기 시간당 파일 2개. |
|
파일 전달 방식
데이터 전송 파일은 매시간 Ad Manager 클라우드 스토리지 버킷으로 푸시됩니다. 정기적으로 폴링하여 업데이트 사항을 점검하는 것이 좋습니다. 대부분의 데이터는 기록된 시간 이후 5~15시간 사이에 전달되어 사용할 수 있게 되지만, 일부 지연 이벤트는 발생 후 최대 8일까지 시간이 걸릴 수 있습니다. Ad Manager에서는 데이터 전송 정보를 서드 파티 서버로 전달하지 않습니다.
파일 이름에는 이벤트 시작 시간이 미국 태평양 표준 시간대(일광 절약 시간제 적용)로 포함되지만, 해당 파일에 있는 타임스탬프는 항상 Ad Manager 네트워크 시간대(일광 절약 시간제가 적용되지 않을 수 있음)를 기준으로 제공됩니다. 따라서 이러한 시간대 설정이 서로 미치는 영향에 따라 1시간이 넘는 분량의 데이터가 포함된 파일이 생성되거나, 빈 파일/파일 누락이 발생할 수 있습니다.
파일 이름
데이터 전송 파일의 이름은 예측 가능한 규칙을 따릅니다.
- CSV:
[Type]_[Network ID]_[YYYYMMDD]_[HH].gz - Parquet:
[Type][Network ID][YYYYMMDD]_[HH]-[Partition Index]-of-[Total Number of Partitions].parquet YYYYMMDD는 연도, 월, 일입니다.HH는 24시간 형식의 시작 시간입니다.각 파일 이름에 지정된 시간(예: 01, 02, 03)은 태평양 시간대지만, 게시자는 데이터 전송 파일에 포함된 타임스탬프로부터 해당하는 네트워크 시간대별 데이터를 확인할 수 있습니다. 파일 전달을 계산할 때 이 차이점에 유의하세요.
[Partition Index]생성된 총 파일 수(파티션)와 관련하여 파일이 속한 파티션입니다(0부터 시작).[Total Number of Partitions]파일을 만드는 데 사용된 파일(파티션) 수입니다.
데이터 전송 보고서 파일 사용하기
데이터 전송을 설정하면 파일이 Ad Manager 클라우드 저장소 버킷에 보관됩니다. 명령줄 도구를 사용하거나 API를 통해 웹에서 파일에 액세스할 수 있습니다. Ad Manager 클라우드 저장소 버킷에 액세스하는 방법 자세히 알아보기
자사 데이터 수집 및 분석 수행 시에 데이터 전송 파일 이름에 있는 시작 시간을 기준으로 파일 집합을 특정하면, 일광 절약 시간제, 지연 데이터 수집 또는 기타 유사한 상황으로 인해 후속 파일에서 제공되는 데이터를 놓치게 될 수 있습니다. 모든 데이터 전송 파일을 별개의 시스템(예: 데이터 웨어하우스, 쿼리 엔진)으로 읽어온 다음 이벤트의 타임스탬프를 기준으로 분석 범위를 정의하는 것이 좋습니다.
데이터 전송 파일은 CSV 파일과 Parquet 파일의 두 가지 형식으로 제공됩니다.
사용자는 각 파일에 대해 CSV, Parquet 또는 둘 다의 출력을 선택할 수 있습니다. Parquet은 데이터 웨어하우스 사용 사례 및 처리에 최적의 형식이며, CSV 파일은 파일 크기에 따라 스프레드시트 편집기에서 사용할 수 있습니다. 다음은 데이터 전송 정보를 적용할 수 있는 몇 가지 일반적인 사례입니다.
- 이벤트 및 활동 등 특정 기준별 사용자 집계(예: 광고 소재별)
- 여러 날에 걸쳐 순 전환수 계산
- 사용자를 고객 데이터베이스와 대조
- 사용자 지역 및 인구통계 정보 보고
데이터 전송 파일 내에 포함된 값에 대한 이름-ID 색인을 제공하는 데이터 이동 색인을 사용하여 데이터 전송 파일의 광고 게재 정보(예: 광고 단위 또는 광고 항목)를 데이터베이스에 저장된 사전 할당 값에 대응시킬 수 있습니다.
파일을 로컬에 저장
어림잡아 각 이벤트는 압축 파일로 25~35바이트를 사용합니다. 따라서 노출수가 천만 번인 경우 압축 CSV 파일로 약 300MB의 디스크 공간이 필요합니다. Parquet 출력 형식을 사용하면 파일 크기가 더 작아질 수 있습니다. 이 크기는 예상치이며 파일 크기가 좀 더 클 수 있습니다. 또한 이는 압축된 형식의 데이터 크기이므로 파일의 압축을 풀어 사용하려면 추가 공간이 필요합니다.
60일이 지난 데이터 전송 파일은 Ad Manager에서 삭제됩니다. 파일을 할당된 60일보다 긴 기간 동안 저장하고 싶은 경우, 로컬에 저장하거나 영구적인 클라우드 저장소 솔루션(예: 전체 관리 권한을 보유하고 있는 독립적인 Google Cloud Storage 계정)으로 옮기는 것이 좋습니다.