Tapjoy와 미디에이션 통합

이 가이드는 Google 모바일 광고 SDK를 사용하여 입찰 또는 폭포식 구조 미디에이션을 통해 Tapjoy의 광고를 로드하고 표시하려는 게시자를 대상으로 작성되었습니다. 여기에는 광고 단위의 미디에이션 구성에 Tapjoy 광고를 추가하는 방법과 Tajojo SDK 및 어댑터를iOS 앱에 통합하는 방법이 나와 있습니다.

지원되는 통합 및 광고 형식

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

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

요구사항

  • iOS 배포 대상 10.0 이상
  • [입찰의 경우]: Tapjoy 어댑터 12.3.1.0 이상 (최신 버전 권장)
  • 최신 Google 모바일 광고 SDK

1단계: Tapjoy 설정하기

Tapjoy 대시보드에 가입하거나 로그인하세요.

앱 추가

오른쪽 상단에서 앱 목록으로 이동하여 앱 추가 버튼을 클릭하여 Tapjoy 대시보드에 앱을 추가합니다. 앱에 관한 세부정보를 입력하라는 메시지가 표시됩니다.

양식을 작성하고 지금 만들기 버튼을 클릭하여 Tapjoy 대시보드에 앱을 추가합니다.

Tapjoy에서 제공하는 통합 단계를 건너뛸 수 있으며 AdMob 미디에이션에 사용할 게재위치를 만들 수 있습니다.

게재위치, 가상 화폐, 콘텐츠

게재위치

수익 창출 및 게재위치로 이동한 다음 오른쪽 상단의 게재위치 만들기 버튼을 클릭합니다. 기존 게재위치가 있더라도 AdMob를 위한 새로운 게재위치를 만드는 것이 가장 바람직하므로 이를 별도로 추적하고 보고할 수 있습니다.

게재위치의 이름을 입력하고 미디에이션 체크박스를 선택한 다음 드롭다운 목록에서 AdMob을 선택합니다. 완료하면 만들기를 클릭합니다.

여기에 입력한 게재위치 이름은 다음 섹션에서 미디에이션을 위한AdMob 광고 단위를 설정하는 데 사용됩니다. 이 예에서는 "AdMob 미디에이션"가 사용되었지만 원하는 대로 게재위치를 호출할 수 있습니다.

가상 통화

수익 창출 및 가상 통화로 이동하여 오른쪽 상단의 가상 통화 만들기 버튼을 클릭합니다.

양식을 작성하고 지금 만들기를 클릭합니다. NOFOLLOW_CALLBACK콜백 URL로 사용합니다. 이렇게 하면 Tapjoy SDK가 불필요한 서버 호출을 피할 수 있습니다.

콘텐츠

수익 창출 및 콘텐츠 만들기로 이동하여 게재위치와 함께 표시할 콘텐츠를 만듭니다.

콘텐츠 제작에 대한 자세한 안내를 보려면 원하는 광고 형식에 해당하는 탭을 선택하세요.

입찰

전면 광고

프로그래매틱 전면 광고 동영상 콘텐츠의 만들기 버튼을 클릭합니다. 콘텐츠의 이름을 입력하고 플랫폼으로 iOS를 선택합니다. 앞서 만든 가상 통화를 가상 통화로 선택합니다. 앞서 만든 전면 광고 게재위치를 선택합니다. 완료되면 하단의 저장 버튼을 클릭하여 콘텐츠를 만듭니다.

리워드 제공됨

프로그래매틱 보상형 동영상 콘텐츠의 만들기 버튼을 클릭합니다. 콘텐츠의 이름을 입력하고 플랫폼으로 iOS를 선택합니다. 앞서 만든 가상 통화를 가상 통화로 선택합니다. 앞서 만든 보상형 게재위치를 선택합니다. 완료되면 하단의 저장 버튼을 클릭하여 콘텐츠를 만듭니다.

폭포

전면 광고

전면 동영상 콘텐츠의 만들기 버튼을 클릭합니다. 콘텐츠의 이름을 입력하고 플랫폼으로 iOS를 선택합니다. 앞서 만든 가상 통화를 가상 통화로 선택합니다. 앞서 만든 전면 광고 게재위치를 선택합니다. 완료되면 하단의 저장 버튼을 클릭하여 콘텐츠를 만듭니다.

리워드 제공됨

