# Chartboost 통합

> Chartboost 계정을 생성하고 앱을 추가하고 광고 유닛을 구성하여 Unity 레벨플레이 플랫폼에서 Chartboost를 Mediation 네트워크로 설정할 수 있습니다.

> **Important:**
>
> 다음 기술 자료는 Unity가 개발하거나, 소유하거나, 운영하지 않는 제품 또는 서비스('타사 제품')에 관한 내용입니다.
> 이 정보는 오래되었거나 불완전할 수 있으며 편의를 위해 제공됩니다.
> 타사 제품을 사용하는 경우 해당 제품의 약관이 적용됩니다.
> Unity는 이러한 제품에 대해 어떠한 보증도 하지 않으며, 타사 제공자의 콘텐츠, 광고 또는 머티리얼과 관련된 문제를 포함하여 제품 사용으로 인한 손해나 손실에 대해서도 책임지지 않습니다.

이 가이드는 Unity 레벨플레이 Chartboost Live를 광고 네트워크로 설정하는 방법을 단계별로 설명합니다.

## 필수 조건

* 보상형 광고 광고, 인터스티셜 광고 또는 배너 광고를 애플리케이션 올바르게 연동했는지 확인합니다. 연동 지침은 다음 플랫폼별 가이드를 참고하십시오.

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* \[Android]\(/grow/levelplay/sdk/android/보상형 광고 통합)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/보상형 광고 통합)
* \[플러터]\(/grow/levelplay/sdk/flutter/보상형 광고 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/보상형 광고 통합)

**Interstitial integration:**

* \[Unity]\(/grow/levelplay/sdk/unity/intersticial 광고 통합)
* \[Android]\(/grow/levelplay/sdk/android/interstitial 광고 통합)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/interstitial 광고 통합)
* \[플러터]\(/grow/levelplay/sdk/플러터/인터스티셜 광고 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/interstitial 광고 통합)

**Banner integration:**

* \[Unity]\(/grow/levelplay/sdk/Unity/배너 통합)
* \[Android]\(/grow/levelplay/sdk/android/ 배너 통합)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* \[Adobe Air]\(/grow/levelplay/sdk/adobe/ 배너 통합)
* \[플러터]\(/grow/levelplay/sdk/flutter/ 배너 통합)
* \[네이티브 반응]\(/grow/levelplay/sdk/react/ 배너 통합)

- Chartboost iOS 11 이상을 사용하는 기기를 지원합니다.

## 1단계. Chartboost 계정 생성

