로그 수집
이벤트 기록
광고나 추천 결과에 대한 사용자 반응(노출, 클릭, 전환)을 A2에 보냅니다.
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이 들어갑니다.
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
- ad_log
- reco_log
이벤트 종류입니다. 각 이벤트에 action을 명시적으로 전송하세요.
Allowed value:
"clk"필수 광고 추적 토큰입니다. 광고 응답의 ext.ad_log 값을 변경 없이 복사하세요.
Allowed value:
"ad_log"선택적 전환 데이터입니다. action=conv일 때 다운스트림 지표는 sales를 전환 매출로 읽으며 price/비용과 구분합니다. 구매 금액은 광고 비용이기도 한 경우가 아니라면 price로 보내지 마세요.
다운스트림 광고 로그 처리로 전달되는 선택적 custom targeting 속성
이벤트에 추가로 반영할 선택적 광고 비용입니다. A2가 추적하는 노출의 비용은 자동 기록되므로 해당 비용에 price를 다시 지정하지 마세요. 광고 응답만으로 A2가 추적할 수 없는 전환 수수료 같은 비용에만 price를 지정하고, A2가 이미 기록한 비용을 다시 보고하지 마세요. 다운스트림 광고 지표는 전달된 price를 비용(spend)에 합산합니다. 전환 매출(conversion_data.sales)과는 별개입니다.
선택적 이벤트 시각입니다. Unix 타임스탬프를 정수 밀리초로 전송합니다. 생략하면 광고 로그 처리 시점의 시각을 사용합니다.
응답
200
다운스트림 처리를 위해 요청을 수신했습니다.
