Google은 타겟팅된 인벤토리와 일치하는 광고 요청을 기반으로 SegmentRequest를 실시간 선별 통합에 전송합니다. SegmentRequest 객체는 SegmentResponse에서 지정된 인벤토리에 적용되는 세그먼트를 식별하는 데 사용할 수 있는 문맥 신호 또는 보안 처리된 신호를 제공합니다.
실시간 추천은 JSON 형식으로 전송되는 SegmentRequest 및 SegmentResponse 객체를 지원합니다.
이 가이드는 통합을 빌드하는 데 도움이 되는 실시간 선별 프로토콜에 관한 참고 자료입니다.
SegmentRequest
| 속성 | 유형 | 설명 |
|---|---|---|
site |
사이트 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 웹사이트의 설명자입니다. 광고 지원 콘텐츠가 브라우저가 아닌 애플리케이션인 경우 |
app |
앱 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 앱의 설명입니다. 광고 지원 콘텐츠가 웹사이트가 아닌 브라우저가 아닌 애플리케이션인 경우 |
pub |
게시자 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 게시자의 설명자입니다. |
user |
사용자 | 세그먼트 요청을 시작한 게시자 콘텐츠를 탐색하는 사용자의 설명자입니다. |
device |
기기 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 사용자 기기의 설명자입니다. |
segment_ |
문자열 | 다른 모든 세그먼트 요청과 독립적으로 세그먼트 요청을 식별하는 데 사용되는 고유 식별자입니다. |
사이트
| 속성 | 유형 | 설명 |
|---|---|---|
page |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 노출을 표시하는 페이지의 URL입니다. |
앱
| 속성 | 유형 | 설명 |
|---|---|---|
bundle |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 앱에 고유하도록 설계된 플랫폼별 애플리케이션 식별자입니다. Android에서 |
게시자
| 속성 | 유형 | 설명 |
|---|---|---|
id |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 웹 속성 코드의 게시자 코드 접미사로 정의된 게시자 ID입니다. 예를 들어 웹 서비스 코드가 |
사용자
| 속성 | 유형 | 설명 |
|---|---|---|
consent |
문자열 | 게시자의 IAB 동의 관리 플랫폼 (CMP)에서 가져온 웹에 안전한 base64로 인코딩된 IAB 투명성 및 동의 프레임워크 (TCF) v2 동의 문자열입니다. 게시자가 TCF v2용 CMP와 통합되어 있고 해당 CMP가 광고 요청에 GDPR이 적용된다고 표시하고 유효한 동의 문자열을 제공하는 경우 동의 문자열에 나열된 공급업체에 관한 자세한 내용은 vendor-list.consensu.org/v2/vendor-list.json의 IAB 글로벌 공급업체 목록을 참고하세요. |
eids |
EID 배열 | 보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 확장 ID 인스턴스입니다. 선별에서 |
EID
| 속성 | 유형 | 설명 |
|---|---|---|
source |
문자열 | 보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 포함된 데이터 세트를 담당하는 소스 또는 기술 제공업체입니다. 최상위 도메인으로 표현됩니다. |
uids |
UID 배열 | 보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 지정된 소스의 UID 객체 배열입니다. |
UID
| 속성 | 유형 | 설명 |
|---|---|---|
id |
문자열 | 보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 식별자입니다. 선별에서 |
기기
| 속성 | 유형 | 설명 |
|---|---|---|
geo |
지역 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. 사용자 기기의 위치입니다. |
지역
| 속성 | 유형 | 설명 |
|---|---|---|
country |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. ISO-3166-1 Alpha-3 표준을 사용하는 국가입니다. |
region |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. ISO-3166-2 표준을 사용하는 지역 코드입니다. 미국인 경우 2자리 주 코드입니다. |
metro |
문자열 | 컨텍스트 기반 추천 파트너에게만 지원됩니다. geo-table.csv 파일에서 찾은 Google 도시권 코드입니다. |
SegmentResponse
| 속성 | 유형 | 설명 |
|---|---|---|
segment |
세그먼트 배열 | 세그먼트의 설명자입니다. |
세그먼트
| 속성 | 유형 | 설명 |
|---|---|---|
segment_id |
문자열 | 세그먼트의 ID입니다. ID는 Marketplace API의 curators.dataSegments 리소스에 있는 세그먼트 이름의 curatorDataSegmentId와 일치해야 합니다. |