SegmentRequest 파싱

실시간 선별에서 Google은 하나 이상의 노출을 설명하는 신호를 제공하기 위해 선별 엔드포인트에 JSON SegmentRequest을 전송하여 각 노출에 적용할 수 있는 데이터 세그먼트를 결정할 수 있도록 합니다. 이 가이드에서는 SegmentRequest를 처리하는 선별 로직 개발을 다룹니다.

gzip 인코딩 사용

Google은 엔드포인트에 SegmentRequest를 전송할 때 gzip 인코딩을 사용합니다. 엔드포인트는 gzip 인코딩으로 수신하고 응답할 수 있어야 합니다.

문맥 시그널 또는 보안 처리된 신호 엔드포인트로 큐레이션

실시간 선별 엔드포인트를 만들 때 컨텍스트 신호를 수신할지 보안 신호를 수신할지 선택해야 합니다. 선택한 신호는 엔드포인트로 전송되는 세그먼트 요청이 채워지는 방식, 엔드포인트로 전송되는 세그먼트 요청을 생성하는 인벤토리의 양, 통합에 사용되는 큐레이션 로직에 영향을 미칩니다.

문맥 시그널 사용

컨텍스트 신호에는 노출의 출처를 설명하는 게시자, 기기, 사용자에 관한 정보가 포함됩니다. 사용 가능한 신호는 다음 목록에 설명되어 있습니다.

  • SegmentRequest.site: 노출을 렌더링하는 웹사이트를 설명합니다(예: 사이트의 URL). SegmentRequest.site 및 SegmentRequest.app 중 하나만 SegmentRequest에 채울 수 있습니다.
  • SegmentRequest.app: 노출을 렌더링하는 앱을 설명합니다(예: 앱의 플랫폼별 애플리케이션 식별자). SegmentRequest.site 및 SegmentRequest.app 중 하나만 SegmentRequest에 채울 수 있습니다.
  • SegmentRequest.pub: 노출을 렌더링하는 미디어의 게시자를 설명합니다(예: 게시자 ID).
  • SegmentRequest.user: 개인 정보가 처리되는 방식에 관한 사용자 선택사항을 설명합니다(예: TCF 동의 문자열).
  • SegmentRequest.device: 도시 수준 정밀도로 기기의 지리적 위치와 같은 기기에 관한 정보를 설명합니다.

문맥 신호를 사용하여 SegmentResponse에서 반환할 수 있는 관련 데이터 세그먼트를 결정할 수 있는 선별 로직을 구현할 수 있습니다.

보안 처리된 신호 사용

보안 처리된 신호는 게시자가 하나 이상의 파트너와 공유하기로 선택한 데이터입니다. 이러한 값은 광고 요청에서 Google과 공유되기 전에 난독화되며, 실시간 선별에서는 난독화된 형태로 SegmentRequest.user.eids.uids.id에 표시됩니다.

엔드포인트가 보안 처리된 신호를 사용하도록 구성된 경우 엔드포인트는 보안 처리된 신호를 내 선별 계정과 공유하도록 선택한 게시자의 인벤토리에 대한 세그먼트 요청만 수신합니다. 따라서 컨텍스트 신호 엔드포인트에 비해 보안 신호 엔드포인트로 전송될 수 있는 총 노출수가 적습니다.

엔드포인트의 선별 로직은 보안 처리된 신호를 해석하고 보안 처리된 신호를 사용하여 SegmentResponse에서 반환할 적용 가능한 데이터 세그먼트를 결정해야 합니다.

SegmentRequest 예

문맥 신호 실시간 추천 엔드포인트

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

보안 신호 실시간 선별 엔드포인트

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

다음 단계