> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# A2 시작하기: 기본 사용법

> 이 가이드는 A2를 활용하여 이미지 배너 광고를 구성하고 광고 지면에 노출하는 핵심 단계를 빠르고 정확하게 따라갈 수 있도록 구성되었습니다.

본 페이지에서는 다음과 같은 내용을 학습할 수 있습니다.

1. 광고 지면 설정
2. 이미지 배너 광고 구성
3. 웹사이트에 광고 서빙
4. 광고 성과 추적

## 접속 및 대시보드

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/KclYOzNNZfU9VhbwJMZc?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: First-Time Login and Password Reset"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

A2 서비스를 처음 사용할 경우, 접속 방법이 안내된 이메일을 받게 됩니다. 해당 이메일을 따라가면 신청한 이메일 계정을 사용하여 A2 관리자 계정으로 접속할 수 있습니다. 첫 접속 시 비밀번호 변경을 권장하는 메시지가 표시됩니다. 우측 상단의 계정을 클릭한 후, `내 계정` 메뉴에서 비밀번호를 변경할 수 있습니다.

## 관리자 계정 예산 할당

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/0HTgNwj9xEbVPXCw8FXf?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Allocating Budget to the Admin Account"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

A2의 광고는 캠페인에 할당된 예산을 기반으로 최적화 알고리즘이 동작합니다. 이를 위해 관리자 계정에 예산을 할당하는 과정이 필요합니다.

1. 왼쪽 사이드바에서 `관리자` > `계정 관리` > `관리자 계정 예산 수정` 클릭
2. 남은 크레딧에 `10000` 입력 후 `계정 예산 저장` 클릭

이제 캠페인에서 사용할 예산이 확보되었습니다. 다음 단계에서는 광고를 실제로 노출할 지면을 설정하는 방법을 알아보겠습니다.

## 광고 지면(Placement) 설정

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/pQ8TWhN3eiB5LNif8ciA?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Setting Up Ad Placements"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

광고를 노출하기 위해서는 광고 지면을 먼저 설정해야 합니다. 광고 지면이란 광고가 게재될 특정 위치를 의미하며, 여러 캠페인을 할당할 수 있습니다. 설정된 지면을 기반으로 최적화 모델이 작동하여 개인화된 광고를 제공하게 됩니다.

1. 대시보드에서 `지면 생성` 버튼 클릭
2. 다음 정보를 입력하고 나머지 설정은 기본값 유지
   * 허용할 소재 유형: `디스플레이`
   * 이름: `Placement1`
   * 설명: `Test placement`
   * 폭: `1200`
   * 높이: `120`
3. `만들기 후 상세 설정` 클릭
4. 입력된 정보 확인 후 `저장` 클릭
5. 왼쪽 사이드바에서 `광고` > `지면` > `지면 목록` 클릭
6. 생성된 지면 확인 후 `사용 상태`를 클릭하여 활성화

> 더 다양한 광고 지면 설정 방법은 [지면 가이드](/guides/about-a2/ko/placement)에서 확인하세요.

이제 광고를 게재할 지면이 준비되었습니다. 다음으로는 이 지면에 노출될 광고 캠페인을 생성하는 방법을 알아보겠습니다.

## 캠페인(Campaign), 소재(Creative) 생성 및 배정요청 하기

### 캠페인 생성

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/MZQD26skaoCZqediDGzV?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Creating a Campaign"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

캠페인은 광고를 운영하는 기본 단위이며, 목표와 예산을 설정하여 원하는 기간 동안 광고를 집행할 수 있도록 합니다.

1. 대시보드에서 `캠페인 생성` 클릭
2. 목표 설정에서 `노출` 클릭
3. 다음과 같이 입력하고 기본값 유지
   * 이름: `Campaign1`
   * 설명: `Test campaign`
   * 예산: `1000`
   * 캠페인 기간: 시작일의 시간을 00:00으로 변경
4. `만들기` 클릭
5. 생성된 캠페인 확인

