보고

Ad Exchange는 다음과 같은 보고서를 제공합니다.

  • CSV 실적 보고서는 입찰자 애플리케이션의 실적 정보를 제공합니다.
  • 스니펫 상태 보고서는 광고 소재의 승인 여부에 대한 정보와 게재 문제를 해결하는 데 도움이 되는 정보를 제공합니다.

CSV 실적 보고서

CSV 실적 보고서는 입찰자 애플리케이션의 실적에 대한 정보를 제공합니다. 이 보고서는 한 시간 단위로 생성되며 개발자용 Google 스토리지를 통해 제공됩니다. CSV 실적 보고서에는 2개의 형식이 있습니다. 각 보고서는 서로 다른 방식으로 데이터를 분류하여 제공합니다. 보고서의 원래 버전은 데이터 클러스터 지역별로 데이터를 분류하고, 새 보고서는 거래 위치별로 데이터를 분류합니다.

참고: 두 버전의 CSV 실적 보고서 샘플은 다운로드 페이지에서 다운로드할 수 있습니다.

데이터 클러스터 지역(지원 중단됨)

보고서는 CSV 형식으로 되어 있습니다. 맨 좌측 열은 POSIX 타임스탬프를 제공합니다. 일부 열은 매분 보고서가 다루는 값을 제공합니다. 보고서는 열의 값이 항상 60개 이상이 될 수 있도록 이전 보고서에 중복 기재됩니다. 만약 값이 전체 보고서 기간 중 최대를 나타낼 경우 다른 열은 단 한 개의 값만 가집니다. 주어진 기간과 지역의 열에 데이터가 없을 때는 값이 0이 됩니다.

데이터 클러스터 지역 보고서의 보고서 첫째 줄은 다음과 같은 형식의 열 헤더를 포함합니다.

<column-type>-<region> 

내용

  • <region>에서 사용 가능한 값
    • NORTHWEST
    • CENTRAL
    • EAST
    • SOUTHEAST
    • NORTHWEST_EURO
    • WEST_EURO
    • CENTRAL_EURO
    • ASIA

    입찰자 애플리케이션이 모든 지역의 트래픽을 받도록 설정되지 않더라도 보고서는 모든 지역의 데이터를 포함합니다.

  • <column-type>에서 사용 가능한 값
    • max(eligible-requests): 보고서가 다루는 일정 시간 동안 지역의 사전 타겟팅 기준에 맞는 초당 최대 검색어 개수(QPS).

    • requests-sent: 보고서가 다루는 매분 입찰자 애플리케이션에 전달되는 QPS의 평균 개수.

    • successful-responses: 보고서가 다루는 초당 성공적 응답을 받은 QPS의 평균 개수. 성공적 응답이란 적시에 도착한 응답으로, 200 OK HTTP 응답 코드와 바르게 분석된BidResponse 프로토콜 임시 저장 공간을 가지고 있습니다. 성공적 응답은 광고를 반환하지 않아도 됩니다.

    • successful-responses-with-ads: 보고서가 다루는 초당 최소 광고 한 개를 포함하는 성공적 응답을 받은 QPS의 평균 개수

    • requests-timeout: 보고서가 다루는 매분에서 시간 초과된 QPS의 평균 개수. 시간초과 요청은 100밀리초 이내에 응답을 받지 않은 요청을 말합니다.

    • no-content-responses: 보고서가 다루는 매분에서 콘텐츠가 없는 응답 QPS 평균 개수. 'no content response'는 200 OK HTTP 응답 코드를 가지고 있지만 데이터 길이가 0인 응답을 말합니다. 'no bid' 응답은 ad 메시지 없이 BidResponse 프로토콜 임시 저장 공간을 포함해야 하기 때문에 이와 같은 경우 에러로 간주됩니다.

    • unparseable-responses: 보고서가 다루는 매분에서 분석이 불가능한 응답 QPS의 평균 개수. 'unparseable response'란 BidResponse 프로토콜 임시 저장 공간으로 분석이 불가능한 데이터를 가지고 있는 응답을 말합니다.

    • 50th-percentile-latency, 85th-percentile-latency, 95th-percentile-latency: 보고서가 다루는 매분에서 Google 서버에 감지되는 Nth 백분위수 라운드 트립 지연 시간. 특정 지역에서 귀하에게 트래픽을 보내는 모든 Google 데이터 센터 사이의 가중치 평균으로 데이터 센터당 트래픽 양으로 측정된다는 점에 유의하세요.

