A2 시작하기: 기본 사용법

접속 방법

액세스 A2-ADM (광고 관리자)
- A2 CE의 기본 경로: http://localhost
- A2 클라우드의 기본 경로: http://{customer_id}.aiderx.app
로그인
- A2 CE: 기본 관리자 계정의 아이디 / 비밀번호는 a2@aiderx.io / password 입니다.
- A2 Cloud: 등록된 이메일이 기본 관리자 계정이고 비밀번호는 password 입니다.
개인정보처리방침에 동의하고 확인.

홈 화면

계정 생성하기

A2-ADM의 계정은 역할과 권한에 따라 관리자(admin), 리테일러(retailer) 와 광고주(advertiser) 유형으로 구분합니다. 이 가이드에서는 편의상 관리자 계정에서 연결하기 기능을 사용하여 진행합니다.

광고주 계정 생성

왼쪽 사이드바에서 관리자 > 계정관리 > 광고주 목록 클릭
+ 광고주 계정 추가 클릭
광고주 계정 정보(이름, 이메일, 비밀번호, 초기예산) 입력
계정추가 클릭
광고주 계정 목록에 생성한 계정이 보이면 생성 완료.

리테일러 계정 생성

왼쪽 사이드바에서 관리자 > 계정관리 > 리테일러 목록 클릭
+ 리테일러 계정 추가 클릭
리테일러 계정 정보(이름, 이메일, 비밀번호, 초기예산) 입력
계정추가 클릭
리테일러 계정 목록에 생성한 계정이 보이면 생성 완료.

지면(placement) 생성하기

리테일러 계정연동

왼쪽 사이드바에서 관리자 > 계정관리 > 리테일러 목록 클릭
생성한 계정의 우측 연결하기 클릭
왼쪽 사이드바에 리테일러 계정 활성화

지면 생성

왼쪽 사이드바에서 광고 > 지면 > 지면 목록 클릭
+ 새로운 지면 클릭
지면 정보 입력 > 만들기 후 상세설정 클릭
지면 상세정보 입력 > 저장 클릭
왼쪽 사이드바의 계정이름 옆 빨간색 버튼 클릭하여 계정 연결 해제

‍

캠페인(campaign), 소재(creative) 생성 및 배정요청 하기

광고주 계정연동

왼쪽 사이드바에서 관리자 > 계정관리 > 광고주 목록 클릭
생성한 계정의 우측 연결하기 클릭
왼쪽 사이드바에 광고주 계정 활성화

캠페인 생성

왼쪽 사이드바에서 광고 > 캠페인 > 캠페인 목록 클릭
+ 새로운 캠페인 클릭
노출 클릭
캠페인 정보 입력 > 만들기 클릭
캠페인 정보 화면

소재(creative) 생성하기

소재 목록 옆 + 새로운 소재 클릭
배너 클릭
소재 기본 정보 입력 > 만들기 클릭
배너 소재 입력 > 저장 클릭
- 이동할 주소에 'https://aiderx.io' 입력
- URL 클릭 > 'https://cdn.prod.website-files.com/668de9e1f25ab5675d87758d/6690cf1bdce95af5e3522c25_a2_logo_800_250.png' 입력 > 불러오기 클릭
- 노출크기에 600, 180 입력
소재 목록에서 생성한 배너 확인
활성화 클릭하여 소재 상태 변경

배정(allocation) 요청

배정 우측 새로운 지면 배정 클릭
지면 선택
선택 후 상세 설정 클릭
저장 클릭
배정 목록에서 게재 요청 클릭

캠페인 게재 승인하기

리테일러 계정 연결하여 리테일러 목록으로 이동
첫번째 지면 클릭하여 상세 화면으로 이동
검토 컬럼의 초록색 화살표 클릭하여 승인
캠페인 상태가 "게재됨" 으로 변경된 것을 확인
지면정보의 'id' 값은 tagid 라 부르며 광고 요청 시 아이디 값으로 사용합니다

광고 송출 준비가 완료되었습니다.

A2-SSP(Supply-Side Platform)로 광고 요청하기

이제 A2-SSP 엔드포인트에서 광고 소재를 요청하고 결과를 받을 수 있습니다.

요청 보내기