보상형 동영상 콘텐츠의 만들기 버튼을 클릭합니다. 콘텐츠의 이름을 입력하고 플랫폼으로 iOS를 선택합니다. 앞서 만든 가상 통화를 가상 통화로 선택합니다. 앞서 만든 보상형 게재위치를 선택합니다. 완료되면 하단의 저장 버튼을 클릭하여 콘텐츠를 만듭니다.

SDK 키 찾기

게재위치 이름 외에SDK 키에 AdMob 광고 단위도 설정해야 합니다.

Settings > App Settings로 이동합니다. SDK 키Application Platforms 탭의 App Info에서 얻을 수 있습니다.

[폭포식 구조만 해당] 보고 키 찾기

게시자 OAuth 키미디에이션 키가 필요합니다. 게시자 OAuth 키API 키 탭의 동일한 페이지에서 얻을 수 있습니다.

미디에이션 키미디에이션 API 키 열의 미디에이션 키 탭에 있는 동일한 페이지에서 얻을 수 있습니다. 'AdMob'이라는 라벨이 지정됩니다.

2단계: AdMob 광고 단위의 미디에이션 설정 구성하기

광고 단위의 미디에이션 구성에 Tapjoy를 추가해야 합니다. 먼저 AdMob 계정에 로그인합니다.

미디에이션 탭으로 이동합니다. 수정하려는 기존 미디에이션 그룹이 있는 경우 미디에이션 그룹의 이름을 클릭하여 수정한 다음 탭으로 광고 소스 추가로 건너뛰세요. 그렇지 않은 경우 새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.

광고 형식과 플랫폼을 입력한 후 계속을 클릭합니다.

미디에이션 그룹의 이름을 지정하고 타겟팅할 위치를 선택합니다. 다음으로 미디에이션 그룹 상태를 사용으로 설정합니다. 그런 다음 광고 단위 추가를 클릭합니다.

광고 단위 선택 오버레이

이 미디에이션 그룹을 기존 AdMob 광고 단위와 연결합니다. 그런 다음, 완료를 클릭합니다.

이제 아래와 같이 선택한 광고 단위로 채워진 광고 단위 카드가 표시됩니다.

Tapjoy를 광고 소스로 추가

입찰

광고 소스 섹션의 입찰 카드에서 광고 소스 추가를 선택합니다. 그런 다음 Tapjoy를 선택합니다.

그런 다음 이전 섹션에서 가져온 SDK KeyPlacement Name을 입력하고 Done을 클릭합니다.

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

폭포

광고 소스 섹션의 폭포식 구조 카드에서 광고 소스 추가를 선택합니다.

Tapjoy를 선택하고 Optimize 스위치를 사용 설정합니다. 이전 섹션에서 가져온 게시자 OAuth 키미디에이션 키를 입력하여 Tapjoy의 광고 소스 최적화를 설정합니다. 그런 다음 Tapjoy의 eCPM 값을 입력하고 계속을 클릭합니다.

그런 다음 이전 섹션에서 가져온 SDK 키게재위치 이름을 입력합니다. 그런 다음, 완료를 클릭합니다.

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

보상형 광고 사용

보상형 광고 단위의 설정에서 리워드 금액 및 리워드 유형 값을 제공합니다. 그런 다음 게재되는 광고 네트워크에 관계없이 사용자에게 동일한 보상을 제공하려면 미디에이션 그룹의 모든 네트워크에 적용 체크박스를 선택합니다.

이 설정을 적용하지 않으면 Tapjoy 어댑터가 기본적으로 값이 1""(빈 문자열) 보상으로 설정됩니다. Tapjoy SDK는 보상형 광고에 특정 보상 값을 제공하지 않습니다.

AdMob 광고 단위의 리워드 값 설정에 대한 자세한 내용은 광고 단위 만들기를 참조하세요.

3단계: Tapjoy SDK 및 어댑터 가져오기

  • 프로젝트 Podfile에 다음 행을 추가합니다.

    pod 'GoogleMobileAdsMediationTapjoy'
    
  • 명령줄에서 다음을 실행합니다.

    pod install --repo-update

수동 통합

  • 최신 버전의 Tapjoy SDK를 다운로드하고 프로젝트에 Tapjoy.embeddedframework를 연결합니다.

  • 변경 로그의 다운로드 링크에서 Tapjoy 어댑터의 최신 버전을 다운로드하고 프로젝트에 TapjoyAdapter.framework 링크를 연결합니다.

4단계: 추가 코드 필요

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

5단계: 구현 테스트

테스트 광고는 설정 및 앱 설정, 테스트 기기의 Tapjoy 대시보드에 사용 설정할 수 있습니다. 아래와 같이 기기의 광고 ID를 사용하여 새 테스트 기기를 만듭니다.

