Ad Quality SDK 연동하기

Ad Quality SDK로 앱에서 Ad Quality를 실행할 수 있습니다. Ad Quality SDK는 사용 중인 광고 네트워크 SDK들로부터 광고 이벤트 및 필요 어트리뷰션 정보들을 자동으로 수집합니다. 이 방법으로 Ad Quality SDK를 최소한의 코딩으로 간편하게 연동할 수 있습니다.

중요합니다! Ad Quality SDK 연동 전에 반드시 적어도 한 개 이상의 앱이 아이언소스 계정에 등록되었는지 확인해 주세요.

레벨플레이를 사용하는 퍼블리셔들은 단 한 줄의 코드만을 추가하면 Ad Quality SDK를 미디에이션과 함께 연동 및 업데이트 할 수 있습니다. 여기에 있는 문서를 참고하세요.

1단계: Ad Quality SDK를 앱에 불러오기

이 다운로드 링크링크를 사용해 Unity3D 패키지를 프로젝트에 추가하세요:
반드시 Unity3D 프로젝트가 열려 있는 상태에서 Unity3D 패키지를 불러와야 합니다.
압축해제된 파일을 더블클릭합니다. 변경된 파일들은 아래와 같이 자동으로 교체/생성됩니다:
이동: Assets → External Dependency Manager → Android Resolver → Resolve

Important! 안드로이드 연동 시에는 반드시 “Resolve” 과정을 완료해야 합니다.
이 과정에서 모든 선택된 패키지 및 관련 필수 패키지들이 다운로드 됩니다.

이동: Assets → External Dependency Manager → Android Resolver → Resolve

2단계: SDK 초기화 하기

유니티 레벨플레이 플랫폼에서 발급받은 아이언소스 앱 키로 Ad Quality SDK를 초기화하세요.
아래의 코드를 앱의 메인 스레드 또는 다른 광고 네트워크 SDK들의 스레드 상에 추가하여 Ad Quality SDK를 초기화합니다:

아래의 코드를 첫번째 Scene의 Awake 메서드에 추가해 주세요:

void Awake ()
{
   // Initialize
   IronSourceAdQuality.Initialize(appKey);
}

3단계 (선택사항): 고급 SDK 초기화

Note: 레벨플레이를 사용 중일 경우 아래 기능들을 사용하려면 반드시 Ad Quality를 먼저 초기화 해야 합니다.

연동 설정을 커스터마이즈하여 아래의 특수 구성으로 더 많은 기능을 사용할 수 있습니다:

User ID – Ad Quality에서 제공되는 기본 ID 대신 직접 정의한 사용자 ID를 사용합니다
Test mode – Ad Quality SDK 연동사항을 테스트합니다. (기본값은 false 입니다)
Log level – 코드 이슈 디버그를 위한 로그 수준을 선택합니다 (기본값은 INFO 입니다)

아래의 코드를 사용해 빌더로 Ad Quality 설정 구성 오브젝트를 생성하세요.

아래의 코드를 첫번째 Scene의 Awake 메서드에 추가하세요:

ISAdQualityConfig adQualityConfig = new ISAdQualityConfig();

사용자 ID 설정

Ad Quality SDK는 사용자 ID 설정에 2 가지 옵션을 제공합니다:

1.직접 정의한 사용자 ID를 사용하고, 이를 SDK 초기화 이전 또는 도중에 등록합니다.

adQualityConfig.UserId = userId;
// The default user id is Ad Quality internal id.
// The only allowed characters for user id are: letters, numbers, @, -, :, =,_ and /.
// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.

2. 초기화 이후 시점에 직접 정의하는 사용자 ID가 결정되는 경우, Ad Quality SDK 초기화 이후 기본 사용자 ID를 변경합니다.

IronSourceAdQuality.ChangeUserId(userId);
// The default user id is Ad Quality internal id. 
// The only allowed characters for user id are: letters, numbers, @, -, :, =,_ and /. 
// The user id cannot be null and must be between 2 and 100 characters, otherwise it will be blocked.

테스트 모드 설정

adQualityConfig.TestMode = true;
// The default is false - set to true only to test your Ad Quality integration

로그 수준 설정

