Google은 집계된 게시자 설정 목록을 Google 소유의 프로젝트 아래에 있는 계정별 Google Cloud Storage 버킷에 업로드하여 사용할 수 있도록 합니다. 이 파일을 다운로드하여 입찰 시점에 수행할 수 없는 타겟팅에 사용할 수 있습니다. 계정에 이 기능을 사용 설정하려면 기술 계정 관리자에게 문의하세요.
게시자 설정이 포함된 파일은 Cloud Storage API를 사용하거나, Google Developer Console UI를 통해 수동으로 또는 gsutil 명령줄 도구를 사용하여 프로그래매틱 방식으로 다운로드할 수 있습니다. Google Cloud Storage에 저장된 데이터에 액세스하는 방법에 대한 자세한 내용은 Google Cloud Storage 문서를 참조하세요.
RFC 1952에 따라 gzip으로 압축됩니다. 명령줄에서 파일을 추출하려면 gzip -d <filename>를 실행하세요. 프로그래매틱 방식으로 파일을 추출하려면 zlib 또는 gzip 형식을 지원하는 유사한 압축 라이브러리를 사용하면 됩니다. 결과는 BidRequest의 POST 요청 페이로드와 비슷한 직렬화된 프로토콜 버퍼이며 다음 스니펫으로 파싱될 수 있습니다.
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
PublisherSettingsList의 프로토콜 버퍼 정의는 참조 데이터 페이지에서 다운로드할 수 있습니다. 비즈니스 계정 담당자에게 압축된 publisher-settings.pb.gz 파일을 요청할 수도 있습니다. 프로토콜 버퍼 정의와 게시자 설정 파일 예시가 포함되어 있습니다.
PublisherSettingsList의 순서는 언제든지 변경할 수 있습니다.
특정한 순서나 정렬이 보장되지는 않습니다. 게시자 설정 목록의 각 항목에는 식별자와 이 식별자로 태그가 추가된 BidRequests에 적용되는 여러 설정이 포함되어 있습니다. 입찰 시스템에 기능을 추가하여 주기적으로 새 게시자 설정 목록을 확인할 수 있습니다.
Google은 실시간 입찰에 적합한 노출을 수신할 때 게시자 설정 목록의 항목에 해당하는 식별자를 입찰 요청에 포함합니다. 입찰 시스템은 게시자 설정을 사용하여 해당 노출의 조합 광고를 필터링할 수 있습니다. 특정 노출에 적합하려면 후보 광고가 요청에서 식별자가 전송된 모든 게시자 설정 항목을 준수해야 합니다.
파일에서 누락된 게시자 설정은 식별자에 연결된 URL이 차단되어 있기 때문입니다.
게시자 설정 파일은 작은 파일 여러 개로 분할되어 단일 트랜잭션에서 다운로드해야 하는 데이터의 양을 줄입니다. 파일은 약 5MB의 청크로 분할하며 이름은 publisher-settings.n.pb.gz을 통해 publisher-settings.0.pb.gz입니다(여기서 n은 파일 수를 뺀 1). 이러한 파일을 얻으려면 비즈니스 계정 담당자에게 문의하세요.