광고 이벤트 기록

광고 또는 추천 이벤트를 기록합니다. type에 따라 요청 형식을 선택하며, 광고와 추천 이벤트는 서로 다른 추적 토큰을 사용합니다.

광고 이벤트 (`type: "ad_log"`)

광고 응답의 ext.ad_log를 변경 없이 복사해 ad_log에 넣습니다. action에 따라 기록되는 이벤트와 선택 필드의 의미가 달라집니다.

`action`	의미 및 처리
`imp`	노출입니다. 할당의 `ad_log_tracking_mode`가 기록 시점을 결정합니다. `on_ad_response`는 A2 서버가 광고 응답을 반환할 때 기록합니다. `on_event_tracker`는 지원되는 소재의 응답에 트래커 URL을 포함하고, 클라이언트가 광고 표시 시 이 URL을 호출하면 A2가 요청을 받아 기록합니다. 같은 `imp`를 Log API에 중복 제출하지 마세요.
`vimp`	가시 노출 이벤트입니다. 설정된 `imp` 추적 모드와 별개이며, 현재 A2 Web SDK가 자동 전송하지 않습니다.
`clk`	클릭입니다. A2 Web SDK는 기본적으로 이 액션에 `price`를 포함하지 않습니다.
`conv`	전환입니다. `conversion_data.sales`는 전환 매출이고 `price`는 광고 비용입니다.

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

{"type":"ad_log","action":"clk","ad_log":"<광고 응답의 ext.ad_log>"}

추천 이벤트 (`type: "reco_log"`)

추천 응답의 tracking_token을 변경 없이 복사하고, 대상 항목 ID는 event_items에, 위치는 event_position에 넣습니다. imp의 경우 on_ad_response는 응답에 항목과 추적 토큰이 있을 때 기록하고, on_event_tracker는 클라이언트가 추천 항목이 표시됐다고 보고할 때 기록합니다. 추천 추적 모드는 응답의 ext.ad_log_tracking_mode에서 확인할 수 있습니다.

{"type":"reco_log","action":"clk","tracking_token":"<추천 응답의 tracking_token>","event_items":["catalog-item-123"],"event_position":[0]}

요청은 다운스트림 처리를 위해 수신됩니다. 수신 성공만으로 이벤트가 기록됐다고 보장하지는 않습니다.

POST

dmp

log

curl --request POST \
  --url https://your_a2_service/dmp/v0/log \
  --header 'Content-Type: application/json' \
  --data '{"type":"ad_log","action":"clk","ad_log":"<광고 응답의 ext.ad_log>"}'

type은 "ad_log"로 보냅니다. 광고 응답의 ext.ad_log를 변경 없이 복사해 ad_log에 넣습니다. action에 따라 기록되는 이벤트와 선택 필드의 의미가 달라집니다.

`action`	의미 및 처리
`imp`	노출입니다. 할당의 `ad_log_tracking_mode`가 기록 시점을 결정합니다. `on_ad_response`는 A2 서버가 광고 응답을 반환할 때 기록합니다. `on_event_tracker`는 지원되는 소재의 응답에 트래커 URL을 포함하고, 클라이언트가 광고 표시 시 이 URL을 호출하면 A2가 요청을 받아 기록합니다. 같은 `imp`를 Log API에 중복 제출하지 마세요.
`vimp`	가시 노출 이벤트입니다. 설정된 `imp` 추적 모드와 별개이며, 현재 A2 Web SDK가 자동 전송하지 않습니다.
`clk`	클릭입니다. A2 Web SDK는 기본적으로 이 액션에 `price`를 포함하지 않습니다.
`conv`	전환입니다. `conversion_data.sales`는 전환 매출이고 `price`는 광고 비용입니다.

curl --request POST \
  --url https://your_a2_service/dmp/v0/log \
  --header 'Content-Type: application/json' \
  --data '{"type":"ad_log","action":"clk","ad_log":"<광고 응답의 ext.ad_log>"}'

본문

application/json

Ad event
Recommendation event

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로 보내지 마세요.

Show child attributes

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

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

curl --request POST \
  --url https://your_a2_service/dmp/v0/log \
  --header 'Content-Type: application/json' \
  --data '{"type":"ad_log","action":"clk","ad_log":"<광고 응답의 ext.ad_log>"}'

Decision APIs

Data Management APIs

Developer APIs

광고 이벤트 기록

광고 이벤트 (`type: "ad_log"`)

추천 이벤트 (`type: "reco_log"`)

본문

응답