LY Ads Network를 AdMob 미디에이션과 통합

이 가이드에서는 Google Mobile Ads SDK for React Native를 사용하여 미디에이션을 통해 LY 광고 네트워크의 광고를 로드하고 표시하는 방법을 보여주며, 폭포식 구조 통합에 대해 다룹니다. 광고 단위의 미디에이션 구성에 LY 광고 네트워크를 추가하는 방법과 LY 광고 네트워크 SDK 및 어댑터를 React 네이티브 앱에 통합하는 방법을 설명합니다.

지원되는 통합 및 광고 형식

LY Ads Network용 AdMob 미디에이션 어댑터에는 다음과 같은 기능이 있습니다.

통합
입찰
폭포형
형식
앱 열기
배너
전면 광고
리워드 제공됨
보상형 전면 광고
네이티브

기본 요건

계속하기 전에 다음을 확인하세요.

1단계: LY 광고 네트워크 UI에서 구성 설정하기

LY Ads Network에 가입하고 계정에 로그인합니다.

새 애플리케이션 추가하기

앱 탭으로 이동하여 새 등록 버튼을 클릭합니다.

신규 등록

양식을 작성하고 등록을 클릭합니다.

새 등록 양식

앱 ID를 기록해 둡니다.

Android

등록 세부정보

iOS

등록 세부정보

광고 슬롯 만들기

앱 탭에서 앱을 선택하여 앱의 세부정보를 확인합니다. 슬롯 섹션에서 추가를 클릭합니다.

슬롯 추가

슬롯에 관한 세부정보를 양식에 입력합니다. 입찰 유형의 경우, 폭포식 구조 미디에이션을 위해 이 슬롯을 구성하려면 표준을, 입찰을 위해 구성하려면 Google SDK 입찰을 선택합니다. 양식을 작성한 후 만들기를 클릭합니다.

슬롯 양식 추가

슬롯 ID를 기록해 둡니다.

슬롯 세부정보

첫 번째 슬롯을 만든 후 앱의 세부정보 페이지에서 검토를 클릭하여 LY 광고 네트워크의 승인을 받습니다. 다소 시간이 걸릴 수 있습니다. 궁금한 점이 있으면 LY Ads Network 담당자에게 문의하세요.

검토 요청

Reporting API 키 만들기

보고 API 키 관리 탭으로 이동하여 API 키 만들기 버튼을 클릭합니다.

Reporting API Key 탭

양식을 작성하고 저장을 클릭합니다.

Reporting API 키 양식

API 키 ID 및 API 키 보안 비밀번호를 기록해 둡니다.

Reporting API 키 양식

app-ads.txt 업데이트

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

LY Ads Network에 app-ads.txt를 구현하려면 app-ads.txt 정보를 참고하세요.

2단계: AdMob UI에서 LY 광고 네트워크 수요 설정하기

광고 단위의 미디에이션 설정 구성

Android

자세한 내용은 Android 가이드의 2단계를 참고하세요.

iOS

자세한 내용은 iOS 가이드의 2단계를 참고하세요.

3단계: LY 광고 네트워크 SDK 및 어댑터 가져오기

프로젝트의 루트 디렉터리에 LY 광고 네트워크용 Google Mobile Ads SDK for React Native 미디에이션 어댑터를 설치합니다. 다음을 완료합니다.

  1. Google Mobile Ads SDK for React Native 어댑터 tar 파일을 gma-sdk-react-native/adapters/line/ 디렉터리에서 프로젝트의 local_packages/ 디렉터리로 복사합니다. adapters 폴더가 없으면 기본 요건을 참고하세요.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/

    EXTRACT_DIR를 보관 파일을 추출한 디렉터리의 경로로 바꿉니다.

  2. 원하는 패키지 관리자를 사용하여 어댑터 패키지를 설치합니다.

    npm

    npm install ./local_packages/gma-mediation-line-0.1.0.tgz

    털실

    yarn add ./local_packages/gma-mediation-line-0.1.0.tgz

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

Android

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

iOS

SKAdNetwork 통합

LY 광고 네트워크 문서에 따라 SKAdNetwork 식별자를 프로젝트의 Info.plist 파일에 추가합니다.

5단계: 구현 테스트하기

테스트 광고 사용 설정

AdMob에 테스트 기기를 등록해야 합니다.

테스트 광고 확인

LY Ads Network에서 테스트 광고를 수신하는지 확인하려면 LY Ads Network 광고 소스를 사용하여 광고 검사기에서 단일 광고 소스 테스트를 사용 설정하세요.

선택 단계

네트워크별 매개변수

LY 광고 네트워크 React Native 미디에이션 플러그인은 LineMediationExtras 클래스를 통해 어댑터에 전달할 수 있는 다음과 같은 추가 요청 매개변수를 지원합니다.

  • enableAdSound : 배너 광고, 전면 광고, 보상형 광고의 기본 소리 시작 상태를 지정합니다.

다음은 이러한 매개변수를 설정하는 광고 요청을 생성하는 코드 예입니다.

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

오류 코드

어댑터가 LY 광고 네트워크에서 광고를 수신하지 못하면 게시자는 다음 클래스에서 ResponseInfo를 사용하여 광고 응답의 기본 오류를 확인할 수 있습니다.

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

오류 코드 도메인 이유
1-10 com.five_corp.ad LY Ads Network SDK가 SDK 관련 오류를 반환했습니다. 자세한 내용은 LY Ads Network의 문서를 참고하세요.
101 com.google.ads.mediation.line 애플리케이션 ID가 누락되었거나 잘못되었습니다.
102 com.google.ads.mediation.line 슬롯 ID가 누락되었거나 잘못되었습니다.
103 com.google.ads.mediation.line 요청된 광고 크기가 LY 광고 네트워크에서 지원하는 배너 광고 크기와 일치하지 않습니다.
104 com.google.ads.mediation.line 활동 컨텍스트가 누락되어 전면 광고 또는 보상형 광고를 로드하지 못했습니다.
105 com.google.ads.mediation.line LY 광고 네트워크 SDK에서 전면 광고 또는 보상형 광고를 표시하지 못했습니다.
106 com.google.ads.mediation.line 확장 소재가 누락되어 네이티브 광고를 로드할 수 없습니다.
107 com.google.ads.mediation.line FiveAd SDK에서 null 광고 로더를 반환했습니다.

iOS

오류 코드 도메인 이유
1-10 LY 광고 네트워크 SDK에서 전송됨 LY Ads Network SDK가 SDK 관련 오류를 반환했습니다. 자세한 내용은 LY Ads Network의 문서를 참고하세요.
101 com.google.ads.mediation.line 서버 매개변수가 잘못되었습니다(예: 애플리케이션 ID 또는 슬롯 ID 누락).
102 com.google.ads.mediation.line 요청된 광고 크기가 LY 광고 네트워크에서 지원하는 배너 광고 크기와 일치하지 않습니다.
103 com.google.ads.mediation.line 네이티브 광고에서 정보 아이콘 이미지 확장 소재를 로드하지 못했습니다.
104 com.google.ads.mediation.line 입찰 신호를 수집하지 못했습니다.
105 com.google.ads.mediation.line LINE Ads SDK 광고 로더를 초기화하지 못했습니다.

버전 0.1.0

  • 첫 출시입니다.