# Direct ADs API

***

## 테스트 지면정보

광고 요청 시, 아래 placementID를 이용해 연동 및 테스트 해 주세요.

상용 키는 요청 시, 별도로 전달 예정입니다.

<table><thead><tr><th width="168">OS</th><th width="368">PlacementID</th><th>Size</th></tr></thead><tbody><tr><td>iOS</td><td>c66ccd8e-c402-4823-ae01-85c1b5b8b387</td><td>335x120</td></tr><tr><td>Android</td><td>c06a1383-325f-4f60-b5cc-4f98551220d3</td><td>335x120</td></tr></tbody></table>

***

## 직광고 요청 API

직광고는 직광고 어드민을 통해 등록된 광고를 조회할 수 있습니다. 노출 기간 등 광고 세팅에 따라 노출 가능한 광고만 조회됩니다.

### 요청 값

광고 요청에는 '광고ID(AD-ID / IDFA)'가 필요하며, 광고ID가 포함되지 않은 경우, 일부 직광고를 조회할 수 없습니다.&#x20;

| 파라미터 이름     | 타입     | 필수 여부 | 설명       |
| ----------- | ------ | ----- | -------- |
| userKey     | String | 필수    | 사용자 키    |
| placementID | String | 필수    | 광고 위치 ID |
| deviceADID  | String | 필수 아님 | 기기 광고 ID |

### 응답 값

placementID와 advertiseID는 임프레션 및 참여에 사용됩니다.  imageUrl 로 사용자에게 보여지는 이미지를 구성하고, 사용자가 클릭 시, landingUrl로 이동시킵니다.

받을 보상이 없는 경우 reward 값이 0으로 반환됩니다.

useInAppBrowser이 true인 경우, 인앱브라우저로 랜딩시켜주세요.

| 파라미터 이름         | 타입      | 설명             |
| --------------- | ------- | -------------- |
| placementID     | String  | 광고 지면 ID       |
| advertiseID     | String  | 광고 ID          |
| title           | String  | 제목             |
| productID       | String  | 제품 ID          |
| imageUrl        | String  | 이미지 URL        |
| reward          | String  | 보상             |
| landingUrl      | String  | 랜딩 페이지 URL     |
| useInAppBrowser | Boolean | 앱 내 브라우저 사용 여부 |

### 구현

[안드로이드 구현 코드](https://avatye.gitbook.io/spc/android-native#code-android-request-directad)

[iOS 구현 코드](https://avatye.gitbook.io/spc/ios-native#ios-code-request-directad)

***

## 직광고 임프레션 API

사용자에게 광고가 노출되는 시점에 임프레션을 호출합니다. 응답 값은 따로 없으며 호출만 해주시면 됩니다.

{% hint style="warning" %}
임프레션이 정상적으로 이루어지지 않으면 사용자의 적립 또는 매출정산이 정상적으로 이루어지지 않을 수 있으므로, 반드시 호출해주셔야 합니다.
{% endhint %}

### 요청 값

deviceADID는 사용자의 중복 참여를 막기위한 기준 값이 됩니다.

| 파라미터 이름     | 타입     | 필수 여부 | 설명       |
| ----------- | ------ | ----- | -------- |
| placementID | String | 필수    | 광고 지면 ID |
| advertiseID | String | 필수    | 광고 ID    |
| userKey     | String | 필수    | 사용자 키    |
| deviceADID  | String | 필수 아님 | 기기 광고 ID |

### 구현

[안드로이드 구현 코드](https://avatye.gitbook.io/spc/android-native#code-android-impression-directad)

[iOS 구현 코드](https://avatye.gitbook.io/spc/ios-native#ios-code-impression-directad)

***

## 직광고 클릭 API

사용자가 광고를 클릭했을 때, landingUrl 로 이동시키는 동시에 클릭을 호출해야 합니다.

클릭이 정상적으로 호출되면, 리워드가 가능한 직광고는 리워드가 적립됩니다.&#x20;

클릭 API를 호출하셔야 사용자에게 리워드가 지급되므로, 반드시 호출해주세요.

### 요청 값

임프레션과 마찬가지로 deviceADID는 사용자의 중복 참여를 막기위한 기준 값이 됩니다.

| 파라미터 이름     | 타입     | 필수 여부 | 설명       |
| ----------- | ------ | ----- | -------- |
| deviceADID  | String | 필수 아님 | 기기 광고 ID |
| deviceID    | String | 필수 아님 | 기기 ID    |
| placementID | String | 필수    | 광고 지면 ID |
| advertiseID | String | 필수    | 광고 ID    |
| userKey     | String | 필수    | 사용자 키    |

### 구현

[안드로이드 구현 코드](https://avatye.gitbook.io/spc/android-native#code-android-click-directad)

[iOS 구현 코드](https://avatye.gitbook.io/spc/ios-native#ios-code-click-directad)[\
](https://avatye.gitbook.io/spc/direct-ads-api)
