API 직접 연동과 Web SDK 비교
API 직접 연동과 Web SDK 비교
A2는 Decision API를 직접 호출하거나 Web SDK를 사용해 광고를 연동할 수 있습니다. 앱이나 서버 환경에서도 사용할 수 있고 처리 방식을 직접 제어할 수 있는 API 직접 연동을 기본 경로로 안내합니다.
Web SDK는 브라우저의 DOM과
localStorage를 사용하므로 앱이나 서버에서 같은 방식으로 사용할 수 없습니다. 제공되는 SDK 빌드와 설정은 환경마다 다를 수 있으므로 적용 전에 사용 가능한 번들과 옵션을 확인하세요. Web SDK 설치와 사용 방법은 별도 문서로 준비하고 있습니다.실습 준비
실습에는 액세스 토큰이 필요 없습니다. 시작하기 전에 다음 항목을 준비하세요.- A2 접속 주소: API 접속과 인증에서 확인합니다.
- 광고 단위: 광고를 표시할 영역인 광고 단위에 이미지 배너 소재가 연결된 광고가 배정되어 있고, 현재 송출할 수 있어야 합니다. 결과를 다른 트래픽과 구분할 수 있도록 검증용 광고 단위를 사용하세요.
- 광고 설정: 맞춤 타겟팅 없이 빈 요청
{}으로 선택될 수 있어야 하며, 배정의 노출 추적 방식이 광고 응답 기준(기본값)이어야 합니다. - Ad Manager 계정: 광고 단위 ID 확인과 광고 단위 분석 조회에 관리자 또는 운영자 계정이 필요합니다.
- 실행 도구: curl, 텍스트 편집기, 웹 브라우저, 로컬 웹 서버를 실행할 Python 3
1
광고 단위 선택하기
Ad Manager의 인벤토리 > 광고 단위에서 광고를 요청할 광고 단위를 선택합니다.
2
설정 탭 열기
광고 단위 상세 화면에서 설정 탭을 선택합니다.
3
광고 단위 ID 복사하기
기본 정보의 ID를 복사합니다.
광고 요청과 표시
광고 요청하기
빈 JSON 객체로 광고를 요청합니다.200과 광고 응답이 반환됩니다. 이미지 배너 응답에서 표시할 이미지와 랜딩 주소는 ad.display.banner, 이벤트에 사용할 광고 추적 식별자는 최상위 ext.ad_log에서 확인합니다.
Response (일부)
204는 반환할 광고가 없다는 정상 응답입니다. 응답 본문을 JSON으로 해석하지 말고 송출할 광고 설정을 확인하세요.
이미지 배너 표시하기
아래 예제는 광고를 새로 요청합니다. 앞선 curl 요청과 다른 광고가 반환될 수 있으며, 클릭 이벤트에는 웹 화면에 표시된 광고의ad_log를 사용하세요.
다음 내용을 quick-start.html로 저장하고 baseUrl과 tagid를 바꿉니다.
http://localhost:8000/quick-start.html을 엽니다.
ad_log는 배너 이미지가 표시된 경우에만 나타납니다. 광고가 없거나 요청·이미지 로딩에 실패하면 광고 영역에 표시된 메시지를 확인하고, 클릭 이벤트 전송 단계로 넘어가지 마세요.
이미지가 표시되면 배너를 한 번 클릭해 랜딩 페이지가 열리는지 확인한 뒤, 화면에 표시된 ad_log를 복사합니다.
클릭 이벤트 전송
<ad_log>를 웹 화면에서 복사한 ad_log로 바꿔 클릭 이벤트를 한 번 보냅니다.
200을 확인한 뒤 실제 수집 여부를 다음 절에서 확인하세요.
결과 확인
Ad Manager의 분석 > 광고 인벤토리 분석 > 광고 단위 분석에서 실습에 사용한 광고 단위를 선택하고 조회 기간을 오늘로 설정합니다. 실습 전에 확인한 값보다 클릭 수가 1 늘었는지 확인하세요. 노출은 curl과 웹 페이지의 광고 요청 중 광고가 반환된 요청마다 기록되므로, 노출 수는 그 횟수만큼 늘어날 수 있습니다. 광고 없음 응답(HTTP204)을 받은 요청은 노출로 기록되지 않습니다.
기본 설정에서는 클릭 이벤트가 보통 1분 안에 집계에 반영됩니다. 1분 정도 지난 뒤 브라우저에서 페이지를 다시 불러와 확인하고, 확인을 위해 클릭 이벤트를 반복해서 전송하지 마세요. 다시 불러와도 반영되지 않으면 이벤트 전송은 성공했는데 리포트에 반영되지 않을 때를 참고하세요.
다음 단계
1
서비스 구현 확장하기
광고 송출 연동과 광고 이벤트·로그 연동에서 소재별 표시와 노출·클릭·전환 처리를 구현합니다.
2
완료 여부 확인하기
연동 검증과 문제 해결의 검증표로 API 응답과 리포트 반영을 확인합니다.