기기의 광고 ID를 가져오려면 앱에 다음 코드를 추가하세요. 아래 코드를 사용하기 전에 AdSupport 프레임워크를 앱으로 가져오세요.

Swift

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Objective-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

그런 다음 앞서 만든 콘텐츠를 수정합니다.

콘텐츠를 수정하려면 먼저 수익 창출 및 게재위치로 이동하여 사용자가 시작한 탭을 클릭합니다. 그런 다음 수정할 콘텐츠의 드롭다운을 선택하고 Edit을 선택합니다.

콘텐츠의 기본 섹션에서 테스트 기기에만 체크박스를 선택합니다. 그런 다음 페이지 하단에서 저장을 클릭합니다. 작업이 끝났습니다. 이제 Tapjoy와 미디에이션 통합이 이루어졌습니다.

선택 단계

Google EU 사용자 동의 정책에 따라 기기 식별자 및 개인 정보 사용과 관련하여 유럽 경제 지역 (EEA)의 사용자에게 특정 정보를 공개하고 동의를 얻어야 합니다. 이 정책에는 EU 온라인 개인정보보호지침 및 개인정보 보호법 (GDPR)의 요구사항이 반영되어 있습니다. 동의를 요청할 때는 미디에이션 체인에서 개인 정보를 수집, 수신 또는 사용할 수 있는 각 광고 네트워크를 식별해야 하며, 각 네트워크 사용에 관한 정보를 제공해야 합니다. Google은 현재 사용자의 동의 선택을 자동으로 이러한 네트워크에 전달할 수 없습니다.

아래 섹션에서는 Tapjoy의 개인 맞춤 광고를 사용 설정 또는 중지하는 방법을 설명합니다.

Tapjoy SDK 버전 11.12.2에서 Tapjoy 추가 사용자 동의 API 다음 샘플 코드는 Tapjoy SDK에서 사용자 동의를 \'1>\'로 설정합니다. 이 메서드를 호출하기로 선택한 경우 Google 모바일 광고 SDK를 통해 광고를 요청하기 전에 호출하는 것이 좋습니다.

#import <Tapjoy/Tapjoy.h>
// ...

[Tapjoy setUserConsent:@"1"]; // user does consent

자세한 내용은 Tapjoy& 출시 노트

GDPR 광고 파트너 목록에 Tapjoy 추가

GDPR 설정 의 단계를 따라AdMob UI의 GDPR 광고 파트너 목록에 Tapjoy를 추가합니다.

CCPA

캘리포니아 소비자 개인 정보 보호법(CCPA) 은 캘리포니아주 주민에게 법률에 정의된 '개인 정보'의 '개인 정보 판매'를 거부할 권리를 부여합니다. CCPA 준비 가이드에서는 Google 광고 게재에 제한적인 데이터 처리를 사용 설정할 수 있는 기능을 제공하지만, 이 설정을 미디에이션 체인의 각 광고 네트워크에 적용할 수는 없습니다. 따라서 미디에이션 체인의 각 광고 네트워크를 식별하고 개인 정보 판매에 참여할 수 있으며 각 네트워크의 안내에 따라 CCPA를 준수하도록 해야 합니다.

CCPA 광고 파트너 목록에 Tapjoy 추가

CCPA 설정 의 단계를 따라AdMob UI의 CCPA 광고 파트너 목록에 Tapjoy를 추가합니다.

네트워크별 매개변수

Tapjoy 어댑터는 GADMTapjoyExtras 클래스를 사용하여 어댑터에 전달할 수 있는 추가 요청 매개변수를 지원합니다. 이 클래스에는 다음과 같은 속성이 있습니다.

  • debugEnabled - 디버그 모드를 위해 Tapjoy SDK에서 로깅을 사용 설정하려면 YES로 설정합니다.

다음은 광고 요청 시 이 매개변수를 설정하는 방법의 코드 예입니다.

Swift

let request = GADRequest()
let extras = GADMTapjoyExtras()
extras.debugEnabled = true
request.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADMTapjoyExtras *extras = [[GADMTapjoyExtras alloc] init];
extras.debugEnabled = YES;
[request registerAdNetworkExtras:extras];

어댑터 및 SDK 버전 확인

어댑터 및 SDK 버전을 로깅하려면 다음 코드 스니펫을 사용하세요.

