광고 연동

A2 플랫폼에서 광고를 요청하는 방법은 Decision API를 직접 호출하는 방법과 웹 SDK를 사용하는 방법 두 가지가 있습니다. Decision API를 직접 호출하는 방법은 광고 요청에 대한 대부분의 것을 직접 제어할 수 있는 장점이 있지만, 광고를 요청하고 보여주는 과정과 로그를 연동하는 것 모두를 직접 개발해야 하기 때문에 상대적으로 조금 더 복잡합니다.

사전 준비

API로 광고 요청을 하기 전에 광고 게재가 완료되어야 합니다. 아래 가이드를 참조하세요

광고 요청

광고 송출 API 호출 시 필요한 tagid광고 > 지면 > 지면목록 > (지면 클릭) 상세정보 페이지의 지면 정보 섹션 내 id 입니다.

A2를 사용중인 사용자라면 Developer Portal을 사용하면 실제 서비스 API를 직접 실행해볼 수 있습니다.

광고 노출

광고 송출 API에서 정상적으로 응답한 경우 아래와 같은 결과를 얻을 수 있습니다.

Response Example
{
  "ad": {
    "display": {
      "banner": {
        "img": "https://example.com/image.jpg"
      },
      "h": 1024,
      "w": 768
    },
    "id": "b56dc3bf-935d-4ee6-b1ed-f31bfc02be91"
  },
  "ext": {
    "ad_log": "YTU2ZDY2ZjctNDM4ZS00OTVjLWJiYTAtMjI4Mzk2MjQ0ZWVkfDA2NDI4NjYwLWY2NDMtNGVmNS05MzgzLTZjZmE1OGYxOGI2OXxjNTZkYzNiZi05MzVkLTRlZTYtYjFlZC1mMzFiZmMwMmJlOTF8NGJlMmQ4ZTYtYThhMS00NzI2LWEzMjAtNjkyNTYzMDkwZTQyfDllZjY2ZGM4LTBlMmMtNDlmMS05NDU3LWFmYmUwZGQ2ZjU3M3w1NTgxNmIzOTcxMWY5YjVhY2YzYjkwZTMxM2VkMjllNTE2NjU2MjNm",
    "message": "success"
  },
  "version": "0.1.0"
}

응답받은 광고 데이터로 적절한 노출 처리를 진행해야 합니다.

웹 SDK를 사용하는 경우, 지면의 설정에 맞게 소재를 실제 노출하지만 API를 사용할 경우 노출에 필요한 비지니스 로직을 직접 구현해야 합니다. 노출에 필요한 작업은 서비스 앱, 웹 사이드보다는 서버 사이드에서 진행하는 것을 강력히 권장합니다.

추가 지원이 필요하신 경우, 다음 채널을 통해 A2 지원 팀에 연락하실 수 있습니다: