애드콜로니 SDK 유니티 플러그인

라이센스 진행률 기여
유니티 버전 안드로이드 버전 iOS 버전

요구 사항

개요

AdColony는 제로 버퍼링, 전체 화면 인스턴트 플레이™ HD 비디오, 대화 형 오로라™ 비디오및 응용 프로그램 내에서 어디서나 표시 할 수있는 재생 가능한 광고™ 를 제공합니다. 당사의 광고 SDK는 세계 최고의 게임 및 비게임 퍼블리셔들의 신뢰를 받고 있으며, 브랜드 및 성과 광고주로부터 가장 높은 수익 창출 기회를 제공합니다. AdColony의 SDK는 인스트림/프리롤, 아웃스트림/전면 광고 및 V4VC™ 등 다양한 광고 형식으로 수익을 창출할 수 있으며, 동영상 및 재생 가능한 광고가 완료되면 앱 사용자에게 가상 화폐로 보상을 제공합니다.

릴리스 정보

v4.1.0 (2019/09/27)

  • 애드 콜로니 SDK 4.1.0 (아이폰 OS / 안드로이드)로 업데이트되었습니다.
  • 배너에 대한 지원이 추가되었습니다.

v3.3.11 (2019/07/15)

  • 애드 콜로니 SDK 에 업데이트 3.3.11 (안드로이드)
  • [안드로이드] 서버 측 업데이트와 함께 노출된 동시수정예외를 수정했습니다.
  • [안드로이드] AdColony가 비활성화될 가능성이 있는 부분 다운로드와 관련된 문제를 수정했습니다.

v3.3.10 (2019/06/12)

  • 애드 콜로니 SDK 에 업데이트 3.3.8.1 (아이폰 OS) 및 3.3.10 (안드로이드)
  • [iOS] 일부 광고의 클릭 동작이 작동하지 않는 버그를 수정했습니다.
  • [안드로이드] 공유 개체 라이브러리에서 이전에 처리한 업무에 대한 향상된 WebView 동작입니다.

v3.3.9 (2019/03/20)

  • 애드 콜로니 SDK 에 업데이트 3.3.9 (안드로이드)
  • [안드로이드] 3.3.7 및 3.3.8 SDK를 가진 안드로이드 롤리팝 장치에서 광고가 게재되는 것을 중지 NullPointerException을 수정했습니다.

v3.3.8 (01/25/2019)

  • 애드 콜로니 SDK 에 업데이트 3.3.7 (아이폰 OS) 및 3.3.8 (안드로이드)
  • [iOS] CPU 감시 타이머가 범법수정되었습니다.
  • [iOS] UIView 개체가 수명이 지난 후 메모리에 남아 있을 수 있는 메모리 누수 문제를 해결했습니다.
  • [iOS] 일관되지 않은 뷰 컨트롤러 방향을 위해 고급 로깅이 추가되었습니다.
  • [iOS] 다른 여러 버그 수정 및 안정성 향상.
  • [안드로이드] 처리된 런타임장치가 WebView 패키지가 누락되었다고 보고하는 경우 WebView 초기화 중에 발생할 수 있는 예외입니다.

v3.3.7 (2018/12/06)

  • 애드 콜로니 SDK 에 업데이트 3.3.7 (안드로이드)
  • [안드로이드] 메모리 소비와 관련된 상당한 안정성 향상.
  • [안드로이드] 광고 요청 응답 시간을 단축했습니다.
  • [안드로이드] 공유 개체(.so) 라이브러리를 제거하여 프로세스에서 SDK 배포 크기를 94% 줄이고 #25, #33#38문제를 해결합니다.

v3.3.6 (2018년 11월 19일)

  • 애드 콜로니 SDK 에 업데이트 3.3.6 (아이폰 OS / 안드로이드)
  • 몇 가지 버그 수정 및 안정성 개선.
  • [iOS] 벨소리/무음 스위치로 오디오 를 침묵할 수 있는 지원이 추가되었습니다. 대시보드에서 구성할 수 clients.adcolony.com.
  • [iOS] 오디오 세션은 광고를 재생할 때까지 활성화되지 않습니다.
  • [안드로이드] 활동 대신 응용 프로그램 컨텍스트를 허용하는 추가 configure() 서명을 추가했습니다.
  • [안드로이드] 더 이상 애드 콜로니어뷰 활동, 애드 콜로니네이티브AdView, 및 onAudioStarted / onAudioStopped () 콜백.
  • [안드로이드] 기본 cleartext 트래픽동작에 대한 API 수준 28 변경 내용을 처리합니다.