Class<GADMediationAdapter> adapterClass = NSClassFromString(@"GADMediationAdapterTapjoy");
if (adapterClass != nil) {
  GADVersionNumber adapterVersion = [adapterClass version];
  GADVersionNumber sdkVersion = [adapterClass adSDKVersion];
  NSLog(@"Adapter version: %ld.%ld.%ld.%ld",
        adapterVersion.majorVersion,
        adapterVersion.minorVersion,
        adapterVersion.patchVersion / 100,
        adapterVersion.patchVersion % 100);
  NSLog(@"SDK version: %ld.%ld.%ld",
        sdkVersion.majorVersion,
        sdkVersion.minorVersion,
        sdkVersion.patchVersion);
}

Swift에 동적 런타임 기능이 존재하지 않으므로 클래스 이름에서 클래스를 동적으로 만들기가 불가능하므로 Swift에서 어댑터 버전을 로깅할 수 없습니다. Swift에서 필요한 경우 Objective-C로 작성하고 브리징 헤더를 사용하여 가져와야 합니다.

오류 코드

어댑터에서 Tapjoy의 광고를 수신하지 못한 경우 게시자는 다음 클래스의 GADResponseInfo.adNetworkInfoArray로 이동하세요.

형식 클래스 이름
전면 광고 GADMAdapterTapjoy
리워드 제공됨 GADMAdapterTapjoy

다음은 광고 로드에 실패할 때 Tapjoy 어댑터에서 발생하는 코드 및 관련 메시지입니다.

오류 코드 이유
101 UI에 구성된 Tapjoy 서버 매개변수가 AdMob 누락되거나 잘못되었습니다.
103 게시자는 Activity 컨텍스트로 광고를 요청해야 합니다.
104 Tapjoy SDK를 초기화하지 못했습니다.
105 동영상 재생 중에 Tapjoy 프레젠테이션 오류가 발생했습니다.
106 Tapjoy SDK는 동일한 게재위치 ID에 대한 광고 2개를 한 번에 로드할 수 없습니다.
107 앱에서 네이티브 광고를 요청하지 않았습니다.
108 Tapjoy SDK에는 사용 가능한 광고 콘텐츠가 없습니다.
101 UI에 구성된 Tapjoy 서버 매개변수가 AdMob 누락되거나 잘못되었습니다.
102 Tapjoy SDK를 초기화하지 못했습니다.
103 Tapjoy 어댑터가 요청 중인 광고 형식을 지원하지 않습니다.
104 Tapjoy가 로드 콜백을 전송했지만 사용 가능한 콘텐츠가 없습니다.
105 이 네트워크 구성용으로 광고가 이미 로드되었습니다.
106 Tapjoy SDK가 동영상 오류 오류 콜백을 반환했습니다.

Tapjoy iOS 미디에이션 어댑터 변경 로그

버전 12.10.0.0

  • Tapjoy SDK 12.10.0과의 호환성이 확인되었습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.4.0
  • Tapjoy SDK 버전 12.10.0

버전 12.9.1.0

  • Tapjoy SDK 12.9.1과의 호환성을 확인했습니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.1.0
  • Tapjoy SDK 버전 12.9.1

버전 12.9.0.1

  • Google 모바일 광고 SDK 버전 9.0.0과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 9.0.0 이상이 필요합니다.

빌드 및 테스트 대상:

  • Google 모바일 광고 SDK 버전 9.0.0
  • Tapjoy SDK 버전 12.9.0

버전 12.9.0.0

  • Tapjoy SDK 12.9.0과의 호환성이 확인되었습니다.
  • 이제 최소 iOS 버전 10.0이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 8.13.0
  • Tapjoy SDK 버전 12.9.0

버전 12.8.1.0

  • Tapjoy SDK 12.8.1과의 호환성이 확인되었습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 8.5.0
  • Tapjoy SDK 버전 12.8.1

버전 12.8.0.1

  • Google 모바일 광고 SDK 버전 8.0.0 이상에 대한 종속 항목이 완화되었습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 8.4.0
  • Tapjoy SDK 버전 12.8.0

버전 12.8.0.0

  • .xcframework 형식을 사용하도록 어댑터를 업데이트했습니다.
  • Tapjoy SDK 12.8.0과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 8.2.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 8.2.0
  • Tapjoy SDK 버전 12.8.0

버전 12.7.1.0

  • Tapjoy SDK 12.7.1과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.67.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.67.0
  • Tapjoy SDK 버전 12.7.1

버전 12.7.0.0

  • Tapjoy SDK 12.7.0과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.65.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.65.0
  • Tapjoy SDK 버전 12.7.0

