# 플레이스먼트 설정

> 탭조이 오퍼월 수익화 대시보드에서 플레이스먼트를 생성하고 설정하는 방법을 알아봅니다. 오퍼월과 앱 내 메시지가 표시되는 위치를 제어하여 사용자 참여를 높입니다.

플레이스먼트란 앱 내에서 [콘텐츠 카드](./content-cards.md)를 표시하거나 메시징 기능을 사용하여 사용자를 오퍼월로 안내하고자 하는 특정 위치를 말합니다. 하나의 플레이스먼트에는 여러 개의 콘텐츠 카드가 포함될 수 있으며, 각 카드는 특정 사용자 세그먼트에 맞게 설정됩니다.

앱 코드가 탭조이 대시보드의 플레이스먼트 기능을 호출하면, 해당 기능은 사용자 세그먼트 기준에 부합하는 콘텐츠 카드를 선택하여 표시합니다.

플레이스먼트 사용에 관한 자세한 내용은 다음 섹션을 참고하십시오.

| **주제**                               | **Description**                |
| ------------------------------------ | ------------------------------ |
| [플레이스먼트 유형](#placement-types)        | 다양한 유형의 소재 에셋에 대해 알아봅니다.       |
| [플레이스먼트 생성](#create-placements)      | 탭조이 대시보드에서 광고 플레이스먼트를 설정합니다.   |
| [권장 플레이스먼트](#recommended-placements) | 앱에 적용할 권장 플레이스먼트 방법에 대해 알아봅니다. |

## 플레이스먼트 유형##placement-types

플레이스먼트 위치를 결정할 때는 문맥 기반 플레이스먼트와 사용자 주도 플레이스먼트를 모두 고려합니다.

### 사용자 주도 플레이스먼트##user-initiated-placements

사용자가 게임 내 특정 위치를 탭하면 오퍼월에 액세스할 수 있도록, 사용자가 직접 탭하여 활성화하는 플레이스먼트를 구현합니다. 사용자가 오퍼월에 액세스하기로 선택한 것이기 때문에, 이러한 형태의 플레이스먼트에는 별도의 인앱 알림이 필요하지 않습니다.

### 컨텍스트 기반 플레이스먼트##contextual-placements

게임 플레이 중 특정 조건이 발생하면 앱에서 상황 기반 플레이스먼트를 호출합니다.

이 플레이스먼트에 설득력 있는 메시지 또는 인앱 자체 메시지 기능을 활용하여, 사용자가 오퍼월에 액세스하기 전에 관련 정보를 제공할 수 있습니다. 예를 들어, 사용자의 가상 재화 잔액이 부족해지면 '코인이 부족하신가요?'와 같은 메시지를 표시할 수 있습니다. 오퍼월에 액세스하기 전에 '지금 더 많이 획득하세요!'라는 문구가 표시됩니다. 자세한 내용은 [메시징](./messaging.md)을 참고하십시오.

## 플레이스먼트 생성##create-placements

탭조이 대시보드에서 플레이스먼트를 생성하여 [콘텐츠 카드](./content-cards.md)와 [인앱 메시지](./messaging.md)가 앱 내 어디에 표시될지 정의합니다. 플레이스먼트 생성은 오퍼월을 효율적으로 관리하고 표시하는 방법입니다. 오퍼월 설정을 직접 호출하는 대신, 탭조이 대시보드에서 해당 설정이 포함된 플레이스먼트를 호출할 수 있습니다.

구현 가능한 플레이스먼트 유형에 대한 자세한 정보는 [플레이스먼트 유형](#placement-types)을 참고하십시오.

> **Important:**
>
> 향후 최적화를 대비해 앱 코드를 준비하려면, 권장되는 모든 플레이스먼트를 앱에 통합하는 것이 가장 좋은 베스트 프랙티스입니다. 구현해야 할 추천 플레이스먼트 전체 목록은 [권장 플레이스먼트](#recommended-placements)를 참고하십시오.

### 필수 조건##prerequisites

탭조이 대시보드에서 플레이스먼트를 생성하기 전에 먼저 앱 코드에 이를 구현해야 합니다.

앱 코드에서 플레이스먼트 기능을 구현하는 방법에 대한 안내는 다음 플랫폼별 플레이스먼트 가이드를 참고하십시오.

* [iOS](../../ios/placements/sdk)
* [Android](../../android/placements/sdk)
* [Unity](../../unity/placements/sdk)
* [ReactNative](../../react-native/placements/sdk)

### 플레이스먼트 생성##create-a-placement

앱 코드에 플레이스먼트를 구현한 후, 다음 단계를 따라 탭조이 대시보드의 해당 플레이스먼트와 연결합니다.

1. 왼쪽 내비게이션 메뉴에서 **Placements**를 선택합니다.

2. **+ Placement**를 선택하여 **Create placement** 다이얼로그를 엽니다.

3. **Placement name**을 입력합니다.

> **Tip:**
>
> 플레이스먼트 항목을 체계적으로 정리하고 관리하기 쉽도록, 용도를 명확히 알 수 있게 이름을 지정합니다. 예를 들어, 플레이스먼트 이름 `Level_Complete_Popup`은 사용자가 게임 레벨을 완료한 후 표시되는 메시지용 플레이스먼트를 의미합니다.

4. **Create**를 선택하여 새로운 플레이스먼트 설정을 저장합니다.

플레이스먼트를 생성한 후에는, 앱 내의 해당 위치에서 탭조이가 사용자에게 오퍼를 표시할 수 있도록 각 플레이스먼트에 대해 [콘텐츠 카드](./content-cards.md)를 생성해야 합니다. 콘텐츠 카드 생성 방법은 [콘텐츠 카드 생성](./content-cards.md#create-a-content-card)을 참고하십시오.

## 권장 플레이스먼트##recommended-placements

다음 표는 탭조이 SDK 및 대시보드에 구현해야 할 권장 플레이스먼트 위치를 설명합니다.

서로 다른 플랫폼에서 동일한 플레이스먼트 설정을 재사용할 수 있습니다.

> **Note:**
>
> 탭조이에는 기본 `AppLaunch` 플레이스먼트가 있습니다. 탭조이 SDK는 앱이 실행될 때 초기화가 완료되면 이 플레이스먼트 메서드를 호출합니다. SDK가 이 플레이스먼트를 호출하는 것을 막을 수는 없지만, 탭조이 대시보드에서 해당 플레이스먼트를 비워두면 비활성화할 수 있습니다.

> **Important:**
>
> `event_name`
>
>  파라미터에 기본 
>
> `#WebOfferwall`
>
>  값을 사용하여 
>
> [딥링크](../../web/displaying-offerwall/deep-linking-implementation)
>
> 를 사용하는 경우 탭조이 오퍼월 수익화 대시보드에서 
>
> `#WebOfferwall`
>
>  플레이스먼트를 생성해야 합니다. 자세한 내용은 딥 링크 페이지의 
>
> [이벤트 이름](../../web/displaying-offerwall/deep-linking-implementation#event-name)
>
>  섹션을 참고하십시오.

| 플레이스먼트                 | Type   | 설명                                                                                                                                                                           |
| ---------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MainMenu`             | 사용자 주도 | 앱의 메인 메뉴에서 사용자가 탭하여 오퍼월에 액세스할 수 있는 위치입니다.권장되는 모든 플레이스먼트 방식을 모두 적용할 수 없는 경우, 콘텐츠 카드와 '설득력 있는 메시지' 기능을 테스트할 수 있도록 최소한 MainMenu 및 MainMenu\_Messaging 플레이스먼트 방식은 적용하는 것이 좋습니다.  |
| `MainMenu_Messaging`   | 문맥적    | 메인 메뉴에서 인앱 메시지를 통해 사용자를 오퍼월로 안내하는 프롬프트입니다.권장되는 모든 플레이스먼트 방식을 모두 적용할 수 없는 경우, 콘텐츠 카드와 '설득력 있는 메시지' 기능을 테스트할 수 있도록 최소한 MainMenu 및 MainMenu\_Messaging 플레이스먼트 방식은 적용하는 것이 좋습니다. |
| `AppLaunch`            | 문맥적    | 앱 로딩 후 표시되는 프롬프트입니다.                                                                                                                                                         |
| `Store`                | 사용자 주도 | IAP(인앱 결제)와 함께 제공되는 재화 상점 내 위치입니다.                                                                                                                                           |
| `InsufficientCurrency` | 문맥적    | 구매에 필요한 재화가 부족한 사용자에게 표시되는 프롬프트입니다.                                                                                                                                          |
| `AbandonCurrency`      | 문맥적    | IAP를 완료하지 않은 사용자에게 표시되는 프롬프트입니다.                                                                                                                                             |
| `Inbox`                | 사용자 주도 | 재화 세일 오퍼월로 바로 연결되는 링크가 포함된 받은 편지함 메시지입니다.                                                                                                                                    |
| `LevelComplete`        | 문맥적    | 레벨이나 이벤트를 완료한 사용자에게 표시되는 프롬프트입니다.                                                                                                                                            |
| `AppMessage`           | 사용자 주도 | 앱 자체 인앱 메시징 시스템에서 보내는 인앱 메시지입니다. 사용자가 이 메시지를 탭하면 오퍼월에 액세스할 수 있습니다.                                                                                                           |