# ByteBrew와 Unity 연동

> UA 캠페인을 ByteBrew와 연동하여 앱의 참여 데이터와 설치 후 이벤트 데이터를 전달합니다.

ByteBrew와 연동하면 설치를 트래킹하고 광고 캠페인의 설치 후 이벤트 포스트백을 받을 수 있습니다. ByteBrew 연동에 대한 최신 정보는 [ByteBrew 개발자 허브](https://docs.bytebrew.io/attribution-setup/attribution-unityads)를 참조하십시오.

Unity와 ByteBrew의 연동을 활성화하려면 다음 작업을 완료합니다.

1. Unity Ads UA 대시보드에서 [서비스 계정](#create-a-service-account)을 만듭니다.
2. 대시보드 서비스 계정 설정에서 [API 키](#create-api-keys)를 생성합니다.
3. ByteBrew 대시보드에서 [연동 워크플로](#complete-the-bytebrew-integration-workflow)를 완료합니다.

## 필수 조건##prerequisites

* [Unity Ads UA 대시보드](https://cloud.unity.com/acquire)에 하나 이상의 앱을 [추가](/grow/acquire/get-started/set-up-user-acquisition.md)합니다.
* 앱에서 ByteBrew SDK를 초기화합니다. 초기화에 대한 자세한 지침은 ByteBrew의 [Unity SDK](https://docs.bytebrew.io/sdk/unity) 연동 가이드를 참고하십시오.

## 서비스 계정 생성##create-a-service-account

서비스 계정을 통해 [Unity Advertising Statistics API](https://services.docs.unity.com/statistics/v2/index.html)를 ByteBrew 연동과 함께 사용할 수 있습니다. 서비스 계정을 생성하려면 Unity Ads UA 대시보드에서 다음을 수행하십시오.

1. 왼쪽 내비게이션 메뉴에서 **API Management** 를 선택합니다.
2. Stats API v2.0 섹션에서 **Service account**를 선택합니다.
3. **Service Accounts** 페이지 오른쪽 상단 모서리에서 **+ New**를 선택하면 **Create service account** 다이얼로그가 열리며, 새 서비스 계정을 만들 수 있습니다.
4. **Service account name**과 **Service account description**을 입력합니다. 다음 이름 및 설명 예제를 참고하십시오.

* **Service account name**: ByteBrew 어트리뷰션
* **Service account description**: ByteBrew 어트리뷰션 캠페인 메타데이터 풀

5. **Create**를 선택하면 설정이 저장되고 **Service Accounts** 페이지 목록에 새 서비스 계정이 추가됩니다.

## API 키 만들기##create-api-keys

ByteBrew 연동에서 Unity 통계 API의 프로그래매틱 방식 데이터 공유를 활성화하려면 서비스 계정 설정에서 두 개의 API 키(**Key ID** 및 **Secret Key**)를 생성해야 합니다.

이러한 키를 생성하려면 Unity Dashboard의 **Organization** > **Service accounts** 설정에서 다음을 수행합니다.

1. 이전에 생성한 서비스 계정을 찾아 선택합니다. 검색창을 사용하여 계정을 찾을 수 있습니다.
2. **Keys** 섹션에서 키를 생성하려면 **+ Add key**를 선택하고 **New key has been created** 다이얼로그를 엽니다.
3. ByteBrew 대시보드에서 연동을 완료하려면 이 다이얼로그에서 **Key ID**와 **Secret key**가 모두 필요합니다. 두 키를 모두 복사합니다.
4. 다이얼로그를 닫으려면 **Done**을 선택합니다.

## ByteBrew 연동 워크플로 완료##complete-the-bytebrew-integration-workflow

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

Unity Dashboard에서 서비스 계정과 API 키를 생성한 후 ByteBrew 대시보드로 이동하여 연동 설정을 완료합니다.

1. 대시보드 내비게이션 메뉴에서 앱을 선택합니다.
2. **Attribution** > **Network Settings**로 이동하여 네트워크 목록에서 **UnityAds**를 찾습니다.
3. **UnityAds** 옆의 **Setup**을 선택하여 **Add Ad Network** 다이얼로그를 엽니다.
4. **Network Settings** 필드를 작성합니다. UA 대시보드에서 이러한 값을 찾는 위치에 대한 지침은 다음 탭을 참고하십시오.

1) **API Key**

   UA 대시보드에서 API 키를 검색하려면 다음과 같이 합니다.

   1. **API Management page**로 이동합니다.
   2. **Stats API v1.0** 섹션에서 **API Key**를 복사합니다.

2) **Game ID**

   **User Acquisition** 대시보드의 **Apps** 페이지에서 [게임 ID](../../get-started/retrieve-your-advertiser-game-id)를 검색하려면 다음 단계를 따릅니다.

   1. 대시보드 왼쪽 내비게이션 메뉴에서 **Apps**로 이동합니다. 제공된 표에는 조직의 각 앱이 나열되어 있습니다. 각 앱 이름 다음에 대시보드에는 앱 플랫폼과 게임 ID가 표시됩니다.
   2. ID 옆의 **Copy** 기호를 선택하여 클립보드에 복사합니다.

3) **Organization ID**

   UA 대시보드에서 조직 ID를 검색하려면 다음 단계를 따릅니다.

   1. **Settings** 페이지로 이동합니다.
   2. 설정의 **Organization** 섹션에서 **Organization ID**를 복사합니다.

4) **Organization Core ID**

   UA 대시보드의 **Settings** 페이지에서 Organization core ID를 검색하려면 다음 단계를 따릅니다.

   1. **Settings** 페이지의 **Organization** 섹션으로 이동합니다.
   2. **Organization core ID** 옆에 표시된 숫자 ID를 복사합니다.

5. 다이얼로그의 **Install Settings** 탭으로 이동하려면 **Next**을 선택합니다.
6. 뷰스루 어트리뷰션을 사용하려면 **Enable view through tracking** 체크박스를 선택하고 뷰스루 룩백 기간을 설정합니다. ByteBrew는 기본적으로 클릭스루 어트리뷰션 링크를 생성합니다.
7. 다음 **Install Settings** 필드에서 어트리뷰션 룩백 기간을 구성합니다.

| **Click-Through Window** | 예   | **Days** 선택자를 사용하여 사용자가 광고를 클릭한 후 설치가 어트리뷰션될 수 있는 일수를 설정합니다. | 클릭스루 룩백 최대 기간은 30일입니다. 정확한 어트리뷰션을 위해 클릭스루 설정을 7일 이상으로 구성하는 것이 좋습니다. |
| ------------------------ | --- | ------------------------------------------------------------ | ------------------------------------------------------------------- |
| **View-Through Window**  | 아니요 | **Days** 선택자를 사용하여 사용자가 광고를 시청한 후 설치가 어트리뷰션될 수 있는 일수를 설정합니다. | 뷰스루 룩백 최대 기간은 7일입니다. 정확한 어트리뷰션을 위해 뷰스루 설정을 1일 이상으로 구성하는 것이 좋습니다.    |

어트리뷰션 룩백 옵션에 대한 자세한 내용은 ByteBrew 데이터 공유 참조의 [애트리뷰션 룩백 설정](/grow/acquire/partner-integration/bytebrew/data-sharing.md#attribution-lookback-settings) 섹션을 참고하십시오.

8. **Send all install events from** 섹션에서 앱의 모든 설치에서 발생한 참여 데이터([미기여](/grow/acquire/partner-integration/attribution/introduction.md) 설치 데이터 포함)를 전달할지 또는 Unity에 기여한 설치의 참여 데이터만 전달할지 여부를 선택합니다. 다음 옵션 중에서 선택할 수 있습니다.

* **Only this partner**
* **All Partners and Organics**
* **This Partner and Organics**

설치 데이터 소스 옵션에 대한 자세한 내용은 ByteBrew 데이터 공유 레퍼런스의 [어트리뷰션 데이터 소스](/grow/acquire/partner-integration/bytebrew/data-sharing.md#attribution-data-sources) 섹션을 참고하십시오.

9. 다이얼로그의 **Postback Settings** 탭으로 이동하려면 **Next**를 선택합니다.
10. Unity에 전달하려는 설치 후 이벤트를 추가하려면 **+ Add Postback Event**를 선택하고 다음 옵션 중에서 선택합니다.

* Ad Watched Event
* User App Open Event
* In-App Purchase Event

포스트백 이벤트 옵션에 대한 자세한 내용은 ByteBrew 데이터 공유 레퍼런스의 [설치 후 이벤트 데이터 공유 섹션](/grow/acquire/partner-integration/bytebrew/data-sharing.md)을 참고하십시오.

> **Important:**
>
> 앱 코드에서는 새 사용자 이벤트를 정의하지 않습니다. ByteBrew는 기본적으로 **User App Open Event** 옵션을 사용하여 새로운 사용자 이벤트를 트래킹합니다. 자세한 내용은 [ByteBrew 개발자 허브](https://docs.bytebrew.io/attribution-setup/attribution-unityads)의 어트리뷰션 참고 자료를 참고하십시오.

11. **Postback Events Settings** 섹션에서는 모든 앱 설치(여기에는 [어트리뷰션되지 않은](/grow/acquire/partner-integration/attribution/introduction.md) 설치 데이터 포함)에서 설치 후 이벤트 데이터를 전달할지, Unity에 어트리뷰션된 설치 데이터만 전달할지 선택할 수 있습니다. 다음 옵션 중에서 선택할 수 있습니다.

* Send only from this partner
* Send from all Networks and Organics
* Send only from this Partner and Organics

설치 후 이벤트 데이터 소스 옵션에 대한 자세한 내용은 ByteBrew 데이터 공유 레퍼런스의 [포스트백 데이터 소스](/grow/acquire/partner-integration/bytebrew/data-sharing.md#postback-data-sources) 섹션을 참고하십시오.

12. 네트워크 설정 다이얼로그의 마지막 탭에서 어트리뷰션 링크를 복사할 수 있습니다. Unity Ads UA 대시보드에 이러한 URL을 연동하는 방법에 대한 지침은 [Unity와 어트리뷰션 링크 연동](/grow/acquire/partner-integration/attribution/integrate-links.md)을 참고하십시오.
13. 연동을 완료하려면 **Finish**를 선택합니다.