메인 콘텐츠로 건너뛰기
POST
type으로 광고 이벤트(ad_log)와 추천 이벤트(reco_log)를 구분하고, 각 응답에서 받은 추적 토큰을 그대로 넣습니다. 요청이 성공해도 이벤트가 기록됐다는 뜻은 아닙니다. 토큰이 바뀌었거나 필드 형식이 맞지 않는 이벤트는 기록되지 않습니다.

광고 이벤트 (ad_log)

광고 응답의 ext.ad_log를 ad_log에 그대로 넣어 클릭과 전환을 보냅니다.
  • clk: 사용자가 광고를 클릭하면 보냅니다.
  • conv: 광고를 본 사용자가 구매 같은 전환을 하면 보냅니다. 전환 매출은 conversion_data.sales에 넣습니다.

광고 노출

광고 노출은 A2가 기록합니다. 기록 시점은 Ad Manager의 게재 승인에서 정한 노출 추적 방식에 따라 다릅니다.
  • 광고 응답 기준(on_ad_response, 기본값): A2가 광고 응답을 보낼 때 노출을 자동 집계합니다.
  • 노출 이벤트 기준(on_event_tracker): 광고를 표시할 때 A2 노출 트래커 URL을 호출하면 A2가 노출을 기록합니다. A2에서 관리하는 배너는 ad.display.event에, 지원되는 네이티브 응답은 ad.display.native.eventtrackers에 이 URL이 들어갑니다.
외부 네트워크 배너와 비디오 등 A2 노출 트래커가 없는 광고는 on_ad_response로 설정합니다. 이 경우 A2가 광고 응답을 보낼 때 노출을 자동 집계하므로, 별도로 노출 이벤트를 보내지 않아도 됩니다. 실제 화면에 표시되지 않아도 노출로 집계됩니다. A2가 이미 기록한 노출에 대해 이 API로 imp를 추가 전송하면 중복 집계됩니다. vimp는 광고 지표에 집계되지 않습니다.

추천 이벤트 (reco_log)

추천 응답의 tracking_token을 그대로 넣습니다. 상품의 카탈로그 ID는 event_items에, 응답의 position 값은 event_position에 같은 순서로 넣습니다.
  • imp: 추천 목록을 표시할 때 응답의 상품을 모두 넣어 한 번 보냅니다.
  • vimp: 화면에 실제로 보인 상품을 보냅니다. 같은 상품은 한 번만 보냅니다.
  • clk: 사용자가 클릭한 상품을 보냅니다.
  • conv: 추천 상품에서 시작된 구매가 완료되면 구매한 상품을 보냅니다.
추천 응답의 ext.ad_log_tracking_mode가 on_ad_response이면 imp는 A2가 응답할 때 기록하므로 보내지 않습니다. 기본값은 on_event_tracker입니다. 응답에 없는 위치는 집계되지 않습니다.

본문

application/json
action
필수

이벤트 종류입니다. 각 이벤트에 action을 명시적으로 전송하세요.

Allowed value: "clk"
ad_log
string
필수

필수 광고 추적 토큰입니다. 광고 응답의 ext.ad_log 값을 변경 없이 복사하세요.

type
string
필수
Allowed value: "ad_log"
conversion_data
object | null

선택적 전환 데이터입니다. action=conv일 때 다운스트림 지표는 sales를 전환 매출로 읽으며 price/비용과 구분합니다. 구매 금액은 광고 비용이기도 한 경우가 아니라면 price로 보내지 마세요.

custom_targeting
object | null

다운스트림 광고 로그 처리로 전달되는 선택적 custom targeting 속성

price
number<double> | null

이벤트에 추가로 반영할 선택적 광고 비용입니다. A2가 추적하는 노출의 비용은 자동 기록되므로 해당 비용에 price를 다시 지정하지 마세요. 광고 응답만으로 A2가 추적할 수 없는 전환 수수료 같은 비용에만 price를 지정하고, A2가 이미 기록한 비용을 다시 보고하지 마세요. 다운스트림 광고 지표는 전달된 price를 비용(spend)에 합산합니다. 전환 매출(conversion_data.sales)과는 별개입니다.

timestamp_in_ms
integer<int64>

선택적 이벤트 시각입니다. Unix 타임스탬프를 정수 밀리초로 전송합니다. 생략하면 광고 로그 처리 시점의 시각을 사용합니다.

응답

200

다운스트림 처리를 위해 요청을 수신했습니다.