Meta Audience Network를 입찰과 통합

플랫폼 선택: Android (베타) Android iOS Unity Flutter

이 가이드에서는 GMA Next-Gen SDK을 사용하여 미디에이션을 통해 Meta Audience Network의 광고를 로드하고 표시하는 방법을 설명하고 입찰 통합을 다룹니다. 또한 광고 단위의 미디에이션 구성에 Meta Audience Network를 추가하는 방법과 Meta Audience Network SDK 및 어댑터를 Android 앱에 통합하는 방법을 설명합니다.

지원되는 통합 및 광고 형식

Meta Audience Network의 미디에이션 어댑터에는 다음과 같은 기능이 있습니다.

¹ Meta Audience Network 는 입찰 전용 으로 2021년에 변경되었습니다.
² Meta Audience Network 는 고정 및 인라인 반응형 배너를 지원하지 않습니다.

요구사항

• 최신 GMA Next-Gen SDK

• 미디에이션 시작 가이드 완료

• Android API 수준 24 이상

• Meta Audience Network 어댑터 5.10.0.0 이상 (최신 버전 권장)

1단계: Meta Audience Network UI에서 구성 설정하기

Business Manager Start page에서 가입하고 로그인합니다.

Get started(시작하기)를 클릭한 다음 Create new account(새 계정 만들기)를 클릭합니다.

필수 입력란에 비즈니스 세부정보를 입력하고 Next(다음)를 클릭합니다.

속성 만들기

필수 정보를 입력하면 앱의 속성을 만들라는 메시지가 표시됩니다. 앱에 대해 원하는 속성 이름을 입력하고 Next(다음)를 클릭합니다.

다음으로 수익 창출을 위해 사용할 플랫폼을 선택합니다.

앱 세부정보를 추가하고 Next(다음)를 클릭합니다.

Add a new payment account(새 결제 계정 추가)를 클릭하여 결제 계정을 설정합니다. 결제 정보를 입력할 수 있는 새 페이지로 리디렉션됩니다. 필요한 세부정보를 입력한 후 Next(다음)를 클릭합니다.

Mediation platform(미디에이션 플랫폼)으로 Google Ad Manager 를 선택한 다음 Create placement(게재위치 만들기)를 클릭합니다.

형식을 선택하고 양식을 작성한 후 Create(만들기)를 클릭합니다.

Placement ID(게재위치 ID)를 기록해 둡니다.

완료 를 클릭합니다.

app-ads.txt 업데이트

승인된 앱 판매자 app-ads.txt는 승인받은 것으로 확인된 채널을 통해서만 앱 광고 인벤토리가 판매될 수 있게 해주는 IAB Tech Lab 이니셔티브입니다. 광고 수익이 크게 감소하는 것을 방지하려면 app-ads.txt 파일을 구현해야 합니다. 아직 구현하지 않았다면 Ad Manager용 app-ads.txt 파일을 만듭니다.

Meta Audience Network에 app-ads.txt를 구현하려면 app-ads.txt를 사용하여 승인된 판매자 식별을 참고하세요.

테스트 모드 사용 설정하기

Meta Audience Network 테스트 광고를 사용 설정하는 방법에 관한 자세한 안내는 Audience Network 구현 테스트 가이드를 참고하세요.

2단계: Ad Manager UI에서 Meta Audience Network 수요 설정하기

Ad Manager 계정에 로그인합니다.

보안 신호 공유 사용 설정

관리 > 전체 설정 으로 이동합니다. Ad Exchange 계정 설정 탭으로 이동하여 보안 처리된 신호 공유 를 검토하고 전환 스위치를 켭니다. 저장 을 클릭합니다.

입찰 요청 시 보안 처리된 신호 공유하기

인벤토리 > 보안 처리된 신호 로 이동합니다. 보안 처리된 신호에서 Facebook을 검색하고 앱 통합 사용 설정에서 전환 스위치를 켭니다.

저장 을 클릭합니다.

SDK 입찰을 위한 보안 처리된 신호 공유 허용하기

게재 > 수요 채널 설정 으로 이동합니다. 기본 설정 탭에서 SDK 입찰 에 대해 보안 처리된 신호 공유 허용 을 사용 설정합니다.

