노출 알림 수신

Google에서 데이터 세그먼트가 실시간 입찰 경매에서 낙찰된 입찰에 사용되어 노출이 발생한 것으로 감지될 때마다 노출 알림을 받을 수 있습니다. 데이터 세그먼트가 사용되는 방식을 자세히 알아보려면 노출 알림과 통합하는 것이 좋습니다. 노출 알림을 사용 설정하려면 계정 관리자에게 문의하세요.

노출 알림 엔드포인트 구성

노출 알림을 받으려면 HTTP 엔드포인트를 만들고 URL을 Google과 공유해야 합니다. 다음 옵션 중 하나를 사용하여 노출 알림이 전송되는 URL을 설정할 수 있습니다.

  1. 각 실시간 추천 호출에 대한 노출 알림 엔드포인트 URL을 설정합니다.
    • SegmentResponse.burl 필드를 입력하여 수신하는 각 실시간 추천 호출에 대한 노출 알림에 사용되는 URL을 동적으로 설정할 수 있습니다.
    • 특정 실시간 추천 콜아웃의 경우 해당 콜아웃의 노출 알림을 수신하려면 SegmentResponse.burl 필드를 설정해야 합니다. SegmentResponse.burl 필드가 채워지지 않으면 이전 콜아웃에서 SegmentResponse.burl 필드가 설정되었더라도 해당 콜아웃에 대한 알림이 전송되지 않습니다.
  2. 계정 수준 노출 알림 엔드포인트 URL을 설정합니다.
    • 계정 관리자에게 문의하여 계정의 계정 수준 노출 알림 엔드포인트 URL을 설정할 수 있습니다. 엔드포인트 URL이 자주 변경되지 않는 경우에 적합합니다.
    • 개별 실시간 맞춤설정 콜아웃에 대해 SegmentResponse.burl 필드를 설정하여 계정 수준 URL을 재정의하지 않는 한 모든 실시간 맞춤설정 콜아웃은 계정에 대해 구성한 계정 수준 노출 알림 URL을 사용합니다.

노출 알림 파싱

노출 알림에 전송되는 정보는 노출 알림 엔드포인트 URL의 구성에 따라 달라집니다. 엔드포인트 URL에는 쿼리 매개변수가 포함될 수 있으며, 매크로를 사용하여 노출을 유도한 낙찰가가 데이터 세그먼트를 사용한 방식에 관한 추가 컨텍스트를 포함할 수 있습니다.

매크로가 확장되는 방식 이해

매크로로 설정된 하나 이상의 쿼리 매개변수를 포함하도록 엔드포인트 URL을 구성하면 엔드포인트로 전송되는 노출 알림이 해당 매크로를 확장하여 매크로를 해당 값으로 대체합니다.

예를 들어 다음과 같이 노출 알림 엔드포인트 URL을 구성할 수 있습니다.

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

노출 알림을 수신하면 매크로가 대체되어 URL이 다음과 같이 표시됩니다.

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

지원되는 매크로 알아보기

다음은 노출 알림 엔드포인트 URL의 쿼리 매개변수에 포함할 수 있는 매크로입니다. 이러한 매크로는 하나 이상의 데이터 세그먼트가 기여한 낙찰가와 관련된 값으로 대체됩니다.

Macro 설명
${SR_ID} 해당 실시간 추천 호출의 SegmentRequest.segment_request_id 필드와 동일한 고유 문자열 ID입니다. 이는 낙찰에 기여한 하나 이상의 데이터 세그먼트 ID로 응답한 세그먼트 요청을 나타냅니다.
${SEGMENT_IDS} 낙찰에 기여한 문자열 데이터 세그먼트 ID 목록입니다. 목록의 각 항목은 '|' 문자로 구분됩니다. 예를 들어 다음과 같은 값 목록으로 확장할 수 있습니다. "segmentId1|segmentId2|segmentId3" 목록을 채우는 각 데이터 세그먼트 ID는 Marketplace API의 해당 curators.dataSegments 리소스의 리소스 ID를 참조합니다.
${AUCTION_PRICE} 경매의 낙찰가를 나타내는 문자열입니다. 가격은 단일 노출 비용 (CPI)으로, 마이크로 USD로 표시됩니다. 예를 들어 실시간 입찰 입찰가가 CPM 5달러인 경우 ${AUCTION_PRICE} 매크로가 실시간 선별 노출 알림에서 5, 000마이크로 USD CPI로 확장됩니다.
${DEAL_ID} 경매에서 낙찰된 거래 또는 패키지의 ID입니다. ${SEGMENT_IDS} 매크로로 식별할 수 있는 하나 이상의 데이터 세그먼트 ID를 타겟팅하는 할인 또는 패키지입니다.
${BUYER_SEAT_ID} 낙찰된 입찰에서 입찰자가 지정한 노출을 낙찰받은 구매자 시트의 ID입니다. 예를 들어 구매자 시트는 대행사 또는 광고주가 될 수 있습니다.

다음 단계