3개의 파일로 구성된 보고서:

  • csv-field-descriptions.txt에는 CSV 필드에 대한 설명이 나와 있습니다.
  • rtb-report-<timestamp>.csv는 최신 주문 순서의 CSV 데이터를 포함합니다.
  • rtb-report-<timestamp>-incr.csv는 가장 오래된 주문 순서의 CSV 데이터를 포함합니다.

이 기능을 귀하의 계정에 적용하려면 기술 계정 관리자에게 문의하세요.

거래 위치(신규)

보고서의 CSV 형식에서 맨 왼쪽 열에는 POSIX 타임스탬프와 거래 위치의 이름이 아래와 같이 나와 있습니다. 일부 열은 매분 보고서가 다루는 값을 제공합니다. 보고서는 열의 값이 항상 60개 이상이 될 수 있도록 이전 보고서에 중복 기재됩니다. 만약 값이 전체 보고서 기간 중 최대를 나타낼 경우 다른 열은 단 한 개의 값만 가집니다. 주어진 기간과 지역의 열에 데이터가 없을 때는 값이 0이 됩니다.

  • <Trading location>에서 사용 가능한 값
    • US_WEST
    • US_EAST
    • EUROPE
    • ASIA

    입찰자 애플리케이션이 일부 위치에서 들어오는 트래픽만 수신하도록 설정되어 있어도 이 보고서는 모든 거래 위치에 대한 데이터를 포함합니다.

    참고: 이 입찰자에 대해 설정되지 않은 거래 위치에는 max(eligible-requests) 항목만 채워진 행 하나만 포함됩니다.
  • 보고서의 각 행에 2열에 나온 거래 위치에 해당하는 데이터가 포함되면 다음과 같은 데이터 지점이 포함되는데, 각 지점은 해당 유형 이름이 나온 열에 포함됩니다.
    • max(eligible-requests): 보고서가 다루는 일정 시간 동안 지역의 사전 타겟팅 기준에 맞는 초당 최대 검색어 개수(QPS).

    • requests-sent: 보고서가 다루는 매분 입찰자 애플리케이션에 전달되는 QPS의 평균 개수.

    • successful-responses: 보고서가 다루는 초당 성공적 응답을 받은 QPS의 평균 개수. 성공적 응답이란 적시에 도착한 응답으로, 200 OK HTTP 응답 코드와 바르게 분석된BidResponse 프로토콜 임시 저장 공간을 가지고 있습니다. 성공적 응답은 광고를 반환하지 않아도 됩니다.

    • successful-responses-with-ads: 보고서가 다루는 초당 최소 광고 한 개를 포함하는 성공적 응답을 받은 QPS의 평균 개수

    • requests-timeout: 보고서가 다루는 매분에서 시간 초과된 QPS의 평균 개수. 시간초과 요청은 100밀리초 이내에 응답을 받지 않은 요청을 말합니다.

    • no-content-responses: 보고서가 다루는 매분에서 콘텐츠가 없는 응답 QPS 평균 개수. 'no content response'는 200 OK HTTP 응답 코드를 가지고 있지만 데이터 길이가 0인 응답을 말합니다. 'no bid' 응답은 ad 메시지 없이 BidResponse 프로토콜 임시 저장 공간을 포함해야 하기 때문에 이와 같은 경우 에러로 간주됩니다.

    • unparseable-responses: 보고서가 다루는 매분에서 분석이 불가능한 응답 QPS의 평균 개수. 'unparseable response'란 BidResponse 프로토콜 임시 저장 공간으로 분석이 불가능한 데이터를 가지고 있는 응답을 말합니다.

    • 50th-percentile-latency, 85th-percentile-latency, 95th-percentile-latency: 보고서가 다루는 매분에서 Google 서버에 감지되는 Nth 백분위수 라운드 트립 지연 시간. 특정 지역에서 귀하에게 트래픽을 보내는 모든 Google 데이터 센터 사이의 가중치 평균으로 데이터 센터당 트래픽 양으로 측정된다는 점에 유의하세요.

