실시간 추천 사양 알아보기

Google은 타겟팅된 인벤토리를 실시간 맞춤설정 통합에 일치시키는 광고 요청을 기반으로 SegmentRequest를 전송합니다. SegmentRequest 객체는 SegmentResponse에서 지정된 인벤토리에 적용되는 세그먼트를 식별하는 데 사용할 수 있는 컨텍스트 신호 또는 보안 신호를 제공합니다. 실시간 추천은 JSON 형식으로 전송되는 SegmentRequest 및 SegmentResponse 객체를 지원합니다.

이 가이드는 통합을 빌드하는 데 도움이 되는 실시간 선별 프로토콜에 관한 참고 자료입니다.

SegmentRequest

속성	유형	설명
imp	노출수 배열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 제공되는 노출 기회를 나타냅니다.
site	사이트	컨텍스트 기반 추천 파트너에게만 지원됩니다. 웹사이트의 설명자입니다. 광고 지원 콘텐츠가 브라우저가 아닌 애플리케이션인 경우 site 필드가 채워집니다.
app	앱	컨텍스트 기반 추천 파트너에게만 지원됩니다. 앱의 설명자입니다. 광고 지원 콘텐츠가 웹사이트가 아닌 브라우저가 아닌 애플리케이션인 경우 app 필드가 채워집니다.
pub	게시자	컨텍스트 기반 추천 파트너에게만 지원됩니다. 게시자의 설명자입니다.
user	사용자	세그먼트 요청을 시작한 게시자 콘텐츠를 탐색하는 사용자의 설명자입니다.
device	기기	컨텍스트 기반 추천 파트너에게만 지원됩니다. 사용자 기기의 설명자입니다.
segment_request_id	문자열	다른 모든 세그먼트 요청과 독립적으로 세그먼트 요청을 식별하는 데 사용되는 고유 식별자입니다.

노출수

속성	유형	설명
id	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 세그먼트 요청 컨텍스트 내에서 이 노출의 고유 식별자입니다. 값은 1에서 시작하여 n개의 노출에 대해 n까지 증가합니다.
banner	배너	컨텍스트 기반 추천 파트너에게만 지원됩니다. 노출이 배너 광고 기회로 제공되는 경우 이 필드에 값이 입력됩니다.
video	동영상	컨텍스트 기반 추천 파트너에게만 지원됩니다. 노출이 동영상 광고 기회로 제공되는 경우 이 필드가 채워집니다.
ext	ImpExt	Imp 객체의 확장 프로그램으로 채워집니다.

배너

속성	유형	설명
w	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 너비(기기 독립형 픽셀(DIPS))입니다.
h	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 기기 독립 픽셀 (DIP)의 높이입니다.
pos	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 화면의 광고 위치입니다. 가능한 배치 위치에 대해 자세히 알아보려면 AdCOM 1.0의 목록: 배치 위치를 참고하세요.

동영상

속성	유형	설명
w	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 기기 독립형 픽셀 (DIP) 단위의 동영상 플레이어 너비입니다.
h	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 기기 독립 픽셀 (DIP) 단위의 동영상 플레이어 높이입니다.
pos	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 화면의 광고 위치입니다. 가능한 배치 위치에 대해 자세히 알아보려면 AdCOM 1.0의 목록: 배치 위치를 참고하세요.

ImpExt

속성	유형	설명
gpid	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 전역 게재위치 ID를 설명합니다. 게시자가 지정한 고유한 영구 ID로, 페이지의 각 광고 단위에 대해 공급 경로 전반에서 일관됩니다. 이 도움말을 참고하세요.

사이트

속성	유형	설명
page	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 노출을 표시하는 페이지의 URL입니다.
mobile	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 사이트가 휴대기기에서 볼 때 레이아웃을 최적화하도록 프로그래밍되었는지 나타냅니다. 0은 아니요, 1은 예입니다.

앱

속성	유형	설명
bundle	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 앱에 고유하도록 설계된 플랫폼별 애플리케이션 식별자입니다. Android에서 bundle 필드는 번들 또는 패키지 이름입니다. iOS에서는 숫자 ID입니다.

게시자

속성	유형	설명
id	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 웹 속성 코드의 게시자 코드 접미사로 정의된 게시자 ID입니다. 예를 들어 웹 서비스 코드가 ca-pub-123인 게시자의 ID는 pub-123로 설정됩니다.

사용자

속성	유형	설명
consent	문자열	게시자의 IAB 동의 관리 플랫폼 (CMP)에서 가져온 웹 안전 base64 인코딩 IAB 투명성 및 동의 프레임워크 (TCF) v2 동의 문자열입니다. 게시자가 TCF v2용 CMP와 통합되어 있고 해당 CMP가 광고 요청에 GDPR이 적용된다고 표시하고 유효한 동의 문자열을 제공하는 경우 consent 필드가 채워집니다. 동의 문자열에 나열된 공급업체에 관한 자세한 내용은 vendor-list.consensu.org/v2/vendor-list.json의 IAB 글로벌 공급업체 목록을 참고하세요.
eids	EID 배열	보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 확장 ID 인스턴스입니다. 선별에서 eids 필드는 보안 처리된 신호와 같이 게시자가 제공하는 데이터입니다.

EID

속성	유형	설명
source	문자열	보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 포함된 데이터 세트를 담당하는 소스 또는 기술 제공업체입니다. 최상위 도메인으로 표현됩니다.
uids	UID 배열	보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 지정된 소스의 UID 객체 배열입니다.

UID

속성	유형	설명
id	문자열	보안 처리된 신호 큐레이션 파트너에게만 지원됩니다. 식별자입니다. 선별에서 id 필드는 보안 처리된 신호입니다. 보안 처리된 신호에 대해 자세히 알아보려면 Ad Manager의 입찰자 및 큐레이션 파트너와 보안 처리된 신호 공유를 참고하세요.

기기

속성	유형	설명
geo	지역	컨텍스트 기반 추천 파트너에게만 지원됩니다. 사용자 기기의 위치입니다.
devicetype	int	컨텍스트 기반 추천 파트너에게만 지원됩니다. 일반적인 기기 유형입니다. 가능한 기기 유형에 대해 자세히 알아보려면 AdCOM 1.0의 목록: 기기 유형을 참고하세요.
os	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 기기 운영체제 (예: 'iOS')
make	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 기기 제조사입니다 (예: 'Apple').

지역

속성	유형	설명
country	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. ISO-3166-1 Alpha-3 표준을 사용하는 국가입니다.
region	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. ISO-3166-2 표준을 사용하는 지역 코드입니다. 미국인 경우 2자리 주 코드입니다.
metro	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. geo-table.csv 파일에서 Google 도시권 코드 발견
city	문자열	컨텍스트 기반 추천 파트너에게만 지원됩니다. 무역 및 운송 위치에 대한 유엔 코드를 사용하는 도시입니다.

SegmentResponse

속성	유형	설명
segment	세그먼트 배열	세그먼트의 설명자입니다.

세그먼트

속성	유형	설명
segment_id	문자열	세그먼트의 ID입니다. ID는 Marketplace API의 curators.dataSegments 리소스에 있는 세그먼트 이름의 curatorDataSegmentId와 일치해야 합니다.