효과적인 광고 모델링과 지표 추적을 위해 광고 로그 연동이 필요합니다. 광고 로그 연동은 웹 기반과 API 기반 두 가지 방식으로 진행할 수 있으며, 각각의 방법에 따라 광고 요청과 노출, 클릭, 전환 등의 로그를 수집하고 분석할 수 있습니다. 아래에서 각 방식을 설명합니다.

​
웹 SDK를 활용한 방법

웹 SDK를 사용 중인 경우엔 별도의 광고 로그 연동 작업이 필요하지 않습니다.

​
API를 활용한 방법

API를 활용한 광고 로그 연동 방식은, 광고 노출과 전환, 클릭과 같은 다양한 액션에 대해 직접 로그를 연동할 수 있는 방법입니다. A2서는 광고 서빙 응답 데이터의 ext.ad_log 필드를 기반으로 로그를 추적하며, 광고 효과 분석을 위해 필요에 따라 노출 로그도 연동할 수 있습니다.

  1. Endpoint

  2. 예시

    • 클릭 로그
      • 유저가 광고를 클릭했을 때 보내주는 데이터입니다.
{
    "type": "ad_log",
    "action": "clk",
    "ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8YjM4M2M4YWYtZWUzZi00MDljLTlmOWYtODgxYTI4YWZjYmVjfDk3NGIwOGI4LTc1MjYtNDFkMC04MTg5LWQ4MTVkNTFlZGNlZnw"
}'
  • 전환 로그
    • 유저가 광고를 보고 난 후 원하는 활동(전환)이 이루어졌을 때 보내는 로그입니다.
    • 이때 전환은 다음과 같은 활동을 의미할 수 있고 아래 예시에 한정되지 않습니다.
      • 상품 구매
      • 상품 장바구니
      • 앱 설치
      • 서비스 가입
      • 다운로드
      • 링크 클릭
      • 일정 시간 동안 컨텐츠 소비
{
    "type": "ad_log",    
    "action": "conv",    
    "ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8YjM4M2M4YWYtZWUzZi00MDljLTlmOWYtODgxYTI4YWZjYmVjfDk3NGIwOGI4LTc1MjYtNDFkMC04MTg5LWQ4MTVkNTFlZGNlZnw",
    "price": 18123,
}
  • (Optional) 노출 로그
    • A2에서는 노출 로그가 반드시 필요하지는 않으나 정확한 지표 측정을 위해 노출 로그 연동을 권장합니다.
    • 노출 로그는 유저에게 광고가 실제로 노출되었을 때 보내는 것을 의미합니다.
      • 이때 광고의 노출 여부는 광고의 50% 이상이 1초 이상 유저의 화면에 노출을 기준으로 측정하기를 권장합니다.
      • 시스템 상의 제약이나 현실적인 여러 이유로 인해 위 기준을 충족하지 못할 경우 최소한 동일한 기준으로 노출 여부를 측정하기를 권장합니다.
{
    "type": "ad_log",
    "action": "vimp",
    "ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8YjM4M2M4YWYtZWUzZi00MDljLTlmOWYtODgxYTI4YWZjYmVjfDk3NGIwOGI4LTc1MjYtNDFkMC04MTg5LWQ4MTVkNTFlZGNlZnw"
}

이 가이드가 광고 로그 연동에 도움이 되길 바랍니다. 더 궁금한 사항이 있거나 추가 지원이 필요하시면 언제든지 문의해 주세요. 감사합니다.