3개의 파일로 구성된 보고서:

  • csv-field-descriptions.txt에는 CSV 필드에 대한 설명이 나와 있습니다.
  • rtb-report-<timestamp>-trading-location.csv에는 CSV 데이터가 최신 주문 순서로 나와 있습니다.
  • rtb-report-<timestamp>-incr.csv에는 CSV 데이터가 가장 오래된 주문 순서로 나와 있습니다.

이 기능을 귀하의 계정에 적용하려면 기술 계정 관리자에게 문의하세요.

스니펫 상태 보고서

스니펫 상태 보고서는 광고 소재의 승인 여부와 Ad Exchange에서 자동으로 감지하는 제품 분류를 포함합니다. 이 보고서는 두 개의 버전이 있습니다. 사람이 해독 가능한 텍스트 포맷과 2진 프로토콜 임시 저장 공간 포맷입니다. 이 보고서를 통해 광고 소재의 승인 여부를 파악하고 서버 문제를 디버깅할 수 있습니다. 두 버전의 보고서는 모두 Google 개발자용 스토리지에서 지원됩니다.

이 보고서는 HTTP를 통해 제공됩니다. HTTP 응답의 페이로드는 RFC 1952에 따라 gzip으로 압축됩니다. 명령줄에서 파일의 압축을 풀려면 gzip -d <filename>.파일을 프로그램에 따라 압축 해제하려면 zlib이나 gzip 포맷을 지원하는 유사한 압축 라이브러리를 이용하면 됩니다. 결과는 텍스트 파일이나 특수화된 프로토콜 임시 저장 공간으로 나타나며, 다운로드한 보고서의 버전에 따라 달라집니다. 프로토콜 임시 저장 공간 버전의 인코딩은 BidRequest에 있는 POST 요청 페이로드와 비슷합니다. 또 다음과 같은 스니펫으로 분석될 수 있습니다.

string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
SnippetStatusReport snippet_report;
if (snippet_report.ParseFromString(uncompressed)) {
  // 스니펫 보고 처리
}

SnippetStatusReport에 대한 프로토콜 버퍼 정의는 다운로드 페이지에서 제공됩니다.

스니펫 상태 보고서의 각 항목은 입찰 응답에서 설정한 buyer_creative_id를 포함합니다. 이 필드로 스니펫 상태 정보와 귀하의 광고 소재를 연관하여 볼 수 있습니다. 각 스니펫에는 NOT_CHECKED, APPROVED 또는 DISAPPROVED 상태가 나와 있습니다. Ad Exchange에서 광고 소재를 분류하면 스니펫 상태 항목에 해당 광고 소재와 연결된 제품 및 민감한 카테고리와 광고주 ID(해당되는 경우)가 표시됩니다.

이 기능을 귀하의 계정에 적용하려면 기술 계정 관리자에게 문의하세요.

자주 묻는 질문(FAQ)

버킷에 있는 보고서가 1,000개를 넘는데 버킷에 있는 목록 객체에 대한 클라우드 스토리지 API 호출에서는 반환되는 항목이 최대 1,000개입니다. 어떻게 해야 하나요?
이와 같은 API 호출에 대한 클라우드 스토리지 문서에는 이 사례에 대한 두 가지 처리 방법이 나와 있습니다.
  1. API는 잘린 응답과 함께 nextMarker 매개변수를 반환하여 페이지 번호 매기기를 지원합니다. 이 매개변수는 marker와 함께 다음 요청에서 시작점을 나타내는 용도로 사용될 수 있습니다. 이를 통해 실질적으로 전체 버킷에서 '페이지' 번호를 매길 수 있습니다.
  2. API는 특정 프리픽스를 가진 객체만 표시를 지원됩니다. RTB 보고서 파일 명명 방식을 고려할 때 특정 월에 대한 객체만 표시할 수 있습니다(한도 이내여야 함). 예를 들어 prefix=<bucket name>/csv_report/rtb-report-201206를 지정하면 2012년 6월에 대한 객체를 가져옵니다.

다음에 대한 의견 보내기...

DoubleClick Ad Exchange Real-Time Bidding Protocol