버전 12.6.1.0

  • Tapjoy SDK 12.6.1과의 호환성을 확인했습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.61.0
  • Tapjoy SDK 버전 12.6.1

버전 12.6.0.0

  • Tapjoy SDK 12.6.0과의 호환성이 확인되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.61.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.61.0
  • Tapjoy SDK 버전 12.6.0

버전 12.4.2.2

  • 광고 이벤트 콜백 전달의 일관성을 높이기 위해 어댑터를 업데이트했습니다.
    • 이제 전면 광고 및 보상형 광고에서 클릭이 기록됩니다.
    • 이제 전면 광고를 클릭하면 interstitialWillLeaveApplication:이(가) 전달됩니다.
    • 이제 보상형 광고를 닫으면 willDismissFullScreenView:가 전달됩니다.
  • 표준화된 어댑터 오류 코드와 메시지가 추가되었습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.60.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.60.0
  • Tapjoy SDK 버전 12.4.2

버전 12.4.2.1

  • 이제 사용 가능한 콘텐츠 없이 Tapjoy에 관한 요청이 반환되면 어댑터가 실패합니다.
  • i386 아키텍처에 대한 지원이 삭제되었습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.57.0
  • Tapjoy SDK 버전 12.4.2

버전 12.4.2.0

  • Tapjoy SDK 12.4.2와의 호환성이 확인되었습니다.
  • 이제 iOS 버전 9.0 이상이 필요합니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.55.0
  • Tapjoy SDK 버전 12.4.2

버전 12.4.1.0

  • Tapjoy SDK 12.4.1과의 호환성을 확인했습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.53.1
  • Tapjoy SDK 버전 12.4.1

버전 12.4.0.0

  • Tapjoy SDK 12.4.0과의 호환성이 확인되었습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.53.1
  • Tapjoy SDK 버전 12.4.0

버전 12.3.4.0

  • Tapjoy SDK 12.3.4와의 호환성이 확인되었습니다.

빌드 및 테스트 도구

  • Google 모바일 광고 SDK 버전 7.52.0
  • Tapjoy SDK 버전 12.3.4

버전 12.3.3.0

  • Tapjoy SDK 12.3.3과의 호환성이 확인되었습니다.

버전 12.3.2.0

  • Tapjoy SDK 12.3.2와의 호환성이 확인되었습니다.

버전 12.3.1.0

  • Tapjoy SDK 12.3.1과의 호환성을 확인했습니다.
  • 전면 광고 및 보상형 광고용 어댑터에 입찰 기능을 추가했습니다.

버전 12.2.1.0

  • Tapjoy SDK 12.2.1과의 호환성을 확인했습니다.
  • 새 보상형 API를 사용하도록 어댑터를 업데이트했습니다.
  • 이제 Google 모바일 광고 SDK 버전 7.42.2 이상이 필요합니다.

버전 12.2.0.0

  • Tapjoy SDK 12.2.0과의 호환성이 확인되었습니다.

버전 12.1.0.0

  • Tapjoy SDK 12.1.0과의 호환성이 확인되었습니다.

버전 12.0.0.0

  • Tapjoy SDK 12.0.0과의 호환성이 확인되었습니다.
  • 어댑터에 adapterDidCompletePlayingRewardBasedVideoAd: 콜백을 추가했습니다.

버전 11.12.2.0

  • Tapjoy SDK 11.12.2와의 호환성이 확인되었습니다.

버전 11.12.1.0

  • Tapjoy SDK 11.12.1과의 호환성을 확인했습니다.

버전 11.12.0.0

  • Tapjoy SDK 11.12.0과의 호환성이 확인되었습니다.

버전 11.11.1.0

  • Tapjoy SDK 11.11.1과의 호환성을 확인했습니다.

버전 11.11.0.0

  • Tapjoy SDK 11.11.0과의 호환성이 확인되었습니다.

버전 11.10.2.0

  • 기본 리워드 금액을 1로 업데이트했습니다.
  • armv7s 아키텍처 지원이 삭제되었습니다.
  • Tapjoy SDK 11.10.2와의 호환성이 확인되었습니다.

버전 11.10.1.0

  • Tapjoy SDK 11.10.1과의 호환성을 확인했습니다.

버전 11.10.0.0

  • Tapjoy SDK 11.10.0과의 호환성이 확인되었습니다.

버전 11.9.1.0

  • 첫 출시입니다. 보상 기반 동영상 광고 및 전면 광고를 지원합니다.