저장 을 클릭합니다.

Meta 입찰 구성하기

게재 > 입찰자로 이동하여 SDK 입찰로 이동을 클릭합니다.

새 입찰자 를 클릭합니다.

입찰자로 Meta 를 선택합니다.

계속 을 클릭하여 이 입찰자에 대해 SDK 입찰을 사용 설정합니다.

완료 를 클릭합니다.

광고 단위 매핑 구성하기

게재 > 입찰자로 이동하여 SDK 입찰로 이동을 클릭합니다.

Meta Audience Network의 회사를 선택합니다.

광고 단위 매핑 탭으로 이동하여 새 광고 단위 매핑 을 클릭합니다.

특정 광고 단위 를 선택합니다. 광고 단위와 형식, 모바일 앱을 인벤토리 유형으로, 그리고 모바일 애플리케이션을 선택합니다. 그런 다음 이전 섹션에서 가져온 게재위치 ID 를 입력합니다.

Ad Manager UI 내에서 보상형 전면 광고의 광고 단위 매핑을 구성하는 경우 보상형 형식을 선택하고 보상형 전면 광고 게재위치 ID를 사용합니다.

마지막으로 저장 을 클릭합니다.

GDPR 및 미국 주 규정 광고 파트너 목록에 Meta 추가하기

유럽 규정 설정 및 미국 주 규정 설정의 단계에 따라 Ad Manager UI의 유럽 및 미국 주 규정 광고 파트너 목록에 Meta를 추가하세요.

3단계: Meta Audience Network SDK 및 어댑터 가져오기

Android 스튜디오 통합 (권장)

앱 수준 Gradle 파일에 다음 구현 종속 항목과 구성을 추가합니다.

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

수동 통합

• Android용 최신 버전의 Meta Audience Network SDK를 다운로드합니다. AudienceNetwork/bin 폴더에서 AudienceNetwork.aar를 추출하여 프로젝트에 추가합니다.

• Google의 Maven 저장소에서 Meta Audience Network 어댑터 아티팩트 로 이동합니다. 최신 버전을 선택하고 Meta Audience Network 어댑터의 .aar 파일을 다운로드하여 프로젝트에 추가합니다.

4단계: Meta Audience Network SDK에 개인 정보 보호 설정 구현하기

EU 동의 및 GDPR

Google EU 사용자 동의 정책을 준수하기 위해 게시자는 쿠키 또는 기타 로컬 스토리지의 사용(현지 법규에서 요구하는 경우) 및 광고 개인 최적화를 위한 개인 정보의 수집, 공유, 사용 사실을 유럽 경제 지역(EEA), 영국, 스위스의 사용자에게 공개하고 이에 대한 동의를 얻어야 합니다. 이 정책에는 EU 온라인 개인 정보 보호 지침 및 개인 정보 보호법 (GDPR)의 요구사항이 반영되어 있습니다. 동의가 미디에이션 체인의 각 광고 소스에 전파되는지 확인해야 합니다. Google은 사용자의 동의 여부를 이러한 네트워크에 자동으로 전달할 수 없습니다.

Meta는 IAB 유럽 글로벌 공급업체 목록 (GVL)에 등록되어 있지 않습니다. 대신 추가 동의 기술 사양을 사용해야 합니다. 자세한 내용은 추가 동의의 구성요소를 참고하세요. 추가 동의 사양은 IAB 유럽 투명성 및 동의 프레임워크 (TCF) 버전 2와 함께 작동합니다. 이 사양을 사용하면 동의 관리 플랫폼 (CMP) 및 파트너와 함께 Google 광고 기술 제공업체 (ATP) 목록에 있지만 아직 IAB 유럽 GVL에 포함되지 않은 회사의 보충 동의 신호를 수집하고 전송할 수 있습니다.

GDPR 및 Meta 광고에 대한 Meta 문서 의 안내를 따르세요.

미국 주 개인 정보 보호법