adQualityConfig.LogLevel = ISAdQualityLogLevel.INFO;
// There are 5 different log levels:
// ERROR, WARNING, INFO, DEBUG, VERBOSE
// The default is INFO
IronSourceAdQuality.Initialize(appKey, adQualityConfig);

4 단계 (선택사항): SDK 콜백 이벤트 설정

Note: 레벨플레이를 사용하는 경우 아래 기능을 사용하려면 반드시 Ad Quality SDK가 레벨플레이보다 먼저 초기화 되어야 합니다.

Unity3d 콜백들은 별도 클래스로, Ad Quality SDK가 초기화된 지점에서 구현되어야 합니다.

public class AdQualitySdkInit: ISAdQualityInitCallback {

   public void adQualitySdkInitSuccess() {
       Debug.Log("unity: adQualitySdkInitSuccess");
   }
   public void adQualitySdkInitFailed(ISAdQualityInitError adQualitySdkInitError, string errorMessage) {
       Debug.Log("unity: adQualitySdkInitFailed " + adQualitySdkInitError + " message: " + errorMessage);
   }
}

AdQualitySdkInit adQualitySdkInit = new AdQualitySdkInit();
ISAdQualityConfig adQualityConfig = new ISAdQualityConfig {
   AdQualityInitCallback = adQualitySdkInit
};

IronSourceAdQuality.Initialize(appKey, adQualityConfig);

Note: Ad Quality SDK 초기화에 걸리는 시간은 앱에 연동된 광고 네트워크 SDK 수에 따라 늘어납니다. 네트워크 연결 문제도 초기화 지연의 원인이 될 수 있습니다. 평균적으로, 초기화에는 대략 3~4초 정도가 소요됩니다.

5 단계 (선택사항): Ad Quality SDK로 광고 수익 측정데이터 보고

Note: 레벨플레이 사용 시 아래 기능을 사용하려면 반드시 Ad Quality SDK를 먼저 초기화 해야 합니다.

Note: 해당 기능은 전체 화면 광고에 대해서만 지원됩니다. 레벨플레이, MAX, DT 페어비드 미디에이션에서는 이 데이터들은 자동으로 수집됩니다.

Ad Quality SDK 7.2.0 이상 버전에서는 광고 수익 측정 보고 기능을 지원합니다:

Ad Quality SDK에 광고 수익 측정 데이터를 전송하려면, SDK 연동 코드에 아래의 구문을 추가해 주세요.

Important! sendCustomMediationRevenue 메서드는 반드시 광고기 표시될 때 호출되어야 하며, 광고가 표시되지 않을 때에는 호출해도 아무 효과가 없습니다.

ISAdQualityCustomMediationRevenue customMediationRevenue = new ISAdQualityCustomMediationRevenue();
customMediationRevenue.MediationNetwork = ISAdQualityMediationNetwork.SELF_MEDIATED;
customMediationRevenue.AdType = ISAdQualityAdType.REWARDED_VIDEO;
customMediationRevenue.Revenue = 1.2;
IronSourceAdQuality.SendCustomMediationRevenue(customMediationRevenue);

AdMob 미디에이션을 사용하는 경우, 아래의 단계를 따라 설정해 주세요:

AdMob 계정 관리 담당자에게 AdMob 노출 수준 광고 수익 활성화 (iLTV)를 요청해 주세요.
안드로이드 또는 iOS 의 경우 GMA SDK 버전이 8.12.0 이상인지, 그리고 iLTV를 지원하는 버전인지를 확인해 주세요.
아래의 코드 구문을 Ad Quality SDK 연동 코드에 추가합니다:

RewardedAd rewardedAd;
public void HandleRewardedAdLoaded(object sender, EventArgs args)
{
    this.rewardedAd = args.rewardedAd;
}
private void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
   AdValue impressionData = args.AdValue;
   ISAdQualityCustomMediationRevenue customMediationRevenue = new ISAdQualityCustomMediationRevenue();
   customMediationRevenue.MediationNetwork = ISAdQualityMediationNetwork.ADMOB;
   customMediationRevenue.AdType = ISAdQualityAdType.REWARDED_VIDEO;
   customMediationRevenue.Revenue = impressionData.Value/1000000f;
   IronSourceAdQuality.SendCustomMediationRevenue(customMediationRevenue);
}