$> curl -X POST \
   -H "Content-type: Application/json" \
   http://{base_url}/app/v0/ad/{tagid} \
   -d '{"version": "0.1.0", "user": {"id": "test_user_id"}}'

응답 확인하기‍

다음과 같은 결과가 출력되면 제대로 작동하는 것입니다.

{
  "version": "0.1.0",
  "ad": {
    "id": "97a5f9d2-8965-45f1-aa3d-a100508a3785",
    "display": {
      "w": 600,
      "h": 180,
      "banner": {
        "img": "https://cdn.prod.website-files.com/668de9e1f25ab5675d87758d/6690cf1bdce95af5e3522c25_a2_logo_800_250.png",
        "link": {
          "url": "https://aiderx.io",
          "ext": {}
        },
        "ext": {
          "cdn": "url"
        }
      }
    }
  },
  "ext": {
    "ad_log": "ZTk0ZWI0ZWItYjZmZC00ZmVjLWIzOWEtMGY0ZWIyODJiN2NmfDJhNGE4OGNhLTI0M2UtNDUwYy1hYjRlLTMyNjc5NmQ5Y2U0OXw5N2E1ZjlkMi04OTY1LTQ1ZjEtYWEzZC1hMTAwNTA4YTM3ODV8MTg1OWZiZTMtYzBiYy00NDU1LWIyMmItZjkwYzk1MDNhOGUxfGJkNWJmOWMyLTI2MGYtNDJjYS04NzI3LWMyZjJkN2EyNjg5MXx0ZXN0X3VzZXJfaWQ",
    "message": "success"
  }
}

광고 요청하는 자세한 방법은 문서를 참고하세요. 상세한 API Spec은 A2 API Specification를 참고하세요.

A2-Event API로 Adlog 보내기

A2 Event API를 사용하여 사용자 관련 로그를 전송하는 방법을 알아보겠습니다.

API endpoint는 /app/v0/log 입니다.

A2는 수집된 사용자 로그를 광고 모델의 학습 데이터와 캠페인 분석에 활용합니다.

ad log 보내기

ad log는 사용자에게 광고를 노출한 이후 발생한 이벤트로 A2-SSP의 응답에 포함된 ad_log를 함께 보내야 합니다.

A2는 ad_log를 이용하여 광고 관련 정보를 구분합니다.

$> curl -X POST \
   -H "Content-type: Application/json" \
   http://{기본경로}/app/v0/log \
   -d '{
         "type": "ad_log",
         "action": "conv",
         "ad_log": "ZTk0ZWI0ZWItYjZmZC00ZmVjLWIzOWEtMGY0ZWIyODJiN2NmfDJhNGE4OGNhLTI0M2UtNDUwYy1hYjRlLTMyNjc5NmQ5Y2U0OXw5N2E1ZjlkMi04OTY1LTQ1ZjEtYWEzZC1hMTAwNTA4YTM3ODV8MTg1OWZiZTMtYzBiYy00NDU1LWIyMmItZjkwYzk1MDNhOGUxfGJkNWJmOWMyLTI2MGYtNDJjYS04NzI3LWMyZjJkN2EyNjg5MXx0ZXN0X3VzZXJfaWQ"
       }'

‍

action log 보내기

action log는 사용자의 다양한 행동로그로 클릭, 노출, 뷰, 구매, 장바구니, 검색 등이 해당합니다.

$> curl -X POST \
   -H "Content-type: Application/json" \
   http://{기본경로}/app/v0/log \
   -d '{
         "type": "action_log",
         "action": "purchase",
         "user_id": "test_user_u0",
         "item_id": "test_item_i1",
       }'

‍

상세한 API Spec은 A2 API Specification를 참고하세요.

이것으로 A2 시작하기 가이드를 마칩니다.
이 가이드를 통해 A2를 로컬 환경에서 설정하고 기본적인 사용법을 익히셨기를 바랍니다.
추가 문의 사항이 있으면 언제든지 지원팀에 연락해 주세요.

다음 단계

A2에 대해 더 자세히 알아보고 싶으시다면, 다음 문서들을 참조하시기 바랍니다:

A2 아키텍처 개요 - A2의 전체적인 구조와 각 구성 요소의 역할을 이해할 수 있습니다.
A2 API 명세서 - A2의 모든 API에 대한 상세한 명세를 제공합니다. 고급 기능을 활용하고자 할 때 참조하세요.