v3.3.5 (2018년 7월 18일)

  • 공식적으로 오픈 소스 유니티 플러그인
  • 애드 콜로니 SDK 에 업데이트 3.3.5 (아이폰 OS / 안드로이드)
  • 몇 가지 버그 수정 및 안정성 개선.
  • [iOS] 카메라 및 캘린더 권한에 대한 요구 사항이 제거되었습니다. 그러나 이러한 사용 권한을 사용하도록 설정하면 더 높은 유료 광고를 받을 수 있습니다.
  • [안드로이드] 수정 됨 거부실행문제 #37예외.
  • [안드로이드] #35 Unity OnConfiguration완료 콜백 문제를 해결하는 데 필요한 Android SDK 변경 사항을 변경했습니다.

v3.3.4 (2018년 5월 25일)

  • 애드 콜로니 SDK 에 업데이트 3.3.4 (아이폰 OS / 안드로이드)
  • [iOS] 상태 표시줄이 겹치기 때문에 광고 동영상의 닫기 버튼이 쉽게 탭할 수 없는 버그를 수정했습니다.
  • [iOS] 기기의 배터리 잔량에 대한 안전하지 않은 액세스로 인해 iOS SDK 문제 #49언급된 충돌이 발생하던 문제를 수정했습니다.
  • [안드로이드] #29 안드로이드 SDK 문제에언급 된 새로운 NullPointerException을 수정했습니다.
  • [유니티] 유럽 연합의 GDPR(일반 데이터 보호 규정)을 준수하는 데 필요한 사용자 동의를 전달하는 새 API를 추가했습니다. 사용자로부터 동의를 수집하는 경우 이 새 API를 사용하여 AdColony 및 모든 다운스트림 소비자에게 동의를 알릴 수 있습니다. 자세한 내용은 GDPR 자주 묻는 질문과 구현 세부 정보를 참조하세요.
  • [유니티] 네이티브 SDK 내에서 기호 링크 제거
  • [유니티] 일부 로그 문에서 누락된 영역 ID를 수정했습니다.
  • [유니티] Unity 플러그인 문제에 언급된 OnRequestInterstitial실패 콜백 중 #42
  • [모두] 몇 가지 버그 수정 및 안정성 개선.

자세한 내용은 전체 릴리스 정보를 참조하십시오.

빌드 방법

Unity 플러그인에는 기본 iOS 및 Android SDK 리포지토리가 모두 필요합니다. Plugin/src/sdks 디렉터리. 다음 명령을 사용하여 아래로 당길 수 있습니다.

cd Plugin/src/sdks
git clone https://github.com/AdColony/AdColony-Android-SDK.git
git clone https://github.com/AdColony/AdColony-iOS-SDK.git

플러그인을 빌드하려면 플러그인 폴더의 메이크 파일을 사용합니다.

cd Plugin
make

이 리포지토리에는 테스트 중에 사용할 수 있는 샘플 응용 프로그램이 포함되어 있습니다.

시작하기

애드콜로니 앱 및 영역 ID 검색

clients.adcolony.com. 아직 사용하지 않은 경우 웹 사이트에 앱및 필요한 영역을 만듭니다. 새 앱 및 비디오 영역을 만들려면 퍼블리셔 섹션. AdColony 웹 사이트에서 ID와 해당 영역 ID를 검색하고 나중에 사용할 수 있도록 기록하십시오. 아래 의 스크린 샷을 참조하십시오 응용 프로그램 ID 및 영역 ID의위치.

앱 ID 받기

페이지 하단의 영역 링크를 클릭하여 영역 세부 정보를 가져옵니다.

영역 ID 받기

이 경우 앱 ID는 app4c2e4129ea7ce및 영역 ID, z4c2e422e48151 앱을 초기화하고 프로젝트 내에서 광고를 표시하는 데 사용해야 합니다.