미국 주 개인 정보 보호법 은 사용자에게 법률에 정의된 조항에 따라 '개인 정보'의 '판매'를 거부할 권리를 부여합니다. 개인 정보 판매 거부 권리는 '판매'하는 회사의 홈페이지에 명시된 'Do Not Sell My Personal Information(내 개인 정보 판매 거부)' 링크를 통해 행사할 수 있습니다. 미국 주 개인 정보 보호법 준수 가이드에서는 Google 광고 게재에 대해 제한적인 데이터 처리를 사용 설정할 수 있지만, Google은 게시자 미디에이션 체인의 각 광고 네트워크에 이 설정을 적용할 수 없습니다. 따라서 미디에이션 체인에서 개인 정보 판매에 참여할 수 있는 각 광고 네트워크를 식별하고 각 네트워크의 가이드에 따라 규정을 준수해야 합니다.

캘리포니아에 거주하는 사용자의 데이터 처리 옵션에 대한 Meta 문서 의 안내를 따르세요.

5단계: 필수 코드 추가하기

Meta Audience Network 통합에는 추가 코드가 필요하지 않습니다.

6단계: 구현 테스트하기

테스트 광고 사용

Ad Manager에 테스트 기기를 등록하고 Meta Audience Network UI에서 테스트 모드를 사용 설정해야 합니다.

테스트 광고 확인

Meta Audience Network에서 테스트 광고가 수신되는지 확인하려면 단일 광고 소스 테스트를 사용 설정합니다. 광고 검사기에서 Meta Audience Network(입찰) 광고 소스를 사용합니다.

선택 단계

네이티브 광고

일부 Meta Audience Network 네이티브 광고 확장 소재는 Google 네이티브 광고 확장 소재에 일대일로 매핑되지 않습니다. 이러한 확장 소재는 NativeAd의 getExtras() 메서드를 통해 번들로 게시자에게 다시 전달됩니다. 어댑터는 다음 확장 소재 전달을 지원합니다.

다음은 이러한 확장 소재를 추출하는 방법을 보여주는 코드 예입니다.

예:

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

MediaView 없이 Meta Audience Network 네이티브 광고 사용

Meta Audience Network의 네이티브 광고 형식은 MediaView 확장 소재를 렌더링해야 합니다. 이 확장 소재 없이 네이티브 광고를 렌더링하려는 경우 Meta Audience Network's 네이티브 배너 광고 형식을 사용해야 합니다.

대신 Meta Audience Network의 네이티브 배너 광고를 사용하려면 Native Banner 형식을 선택해야 하며 Meta Audience Network를 설정할 때 어댑터가 상응하는 네이티브 광고 형식을 자동으로 로드합니다.

광고 렌더링

Audience Network 어댑터는 네이티브 광고를 NativeAd 객체로 반환합니다. 다음 필드 를 채웁니다. NativeAd

¹ Meta Audience Network 어댑터 는 네이티브 광고의 기본 이미지 확장 소재에 대한 직접 액세스를 제공하지 않습니다. 대신 어댑터는 MediaView 을 동영상이나 이미지로 채웁니다.

노출 및 클릭 추적

다음 표에서는 네이티브 광고 노출수와 클릭수를 기록하는 시점을 강조합니다. GMA Next-Gen SDK

Meta Audience Network에 노출수가 유효한 것으로 간주되려면 Meta Audience Network를 설정할 때네이티브 또는 네이티브 배너 광고 형식을 선택했는지에 따라 특정 확장 소재 렌더링 요구사항이 있습니다.

Android 9에서의 캐싱

Android 9 (API 수준 28)부터 일반 텍스트 지원이 기본적으로 사용 중지되므로, Meta Audience Network SDK의 미디어 캐싱 기능에 영향을 미치며, 사용자 환경 및 광고 수익에 영향을 미칠 수 있습니다. Meta 문서에 따라 앱의 네트워크 보안 구성을 업데이트하세요.

오류 코드

어댑터가 Audience Network에서 광고를 수신하지 못하면 다음 클래스에서 기본 오류를 사용하여 광고 응답의 ResponseInfo.getAdSourceResponses() 확인할 수 있습니다.

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

다음은 광고 로드에 실패할 때 Audience Network 어댑터에서 발생하는 코드와 메시지입니다.