> ## 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와 연동을 시작하는 방법은 목적에 따라 두 가지입니다. 광고 응답부터 확인하거나, 서비스의 상품·사용자 행동 데이터를 연결할 수 있습니다.

| 시작 경로 | 진행할 내용 | 시작하기 |
| - | - | - |
| 광고 응답 먼저 확인 | Ad Manager에서 샘플 광고를 설정하고 Decision API로 요청해 응답을 확인합니다. 카탈로그와 사용자 행동 데이터는 필요하지 않습니다. | [광고 송출 빠른 시작](https://docs.aiderx.io/development/ko/quick-start.md) |
| 상품·사용자 데이터 연동 | 상품 카탈로그, 사용자 행동 로그, 광고 이벤트를 연동합니다. 연동 후 A/B 테스트로 효과를 비교할 수 있습니다. | [상품 카탈로그](https://docs.aiderx.io/development/ko/catalog.md) · [사용자 행동 로그](https://docs.aiderx.io/development/ko/user-events.md) |

> [!NOTE]
>
> 실제 서비스에서 사용자 맞춤 광고를 제공하고 광고 성과를 높이려면 상품 카탈로그, 사용자 행동 로그, 광고 이벤트를 꼭 연동하세요.

빠른 시작의 API 광고 요청에는 액세스 토큰이 필요하지 않습니다. 관리 API로 카탈로그를 등록하려면 액세스 토큰을 준비하세요. 사용자 행동 로그는 토큰 없이 전송할 수 있습니다.

## A2에 전달하는 데이터

| 데이터 | 전달하는 내용 | A2에서의 용도 |
| - | - | - |
| [상품 카탈로그](https://docs.aiderx.io/development/ko/catalog.md) | 서비스에서 광고할 상품의 ID, 이름, 이미지, 분류 등을 전달합니다. | 상품 정보를 바탕으로 사용자에게 최적의 광고를 선택합니다. |
| [사용자 행동 로그](https://docs.aiderx.io/development/ko/user-events.md) | 카탈로그 상품의 조회·클릭·장바구니·구매 등 서비스 안에서 발생한 행동을 전달합니다. | 사용자의 관심과 행동을 파악해 광고 선택에 활용합니다. |
| [광고 이벤트 추적](https://docs.aiderx.io/development/ko/ad-events-and-logs.md) | A2가 선택한 광고의 노출·클릭·전환을 전달합니다. | 광고별 성과를 집계하고, 예산과 목표 노출량에 맞춰 광고 노출 속도(페이싱)를 조절합니다. |

상품 기반 광고나 추천에 사용할 상품은 카탈로그에 등록합니다. Quickstart의 샘플 하우스 광고에는 카탈로그가 필요하지 않습니다. 사용자 행동 로그는 서비스에서 수집할 수 있는 지원 이벤트를 최대한 전달합니다. 광고 추적은 설정에 맞게 노출과 클릭을 연결하고, 구매 등 목표 행동을 측정한다면 전환도 연결합니다.

> [!NOTE]
>
> 사용자 행동 로그는 A2 광고를 거쳤는지와 관계없이 카탈로그 상품에 대한 행동을 보냅니다. 광고 추적은 A2가 선택한 광고에 발생한 결과를 보냅니다. 같은 구매가 두 목적에 해당하면 각각의 로그를 보냅니다.

## 데이터 연동을 시작하기 전에

A2 환경 구축을 마치고 API 접속 주소를 전달받아야 합니다. 상품·사용자 데이터를 연결한다면 다음 항목도 준비합니다.

| 준비 항목 | 확인할 내용 |
| - | - |
| API 접속 주소 | 구축된 환경의 주소와 접속 가능한 네트워크를 확인합니다. |
| Ad Manager 계정 | 액세스 토큰 발급, 광고 설정, 분석에 필요한 계정을 확인합니다. |
| 상품 정보 | 광고할 상품과 상품 ID를 확인합니다. |
| 사용자·기기 식별자 | 서비스에서 사용하는 사용자 ID와 기기 ID를 확인합니다. |
| 측정 목표 | 클릭·구매 등 비교할 행동과 그 행동이 발생하는 시점을 정합니다. |

## 다음 단계

광고 응답부터 확인하려면 [광고 송출 빠른 시작](https://docs.aiderx.io/development/ko/quick-start.md)을 진행하세요. API 접속 주소와 관리자 계정이 필요합니다.

카탈로그 연동을 위해 토큰이 필요하면 [API 접속과 인증](https://docs.aiderx.io/development/ko/api-access-and-auth.md)에서 발급 방법을 확인하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.