# Meta 잠재 고객 네트워크 통합

> Meta 계정을 생성하고 프로퍼티를 설정하고 프로젝트에 Meta Audience Network 어댑터를 추가하여 Meta Audience Network (formerly Facebook Audience Network)를 Unity 레벨플레이와 통합할 수 있습니다.

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

> **Note:**
>
> 이 Mediation 네트워크의 어댑터 변경 기록을 보려면 [Android용 Mediation 네트워크](/grow/levelplay/sdk/android/mediation-networks.md.md#integrate-network-adapters)를 참조하십시오.

## 필수 조건##prerequisites

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

**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/ 배너 통합)

## 1단계. Meta 계정 생성

* **첫 번째 설정**

  * [Meta for Developers](https://developers.facebook.com/)로 이동하여 Meta 계정으로 등록합니다.
  * 절차를 따르고 애플리케이션 이름을 설정합니다.
  * **등록**을 선택합니다.

  ![Meta for Developers 홈페이지](/api/media?file=/grow/media/images/Screen-Shot-2021-12-02-at-12.52.06.png)

* **등록된 사용자**

  * Meta 계정에 로그인합니다.
  * 오른쪽 사이드바에서 **내 앱**을 선택합니다.

  ![내 앱 메뉴](/api/media?file=/grow/media/images/my-apps-1024x478.png)

* 앱 선택

  ![앱 선택](/api/media?file=/grow/media/images/choose-app-1024x237.png)

## 2단계. 비즈니스 만들기

비즈니스는 메타 광고와 잠재 고객 네트워크 수익화 비롯하여 Meta에서 비즈니스를 관리할 수 있는 주요 엔티티. 비즈니스를 만들려면 [수익화 관리자](https://business.facebook.com/pub/home?helpref=help)로 이동하십시오.

## 3단계. 프로퍼티 만들기

수익화 Manager의 프로퍼티 브랜드가 동일한 제품 그룹입니다. 다양한 운영체제, 플랫폼 또는 기기를 위한 여러 제품이 있는 경우 수익화 Manager에서 프로퍼티 제품을 그룹화하여 리포트 및 관리를 통합할 수 있습니다.

1. [수익화 관리자로 이동](https://business.facebook.com/pub/home?helpref=help)

2. 비즈니스를 선택하거나 새 비즈니스를 만듭니다.

3. **프로퍼티 만들기**를 선택합니다.

   ![프로퍼티 만들기 버튼](/api/media?file=/grow/media/images/create-properties--1024x192.png)

4. 추가할 앱 또는 웹사이트 그룹의 브랜드에 따라 프로퍼티 이름을 지정합니다.

5. **프로퍼티 만들기**를 선택합니다.

   ![프로퍼티 생성 다이얼로그](/api/media?file=/grow/media/images/create-property-2-1024x667.png)

## 4단계. 플랫폼을 선택하고 표시 형식을 지정합니다.

플랫폼은 Audience Network로 수익화할 수 있는 다양한 타입의 제품과 표면입니다.

프로퍼티 생성한 다음 단계는 수익화를 원하는 플랫폼을 추가하는 것입니다.

![플랫폼 선택](/api/media?file=/grow/media/images/platforms.png)

## 5단계 광고 공간 생성

광고 공간은 사용자가 앱에서 광고를 볼 때 하는 행동을 정확하게 반영하는 방식으로 광고 플레이스먼트를 구성하는 데 도움이 됩니다. 광고 플레이스먼트를 생성하려면 먼저 광고 공간을 생성해야 합니다. 플랫폼당 최대 4개의 광고 공간을 생성할 수 있습니다.

1. [수익화 관리자](https://business.facebook.com/pub/home)로 이동합니다.

2. 프로퍼티 이름 또는 프로퍼티 ID를 사용하여 검색 바에서 프로퍼티를 검색한 다음 광고 공간을 생성할 프로퍼티 옆의 **Manage Properties**를 선택합니다.

3. 광고 공간을 생성할 플랫폼을 선택합니다. 사용하려는 플랫폼이 존재하지 않는 경우 오른쪽 상단에 있는 **플랫폼 추가**를 선택하여 생성합니다.

   ![광고 공간 만들기 버튼](/api/media?file=/grow/media/images/create-ad-spece-.png)

4. 동영상과 광고가 트리거될 시점을 설명합니다. **광고 공간 만들기**를 선택합니다.

   ![광고 공간 양식 만들기](/api/media?file=/grow/media/images/create-ad-space-2-945x1024.png)

5. 이제 광고 공간을 생성했으므로 수정 아이콘과 **플레이스먼트 생성**을 클릭하여 **광고 플레이스먼트를 생성**할 수 있습니다.

   ![플레이스먼트 옵션 만들기](/api/media?file=/grow/media/images/create-placement-.png)

## 6단계. 광고 플레이스먼트 생성

Audience Network는 다양한 유형의 광고 유닛을 제공합니다. 앱 또는 모바일 웹사이트의 각 광고 유닛은 고유한 플레이스먼트 ID를 사용하여 식별됩니다.

1. [수익화 관리자](https://business.facebook.com/pub/home/?source=help)로 이동합니다.

2. 광고 플레이스먼트를 생성할 프로퍼티 찾아 선택합니다. 오른쪽에서 **Manage Properties**를 선택합니다.

3. **플레이스먼트** 섹션으로 스크롤하여 **플레이스먼트 만들기**를 선택합니다. 위의 5.5단계에서 언급한 대로 수정 아이콘과 **플레이스먼트 생성**을 클릭하여 광고 배치를 **생성**할 수도 있습니다.

   ![플레이스먼트 섹션에서 플레이스먼트 버튼 만들기](/api/media?file=/grow/media/images/7-1024x224.png)

4. 플레이스먼트 이름을 입력하고, **광고 공간**을 선택하고 광고 **표시 포맷**을 선택한 후 설명을 추가합니다.

   ![플레이스먼트 양식 만들기](/api/media?file=/grow/media/images/8.png)

5. 광고 플레이스먼트를 최적화할 방법을 선택합니다. 최적화는 앱이나 사이트에서 노출별로 경매를 실행하는 방식을 결정합니다.

   ![최적화 옵션](/api/media?file=/grow/media/images/9.png)

6. 완료하려면 **Create placement**를 선택합니다.

> **Note:**
>
> 광고 플레이스먼트는 하나의 광고 공간에서만 사용할 수 있으며 광고 공간과 동일한 플랫폼과 일치해야 합니다.

### 앱에 플레이스먼트 추가

1. [수익화 관리자](https://business.facebook.com/pub/home)로 이동합니다.

2. 선택 **관리 프로퍼티**

3. **광고 공간**을 선택한 다음 **플레이스먼트**로 스크롤하거나 필터링하여 필요한 플레이스먼트를 찾습니다.

4. **플레이스먼트 ID** 열에서 **코드 가져오기** 를 선택합니다.

   ![플레이스먼트 ID 열에서 코드 가져오기 버튼](/api/media?file=/grow/media/images/9-1-1024x328.png)

5. 밑줄(\_)까지 플레이스먼트 ID를 복사합니다. 나중에 레벨플레이 App ID 파라미터 필요합니다.

   ![플레이스먼트 ID의 앱 ID](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-18.49.13.png)

6. 전체 플레이스먼트 ID를 복사합니다. 나중에 레벨플레이 플레이스먼트 ID 파라미터 필요합니다.

   ![전체 플레이스먼트 ID](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.02.56.png)

> **Note:**
>
> 자동 정산 정보가 추가되고 검토를 위해 전송되면 앱에서 Audience Network 광고를 받을 수 없습니다.

## 7단계 **레벨플레이 플랫폼에서 메타 잠재 고객 네트워크 활성화**

다음 단계를 완료하여 레벨플레이 메타 잠재 고객 네트워크를 미디에이션 네트워크로 활성화. 앱 레벨에서 앱 ID 파라미터 추가하고 인스턴스 레벨에서 플레이스먼트 ID를 추가해야 합니다.

* 레벨플레이 계정에 로그인하고 '**수익화**' > '**설정**' > '**SDK 네트워크**'로 이동합니다.

* **네트워크 관리** 선택

  ![네트워크 관리 버튼](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.06.35.png)

* 사용 가능한 광고 네트워크 목록에서 Meta Audience Network를 선택합니다.

* 선택 **Facebook으로 로그인하기**

  ![Facebook 버튼으로 로그인하기](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-20.49.21.png)

* 승인된 Meta 개발자 계정으로 로그인

> **Note:**
>
> 애플리케이션 보고 API 액세스, 접근 로그인한 사용자 메타 비즈니스 설정의 모든 애플리케이션에 연결되어 있는지 확인해야 합니다(이 문서의 마지막에 설명되어 있음).

* 읽기 활성화하다, 사용 가능하다 고객 네트워크 인사이트 활성화

> **Note:**
>
> 권한을 승인하면 레벨플레이 계정에 Meta Audience Network Reporting API 호출 권한이 부여됩니다.

* Meta Audience Network에서 인터스티셜 광고, 보상형 광고 또는 배너 광고를 게재할 앱을 선택합니다.

  ![메타 잠재 고객 네트워크를 위한 앱 선택](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-19.26.13.png)

* 광고 네트워크 설정 목록에서 Meta Audience Network를 선택하고, **Define** 아이콘을 선택하고 관련 필드에 **앱** **ID** 및 **플레이스먼트 ID**를 삽입합니다. [6단계](/grow/levelplay/sdk/adobe/networks/guides/meta-audience-network.md.md)를 참고하십시오.

  ![앱 ID 및 플레이스먼트 ID 설정](/api/media?file=/grow/media/images/Screenshot-2025-06-25-at-16.10.59.png)

**저장**을 선택하면 Meta Audience Network가 Mediation 대시보드에서 선택한 광고 유닛의 **액티브**로 표시됩니다.

![Meta Audience Network 활성 상태](/api/media?file=/grow/media/images/Screen-Shot-2022-08-08-at-19.26.37.png)

> **Note:**
>
> 애플리케이션 보고 API 액세스, 접근 프로퍼티 로그인한 사용자 연결되어 있는지 확인합니다(필수 프로퍼티 1개만 해당). 앱/프로퍼티 연결은 개발자를 위한 Meta 플랫폼에서 수행됩니다. 이 단계는 Mediation 플랫폼에 새 애플리케이션 추가할 때마다 필요합니다.

### 로그인한 사용자 프로퍼티 연결

1. **비즈니스 설정**으로 이동
2. 측면 메뉴에서 **사용자**를 선택한 다음 **사람**을 선택합니다.
3. 관련 등록 정보에 연결할 사용자 검색
4. **3개 점**을 선택한 다음 **에셋 추가**
5. 팝업 창에서 **프로퍼티**를 선택합니다.
6. 연결하려는 모든 에셋을 선택합니다.
7. **Full Control**에서 **Manage Properties** 토글한 다음 **Save Changes** 를 선택합니다.

   ![비즈니스 설정에서 프로퍼티 토글 관리](/api/media?file=/grow/media/images/meta.png)

Meta 개발자 계정이 활성 상태로 유지되고 최소 1개의 애플리케이션 노출을 생성하는 한 플랫폼에서 추가 행동 필요하지 않습니다.

세션 타임아웃 또는 기타 이유로 다시 로그인하라는 요청이 발생한 경우 다음 단계를 따르십시오.

* SDK Networks 페이지에서 사용 가능한 광고 네트워크 목록에서 **Meta Audience Network**를 선택합니다.

* 선택 **재설정 로그인**

  ![로그인 버튼 재설정](/api/media?file=/grow/media/images/Screen-Shot-2022-08-10-at-10.59.37.png)

* 위에서 설명한 로그인 과정을 반복합니다.

* 승인된 Meta 개발자 계정으로 로그인해야 합니다.

## 8단계 빌드 Meta Audience Network 어댑터 추가##step-8.-add-the-meta-audience-network-adapter-to-your-build

레벨플레이 Gradle 종속성과 매뉴얼 다운로드 메커니즘을 모두 지원합니다.

### Gradle##gradle

1. 앱 모듈의 Gradle다음 Maven URL이 있는지 확인합니다.

```groovy
repositories {
    mavenCentral()
}
```

2. 어댑터 Maven 이름을 앱 모듈의 Gradle추가합니다.

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:facebook-adapter:5.1.0'
    implementation 'com.facebook.android:audience-network-sdk:6.21.0'
}
```

#### 매뉴얼 다운로드##manual-download

1. **Meta Audience Network 어댑터 및 .AAR 파일 다운로드:** 빌드 Meta Audience Network 어댑터 추가합니다. 최신 메타 잠재 고객 네트워크 어댑터 및 SDK는 [여기](/grow/levelplay/sdk/android/mediation-networks.md)에서 찾을 수 있습니다.

2. **메타 잠재 고객 네트워크 어댑터를 프로젝트에 추가합니다.** 어댑터를 다운로드한 후에는 Android 프로젝트의 **libs** 폴더에 **Meta Audience Network 어댑터** 요리를 놓습니다.

   ![Android 프로젝트의 libs 폴더에 어댑터 JAR 파일을 놓습니다.](/api/media?file=/grow/media/images/Supersonic-Mediation-Drop-Libs.png)

3. **프로젝트에 Meta Audience Network .AAR 파일을 추가합니다.**

   1. Eclipse를 사용하는 경우: .AAR 파일을 라이브러리 프로젝트로 임포트.
   2. Android Studio를 사용하는 경우 Meta .AAR 파일을 다운로드 자체 모듈에 종속성으로 추가합니다. **File** > **New** > **New Module** > **Import .AAR**로 이동하여 FAN.AAR 파일을 다운로드한 위치로 이동합니다.

   AAR 파일 임포트 방법을 보여주는 ![Android Studio: File > New > New Module > 임포트 .AAR.](/api/media?file=/grow/media/images/Android-Studio-AAR-Integration.png)

4. 다음을 Gradle 빌드 파일의 **종속성** 섹션 아래에 추가해야 합니다.

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:facebook-adapter:4.3.50'
    implementation 'com.facebook.android:audience-network-sdk:6.20.0'
}
```

#### ProGuard 사용자 전용##for-proguard-users-only

ProGuard를 Meta 어댑터 함께 사용하는 경우 ProGuard 파일에 다음 코드를 추가해야 합니다.

```text
-dontwarn com.facebook.ads.internal.**
-keeppackagenames com.facebook.*
-keep public class com.facebook.ads.** {*;}
-keep public class com.facebook.ads.**
{ 공용 protected *; }
```

## 9단계 AndroidManifest.xml 업데이트##step-9.-update-androidmanifest.xml

Meta Android 어댑터 버전 4.3.16 이상(Android SDK 버전 6.17.0)부터 Meta 어댑터 AAR로 릴리스됩니다. Jar 연동을 유지하려는 경우 매니페스트 추가합니다.

### 매니페스트 사용 권한##manifest-permissions

```xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

**매니페스트 활동:** `<application>` 태그 안에 다음 활동을 추가합니다.

```xml
<activity
    android:name="com.facebook.ads.AudienceNetworkActivity"
    android:hardwareAccelerated="true"
    android:configChanges="keyboardHidden|orientation|screenSize" />
```

## 10단계. 네트워크 보안 설정##step-10.-network-security-settings

Meta의 SDK에는 localhost에 대한 명확한 텍스트 트래픽 권한 필요합니다. **Android P 기기에서는 기본적으로 이 권한이 차단됩니다.** 를 추가하여 이 트래픽 허용할 수 있습니다.

```xml
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    ...
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
    ...
</network-security-config>
```

to network\_security\_config.xml. 그런 다음 애플리케이션 매니페스트 다음과 같이 애플리케이션 속성 설정 추가합니다.

```xml
<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application android:networkSecurityConfig="@xml/network_security_config"
                    ... >
        ...
    </application>
</manifest>

```

더 읽어보기 [여기](https://developers.facebook.com/docs/audience-network/android-network-security-config).

## 11단계 Meta 추가 설정##step-11.-meta-additional-settings

### CacheFlag 설정##cacheflag-configuration

레벨플레이 사용하면 메타 어댑터 버전 4.3.15 이상부터 인터스티셜 광고 Meta CacheFlag 값을 보고할 수 있습니다.

"Meta\_IS\_CacheFlag" 설정을 사용하여 단일 값을 설정하려면 Init 앞에 캐시 플래그를 정의합니다.

```java
LevelPlay.setMetaData("Meta_IS_CacheFlag","IMAGE");
```

지원되는 값은 다음과 같습니다. **아이콘,** **이미지,** **없음,** **비디오** 또는 모든 값을 적용하는 **모든 것**. Meta CacheFlag 값에 대한 자세한 내용은 [여기](https://developers.facebook.com/docs/audience-network/reference/android/com/facebook/ads/cacheflag.html/?version=v6.8.0)에서 확인할 수 있습니다.

### CCPA 지원##ccpa-support

Meta 어댑터 4.3.18 이상을 사용하는 경우 [여기](https://developers.facebook.com/docs/marketing-apis/data-processing-options#audience-network-sdk) 설명된 대로 Meta Audience Network 지침을 따르십시오. 레벨플레이 Mediation을 초기화하기 전에 FAN **Limited Data Use** 플래그를 설정해야 합니다.

### COPPA 및 혼합 잠재 고객 지원##coppa-and-mixed-audience-support

레벨플레이 Meta 어댑터 버전 4.3.35 이상부터 Meta Mixed Audience 플래그 플래그 지원합니다.

혼합 잠재 고객을 타게팅할 때 이 플래그 "true"로 설정해야 합니다.

자세한 지침, 사용 제한 및 추가 정보는 메타의 공식 문서를 참조하십시오 [여기](https://developers.facebook.com/docs/audience-network/optimization/best-practices/coppa).

```java
LevelPlay.setMetaData("META_Mixed_Audience","true");
```

## 광고 네트워크 연동 확인##verify-your-ad-network-integration

레벨플레이 SDK는 Mediation 통합이 성공적으로 완료되었는지 확인하는 간편한 방법을 제공합니다. 레벨플레이와 추가 광고 네트워크 통합을 확인하려면 이 [문서](/grow/levelplay/sdk/android/integration-helper.md)를 따르십시오.

Meta Audience Network의 서버 간 콜백을 사용하고 AdRewarded 이벤트를 확인하기 위해 [DynamicUserID](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md) 파라미터를 사용하는 경우 이 파라미터가 서버 측 콜백에 반영됩니다. 또한 이 파라미터 레벨플레이 서버 간 콜백에서도 볼 수 있습니다.

이제 Unity 레벨플레이 Mediation 플랫폼을 통해 Meta Audience Network Ads를 제공할 수 있습니다.

## 다음 단계

Unity 레벨플레이 통해 추가 광고 네트워크를 활용하려면 어댑터를 연동하고 Unity 연동 가이드를 따르십시오.

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/mediation-networks.md.md)
* [플러터](/grow/levelplay/sdk/flutter/mediation-networks.md.md)
* [네이티브 반응](/grow/levelplay/sdk/react/mediation-networks.md.md)