> 본 가이드에서 캠페인 시작 기간을 조정하는 이유는 이후 광고 노출이 되는 것을 바로 확인하기 위함입니다. 실제 사용에서는 캠페인이 시작되길 원하는 시간으로 설정하시면 됩니다. 더 자세한 내용은 [캠페인 가이드](https://aiderx.io/ko/articles/campaign)에서 확인하실 수 있습니다.

이제 캠페인이 설정되었습니다. 하지만 캠페인만으로는 광고를 노출할 수 없습니다. 광고에 실제로 표시될 소재를 등록해야 합니다.

### 소재(creative) 생성하기

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/naEvn5ojNKqGRUSoYVOu?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Creating a Creative"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

소재는 광고가 실제로 사용자에게 보여지는 이미지 또는 영상 등의 콘텐츠입니다. 이번 예제에서는 배너 이미지를 생성하여 광고 클릭 시 특정 페이지로 이동하도록 설정하겠습니다.

1. 캠페인 페이지에서 `새로운 소재` 클릭
2. `배너` 클릭
3. 다음 정보 입력
   * 이름: `A2 Banner`
   * 설명: `A2 Pricing page`
4. `만들기` 클릭
5. `배너 소재` 입력 후 `저장` 클릭
   * 이동할 주소: `https://aiderx.io/pricing`
   * 이미지: `URL` 클릭 후 `https://cdn.aiderx.app/public/media/a2_banner.png` 입력 후 `불러오기` 클릭
6. `활성화` 버튼 클릭

> A2에서는 다양한 소재를 지원하며, 자세한 설정 방법은 [소재 가이드](/guides/about-a2/ko/creative)에서 확인할 수 있습니다.

이제 이 캠페인을 광고 지면에 배정하여 실제로 광고를 게재할 수 있도록 하겠습니다.

### 배정(allocation) 요청

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/1lBZnTTOohpLI2RGemVL?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Allocating the Campaign"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

배정은 특정 캠페인이 특정 지면에 노출되도록 설정하는 과정입니다. 광고를 운영하려면 반드시 캠페인을 지면에 배정해야 합니다.

1. 캠페인 페이지에서 `새로운 지면 배정` 클릭
2. `Placement1` 선택
3. `선택 후 상세 설정` 클릭
4. `저장` 클릭
5. 배정 목록에서 `게재 요청` 클릭 후 `게재 승인` 클릭

> 배정에서 사용가능한 다양한 옵션은 [배정 가이드](/guides/about-a2/ko/allocation)에서 확인 가능합니다.

이제 광고 노출을 위한 모든 준비가 완료되었습니다. 다음으로 실제 웹사이트에서 광고를 노출하는 방법을 알아보겠습니다.

## 광고 연동하기

### 지면 태그 활용하여 광고 요청하기

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/CJMXT6d6t99QNKB4pKEY?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Serving Ads with Placement Tag"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

A2에서는 광고를 쉽게 노출할 수 있도록 SDK를 제공합니다. SDK를 활용하면 웹사이트에서 간단한 코드 추가만으로 광고를 삽입할 수 있습니다.

1. 왼쪽 사이드바에서 `광고` > `지면` > `지면 목록` 클릭
2. `Placement1` 선택
3. `지면 정보` 우측 `지면 태그 가져오기` 클릭

하단의 다운로드 가능한 HTML을 통해 실제 동작하는 홈페이지 예시도 확인가능합니다.

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

SDK 외에도 A2-Edge Endpoint에 직접 요청하여 광고를 얻을 수도 있습니다.

1. **요청 보내기**

   ```bash theme={null}
   $> curl -X POST \
      -H "Content-type: Application/json" \
      http://{기본경로}/app/v0/ad/{tagid} \
      -d '{"version": "0.1.0", "user": {"id": "test_user_id"}}'
   ```

2. **응답 확인하기**

   다음과 같은 결과가 출력된다면 정상입니다. (주의. id 값은 다를 수 있습니다)

   ```json theme={null}
   {
     "version": "0.1.0",
     "ad": {
       "id": "97a5f9d2-8965-45f1-aa3d-a100508a3785",
       "display": {
         "w": 1200,
         "h": 120,
         "banner": {
           "img": "https://cdn.aiderx.app/public/media/a2_banner.png",
           "link": {
             "url": "https://aiderx.io/pricing",
             "ext": {}
           },
           "ext": {
             "cdn": "url"
           }
         }
       }
     },
     "ext": {
       "ad_log": "ZTk0ZWI0ZWItYjZmZC00ZmVjLWIzOWEtMGY0ZWIyODJiN2NmfDJhNGE4OGNhLTI0M2UtNDUwYy1hYjRlLTMyNjc5NmQ5Y2U0OXw5N2E1ZjlkMi04OTY1LTQ1ZjEtYWEzZC1hMTAwNTA4YTM3ODV8MTg1OWZiZTMtYzBiYy00NDU1LWIyMmItZjkwYzk1MDNhOGUxfGJkNWJmOWMyLTI2MGYtNDJjYS04NzI3LWMyZjJkN2EyNjg5MXx0ZXN0X3VzZXJfaWQ",
       "message": "success"
     }
   }
   ```

> 광고 요청하는 자세한 방법은 [문서](/development/ko/serving-ad)를 참고하세요.
> 상세한 API Spec은 [A2 API Specification](https://aiderx.io/a2-api-specification)를 참고하세요.

### A2-Event API로 Adlog 보내기

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

* API endpoint는 `/dmp/v0/log` 입니다.

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

1. **ad log 보내기**

   * *ad log*는 사용자에게 광고를 노출한 이후 발생한 이벤트로 A2-Edge의 응답에 포함된 `ad_log`를 함께 보내야 합니다.
   * A2는 `ad_log`를 이용하여 광고 관련 정보를 구분합니다.
   * SDK를 활용할 경우에는 `ad log`도 자동으로 연동되어 따로 보낼 필요가 없습니다.

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

2. **action log 보내기**

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

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

> 상세한 API Spec은 [A2 API Specification](https://aiderx.io/a2-api-specification)를 참고하세요.

## 광고 성과 추적

<div
  style={{
position: "relative",
paddingBottom: "calc(52.083333333333336% + 41px)",
height: 0,
width: "100%",
}}
>
  <iframe
    src="https://demo.arcade.software/IiKQpQ3zJ86xhZUX64Ab?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true"
    title="Getting Started with A2: Tracking Ad Performance"
    frameBorder="0"
    loading="lazy"
    allowFullScreen
    allow="clipboard-write"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  colorScheme: "light",
}}
  />
</div>

광고가 유저에게 노출되기 시작하면 광고 성과를 확인하는 것이 중요합니다. 광고 성과를 분석하면 캠페인을 최적화하고 효율을 극대화할 수 있습니다.

1. 왼쪽 사이드바 `일반` > `분석` > `지면` 혹은 `캠페인`
2. `지면 상세 페이지` 최상단
3. `캠페인 상세 페이지` 최상단

***

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