설치

  1. Unity 편집기에서 "에셋"---"가져오기 패키지"-"사용자 지정 패키지"를 선택합니다. AdColony SDK 유니티 플러그인의 위치로 이동하여 "AdColony.unitypackage"를 선택합니다.

    가져오기 패키지

  2. "가져오기"를 선택하여 모든 에셋을 프로젝트로 가져옵니다.

    가져오기 패키지

  3. 애드 콜로니 SDK 유니티 플러그인은 자동으로 필요한 구글 플레이 서비스 라이브러리를 끌어 구글의 PlayServicesResolver가 포함되어 있습니다. 이와 충돌이 있는 경우 play-services-ads 라이브러리가 필요한 유일한 것입니다. 이 PlayServicesResolver 설치를 무시하도록 선택할 수 있습니다. AdColony/Editor/ADCDependencies.cs 파일을 포함하고, play-services-ads 다른 방법으로.
  4. 플러그인 / 안드로이드 / 애드 콜로니 / 안드로이드 매니페스트.xml 파일이 자동으로 생성됩니다. 수동으로 업데이트하려면 "도구"---"AdColony"->"AndroidManifest.xml 업데이트"를 선택합니다.

SDK 3.0.x에서 업그레이드:

얇은 / 지방 안드로이드 빌드를 지원하기 위해, 우리는 네이티브 .so 파일을 이동 Plugins/Android/AdColony/libs 폴더를 Plugins/Android/libs 폴더. 제거 Plugins/Android/AdColony/libs 가져오기 전에 폴더를 가져오는 것이 좋습니다.

SDK 2.x에서 업그레이드:

2.x Unity 플러그인에서 업데이트하는 것은 드래그 앤 드롭 업데이트가 아니라 API 및 프로세스 변경 사항 중단을 포함합니다. 3.x Unity 플러그인을 활용하려면 설치하기 전에 이전 플러그인을 제거하십시오.

광고 게재

사용자에게 광고를 게재하기 위해 AdColony SDK를 사용하는 기본 사항은 다음과 같습니다.

애드콜로니 구성

첫 번째 단계는 AdColony SDK를 구성하는 것입니다.

    string[] zoneIds = new string[] { "zone_id_1", "zone_id_2" };
    AdColony.Ads.Configure(APP_ID, null, zoneIds);

성능에 영향을 주지 않고 서비스를 두 번 이상 구성할 수 있습니다. 서비스가 이미 동일한 옵션 및 영역으로 초기화된 경우 시도는 무시됩니다.

사용 방법에 대한 API 설명서를 참조하십시오. AppOptions.

배너 광고 게재

  1. 콜백 등록

    AdColony SDK를 성공적으로 구성한 후에는 다음과 같은 배너 콜백을 등록해야 합니다.

    • OnAdViewLoaded – 광고 보기가 로드되었을 때 호출됩니다.
    • OnAdViewFailedToLoad – 광고 보기가 로드되지 못했을 때 호출됩니다.

    콜백의 전체 목록은 AdColony.cs.

    AdColony.AdColonyAdView adView;
    
    AdColony.Ads.OnAdViewLoaded += (AdColony.AdColonyAdView ad) => {
        adView = ad;
    };
    
    AdColony.Ads.OnAdViewFailedToLoad += (AdColony.AdColonyAdView ad) => {
        Debug.Log("Banner ad failed to load");
    };
  2. 배너 광고 요청
    AdColony.Ads.RequestAdView("zone_id_1", AdColony.AdSize.Banner, null);

전면 광고 게재

  1. 콜백 등록

    AdColony SDK를 성공적으로 구성한 후에는 다음과 같은 중요한 서비스 콜백에도 등록해야 합니다.

    • OnRequestInterstitial – 요청된 광고를 게재할 준비가 되면 호출됨
    • OnExpiring – 광고가 만료된 경우(일반적으로 30~60분 후) 호출됨) 이 콜백을 사용하여 새 광고를 요청하는 것이 좋습니다.
    • OnRewardGranted – 사용자가 보상 비디오 영역에서 동영상을 완료 할 때 호출

    콜백의 전체 목록은 AdColony.cs.

    AdColony.InterstitialAd _ad = null;
    
    AdColony.Ads.OnRequestInterstitial += (AdColony.InterstitialAd ad) => {
        _ad = ad;
    };
    
    AdColony.Ads.OnExpiring += (AdColony.InterstitialAd ad) => {
        AdColony.Ads.RequestInterstitialAd(ad.ZoneId, null);
    };
  2. 전면 광고 요청
    AdColony.Ads.RequestInterstitialAd("zone_id_1", null);
  3. 전면 광고 표시
    if (_ad != null) {
        AdColony.Ads.ShowAd(_ad);
    }

보상게재 광고 게재