1. Chartboost를 사용하여 계정을 만듭니다. 당신은 [여기서](https://www.chartboost.com/sign-up/) 할 수 있습니다.
2. 계정이 확인되면 [여기](https://dashboard.chartboost.com/login) 파트너 로그인으로 로그인할 수 있습니다.

## 2단계. Chartboost에서 애플리케이션 만들기

Chartboost 계정을 처음 설정 경우 아래를 계속 진행하십시오.

1. 처음으로 로그인하면 **금융 시작하기**를 선택합니다.

![금융 시작하기](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-01.png)

2. **앱 정의** Chartboost는 등록 프로세스에서 제공한 회사 이름에 따라 Appstore에서 자동으로 애플리케이션을 식별하려고 시도합니다. 이 프로세스가 성공하면 레벨플레이 Mediation 실행할 애플리케이션을 선택하면 됩니다. 이 프로세스가 즉시 작동하지 않으면 두 가지 옵션이 있습니다.
   1. 회사를 수동으로 검색합니다.

![회사 검색](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-02.png)

2. 앱 아직 Appstore에 퍼블리시되지 않은 경우 세부 정보를 수동으로 입력할 수 있습니다. Ironsource 계정과 마찬가지로 플랫폼별로 고유한 Chartboost 애플리케이션(iOS + Android)이 필요합니다.

![앱 세부 정보를 수동으로 입력합니다.](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-03.png)

3. 애플리케이션을 정의한 후 관련 앱을 선택하고 \*\*Add Selected (x of x)\*\*를 선택합니다.

![선택된 앱 추가](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-04.png)
3\. 이제 앱에 게재할 광고를 선택해야 합니다.

1. Unity 레벨플레이 플랫폼에서 Chartboost 보상형 광고를 게재하려는 경우 **보상형 광고**를 선택하고 **캠페인 생성**을 선택합니다.

![보상형 광고 선택](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-05.png)

2. 레벨플레이 Mediation 플랫폼에서Chartboost 인터스티셜 광고를 제공하려는 경우**정적 인터스티셜 광고**를 선택하고**캠페인 생성**을 선택합니다

![정적 인터스티셜 광고 선택](/api/media?file=/grow/media/images/Chartboost-IS-Mediation-Interstitial-Ads.png)

4. 아래 페이지로 이동하여 새로 만든 앱 요약을 찾을 수 있습니다. 여기에서 **앱 ID**와 **앱 서명**을 모두 찾을 수 있습니다. 이 파라미터는 **네트워크 설정** 모듈에서 Ironsource 관리자 계정에 입력해야 합니다.

![앱 ID 및 앱 서명](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

5. Unity 레벨플레이에서 Chartboost의 보상형 광고에 관심이 있다면 Chartboost의 프리롤/포스트롤 동영상 메시지를 **비활성화해야 합니다.** 앱으로 이동하여 **기본 설정** > **보상형 광고** > **고급 광고**를 선택하면 두 개의 체크박스가 표시됩니다. **체크 해제**되어 있는지 확인하고 **저장**을 선택합니다.

![사전/후기 메시징 해제](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)

## 등록된 사용자 프로세스

이전에 Chartboost 계정을 설정했으며 레벨플레이 Mediation 플랫폼에서 사용할 새 애플리케이션을 추가하는 경우 이 섹션 따르십시오.

1. 로그인한 후 **대시보드** > **퍼블리싱** > **앱 추가**를 선택합니다.
   ![앱 추가](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-08.png)
2. 애플리케이션 세부 정보를 정의합니다.
   1. **플랫폼** - iOS 또는 안드로이드.
   2. **앱 별명** - Chartboost 보고 UI에서 앱을 나타내는 데 사용됩니다.
   3. **방향, 방향 설정** - '랜드스케이프' 또는 '세로'를 선택합니다.
   4. **테스트 모드** - '비활성화'를 선택합니다. 완료되면 'Save'를 선택합니다. Ironsource 계정과 마찬가지로 플랫폼별로 고유한 Chartboost 애플리케이션(iOS + Android)이 필요합니다.

![앱 세부 정보 정의](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-09.png)

3. 아래 페이지로 이동하여 새로 만든 앱 요약을 찾을 수 있습니다. 여기에서 **앱 ID**와 **앱 서명**을 모두 확인할 수 있습니다. 이 파라미터는 **네트워크 설정** 모듈에서 Ironsource 관리자 계정에 입력해야 합니다.

![앱 ID 및 앱 서명](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-10.png)

4. Unity 레벨플레이에서 Chartboost의 보상형 광고에 관심이 있다면 Chartboost의 프리롤/포스트롤 동영상 메시지를 **비활성화해야 합니다.** 앱으로 이동하여 **기본 설정** > **보상형 광고** > **고급 광고**를 선택하면 두 개의 체크박스가 표시됩니다. **체크 해제**되어 있는지 확인하고 **저장**을 선택합니다.

![사전/후기 메시징 해제](/api/media?file=/grow/media/images/Chartboost-integration-with-Supersonic-Mediation-11.png)
5\. Unity 레벨플레이에서 Chartboost의 보상형 광고에 관심이 있다면 Chartboost의 프리롤/포스트롤 동영상 메시지를 **비활성화해야 합니다.** 앱으로 이동하여 **기본 설정** > **보상형 광고** > **고급 광고**를 선택하면 두 개의 체크박스가 표시됩니다. **체크 해제**되어 있는지 확인하고 **저장**을 선택합니다.
6\. 배너 사용하려는 경우 Chartboost 대시보드에서 배너 퍼블리싱 캠페인을 정의할 필요가 없습니다. 배너 광고는 Chartboost Exchange를 통해 제공되며, SDK를 통해만 호출 합니다.

## 3단계. Chartboost 퍼블리싱 캠페인 생성

Unity 레벨플레이 통해 앱에서 Chartboost의 광고 인벤토리를 제공하려면 Chartboost에 퍼블리싱 캠페인을 생성해야 합니다.

1. Chartboost 대시보드의 왼쪽 하단 모서리에 있는 **Add a Campaign**을 클릭한 다음 **네트워크 퍼블리싱**을 클릭합니다.

![네트워크 퍼블리싱](/api/media?file=/grow/media/images/Supersonic-IS-Mediation-Chartboost-Network-Publishing.png)

2. **광고 유형** 드롭다운에서 **간단한 설정** 섹션에서 표시할 광고 유형(**보상형 광고** 또는 **정적 인터스티셜 광고**)을 지정합니다. Unity 레벨플레이 통해 보상형 광고 광고와 인터스티셜 광고 모두 게재하려면 두 개의 서로 다른 캠페인을 생성해야 합니다.
3. **저장**을 클릭합니다. 캠페인을 게재하는 데 최대 20분이 걸릴 수 있습니다.

애플리케이션의 타게팅 옵션을 정의하려면 [Chartboost](https://docs.chartboost.com/en/)의 지침을 따르십시오.

## 4단계. 레벨플레이 SDK 네트워크 모듈에서 Chartboost 활성화

Chartboost 계정의 5가지 데이터는 Chartboost가 아이언소스 관련하여 올바르게 작동하려면 아이언소스 네트워크 설정 모듈에 삽입해야 합니다.

| **App ID**        | Chartboost 시스템에서 애플리케이션 고유 식별자.                                                       |
| ----------------- | ------------------------------------------------------------------------------------- |
| **App Signature** | 특정 Chartboost 애플리케이션 대한 광고 요청을 확인하는 데 사용되는 고유 서명입니다.                                  |
| **인식된 위치**        | Chartboost 시스템에서 애플리케이션 내에서 특정 감지 위치의 고유 식별자.                                         |
| **사용자 ID**        | Chartboost 계정의 고유 식별자, Unity 레벨플레이 Chartboost 계정에서 성과 데이터를 임포트 리포트 및 최적화에 사용할 수 있습니다. |
| ****사용자 서명****    | Chartboost 계정의 고유 식별자, Ironsource 대신하여 전송한 리포트 요청을 확인할 수 있습니다.                        |

이 정보를 얻으면 레벨플레이 계정에서 Chartboost의 파라미터를 설정 합니다. 위 정보를 올바르게 추가하면 Chartboost의 광고 인벤토리와 Ironsource Mediation 플랫폼의 리포트 데이터를 최대한 활용할 수 있습니다.

### Chartboost 플랫폼에서 Chartboost 파라미터 복원

1. **앱 ID 및 앱 서명** **대시보드** > **앱 설정** > **기본 설정**으로 이동하여 나열된 **앱 ID** 및 **앱 서명**을 입력합니다.

![앱 ID 및 앱 서명](/api/media?file=/grow/media/images/CB-app-Id-sign-1.png)

2. **사용자 ID 및 사용자 서명** 드롭다운에서 **도구**로 이동하여 **API 탐색기**를 선택합니다.

![사용자 ID 및 사용자 서명](/api/media?file=/grow/media/images/CB-user.png)

### 레벨플레이 계정에 Chartboost 파라미터 설정

이 모든 파라미터가 있으면 레벨플레이 계정에 로그인합니다.

* **Monetize** > **Setup** > **SDK networks**로 이동하여 **manage networks**를 선택합니다.

![SDK Networks](/api/media?file=/grow/media/images/CB-1.png)

* 사용 가능한 광고 네트워크 목록에서 Chartboost를 선택하고 Chartboost **유저 ID** 및 **유저 서명**을 관련 필드에 입력합니다.

![사용자 자격 증명](/api/media?file=/grow/media/images/CB2.png)

* Chartboost로 레벨플레이의 Mediation을 실행할 앱을 선택하고 Chartboost 네트워크 옆의 **설정**을 선택합니다.

![설정 버튼](/api/media?file=/grow/media/images/CB3.png)

* 관련 필드에 Chartboost **앱 ID**, **앱 서명** 및 **위치 사용자 ID**를 입력합니다.

![앱 자격 증명](/api/media?file=/grow/media/images/CB4.png)

* 리포트 API 연동을 확인합니다. 이 열은 리포트 API 통해 연동을 확인하고 다음과 같은 세 가지 가능한 응답을 반환합니다. 확인함, 실패함, 응답 없음 통합과 위에 입력한 정보를 다시 확인한 다음 **검증됨**이 표시될 때까지 **재시도** 선택합니다.

## 5단계 빌드 Chartboost 어댑터 추가하기##step-5.add-the-chartboostadapter-to-your-build

[Android](/grow/levelplay/sdk/android/networks/guides/chartboost.md) 및 [iOS](/grow/levelplay/sdk/ios/networks/guides/chartboost.md)용 네이티브 어댑터를 사용하여 통합을 계속 진행합니다.

## 연동 헬퍼 사용##use-the-integration-helper

테스트 기기에서 앱 개발 빌드를 빌드하고 실행한 다음 [레벨플레이 통합 도우미](/grow/levelplay/sdk/android/integration-helper.md) 화면을 엽니다. Unity 레벨플레이 SDK, Chartboost SDK, Chartboost 어댑터 모두 오류 없이 통합되어 표시되었는지 확인하는 데 사용합니다.

개발 빌드에서 Unity 레벨플레이 SDK를 초기화하기 전에 다음 메서드를 호출하여 어댑터 디버그 로그를 활성화하다, 사용 가능하다.

```dart
LevelPlay.setAdaptersDebug(true);
```

> **Note:**
>
> 어댑터 디버그 로그는 SDK 버전 6.5.2 이상에서 지원됩니다. 앱을 릴리스하기 전에 이 호출 제거합니다.

## Chartboost COPPA 동작 설정##configure-chartboost-coppa-behavior

Chartboost는 앱이 자식 지정인지 여부를 지정해야 합니다.

앱 초기화 코드에서 Unity 레벨플레이 SDK를 초기화하기 전에 `CHARTBOOST_COPPA` 메타데이터 키를 설정하여 앱이 Chartboost에 자식으로 지정되는지 설정합니다.

**자식:**

```dart
LevelPlay.setMetaData({"CHARTBOOST_COPPA": ["YES"]});
```

**자식이 아닌:**

```dart
LevelPlay.setMetaData({"CHARTBOOST_COPPA": ["NO"]});
```

Chartboost 대시보드에 앱을 추가할 때 COPPA 설정을 지정해야 합니다. 인앱 메타데이터와 Chartboost 대시보드 설정이 앱의 실제 잠재 고객과 일치하는지 확인합니다.

자세한 내용은 [Chartboost의 COPPA 문서](https://docs.chartboost.com/en/)를 참조하십시오.

## 다음 단계##next-steps

Unity 레벨플레이를 통해 추가 광고 네트워크를 활용하려면 [어댑터를](/grow/levelplay/sdk/flutter/mediation-networks.md) 통합하고 통합 가이드를 따르십시오.