보상형 동영상 광고를 게재하는 것은 삽입 동영상 광고를 게재하는 것과 매우 유사합니다. 두 가지 미묘한 차이점이 있습니다.

  1. 광고 옵션을 사용하여 어워드를 수상했거나 사용자에게 알리는 시스템 알림을 선택적으로 표시할 수 있습니다. ShowPrePopupShowPostPopup.
    AdColony.AdOptions adOptions = new AdColony.AdOptions();
    adOptions.ShowPrePopup = true;
    adOptions.ShowPostPopup = true;
    
    AdColony.Ads.RequestInterstitialAd("zone_id_1", adOptions);
  2. 광고가 개발자 포털에서 보상으로 설정된 영역에서 나온 경우, OnRewardGranted 이벤트가 사용자가 광고를 시청한 후에 호출됩니다. 이 콜백 내에서 는 보상을 사용자에게 부여해야 하는 경우입니다. 서버 간 콜백을 사용하도록 설정한 경우 서버에서 새 상태를 다운로드해야 하는 경우입니다.
    AdColony.Ads.OnRewardGranted += (string zoneId, bool success, string name, int amount) => {
        // Grant the reward to the user, or
        // request new state from the game server if using server-to-server callbacks
    };

포털에서 보상을 받는 중간 영역으로 영역을 설정하려면 다음 영역 유형을 선택합니다.

영역 ID 받기

그라들 통합

유니티는 유니티 5.5에서 안드로이드용 Gradle 빌드 시스템을 도입했습니다. 이 문서에서는 Unity 패키지에서 Gradle과 함께 AdColony를 사용하는 데 필요한 설정을 간략하게 설명합니다.

build.gradle 파일에 다음을 추가합니다.

android {
  /** Any other configurations here */
  sourceSets {
    main {
      jniLibs.srcDirs = ['libs']
    }
  }
}

Proguard를 사용하는 경우 Proguard 구성에 다음을 추가합니다.

# For communication with AdColony's WebView
-keepclassmembers class * { 
    @android.webkit.JavascriptInterface <methods>; 
}

# Keep ADCNative class members unobfuscated
-keepclassmembers class com.adcolony.sdk.ADCNative** {
    *;
 }

참고 : 애드 콜로니 안드로이드 설정에 대한 자세한 내용은 애드 콜로니 안드로이드 프로젝트 설정을참조하십시오.

GDPR

유럽 연합의 GDPR(일반 데이터 보호 규정)을 준수하여 사용자로부터 동의를 수집하는 경우 아래에 설명된 API를 사용하여 AdColony 및 모든 다운스트림 소비자에게 이 정보를 알릴 수 있습니다. 자세한 내용은 GDPR 자주 묻는 질문(FAQ)을 참조하십시오.

앱 옵션을 통한 동의 전달

AdColony SDK Unity 플러그인 v3.3.4에서는 GDPR 준수를 위한 AppOptions API에 명시적 메서드를 추가했습니다. 이러한 옵션의 조합을 사용할 수 있습니다. GDPR 동의 문자열에 "1" 또는 "0"의 값이 있어야 합니다. "1"의 가치는 사용자가 개인 정보를 저장하고 처리하는 데 동의한 것을 의미하며, "0"의 값은 사용자가 동의를 거부되었음을 의미합니다.

예제 코드

AdColony.AppOptions options = new AdColony.AppOptions();

// Indicates the GDPR requirement of the user. 
// If it's true, the user's subject to the GDPR laws. 
// If you set it to false, the value of consent string will be ignored.
options.GdprRequired = true; 

// Your user's consent string. 
// In this case, the user has given consent to store and process personal information.
options.GdprConsentString = "1"; 

AdColony.Ads.Configure(APP_ID, appOptions, ZONE_IDS);

법적 요구 사항

AdColony SDK를 다운로드하면 평가 목적으로만 SDK를 사용하고 검토할 수 있는 제한된 비상업적 라이선스가 부여됩니다. SDK를 모든 상용 애플리케이션에 통합하려면 AdColony에 계정을 등록하고 AdColony 웹 사이트의 이용 약관에 동의해야 합니다.

미국에 본사를 둔 기업은 W-9 양식을 작성하고 이전에 당사에 보내야 합니다. 퍼블리셔 지급이 발행될 수 있습니다.

문의하기

자세한 내용은 AdColony.com 방문하십시오. 질문이나 도움이 필요하면 support@adcolony.com 이메일로 보내주십시오.

라이센스

AdColony SDK 유니티 플러그인은 아파치 2.0 라이센스에서 사용할 수 있습니다. 자세한 내용은 라이센스 파일을 참조하십시오.

 

시애틀과 달라스의 ❤️ 제작
애드콜로니 로고

마지막 업데이트에 의해멜리사 화이트