アドネットワークのSDKと連携する際の注意事項及び共通手順

バナー広告、インタースティシャル広告、ネイティブ広告の実装において、提携しているアドネットワークが提供するネイティブアプリ向けSDKと連携する際の注意事項および共通手順となります。

iOS​

1. rootViewControllerの設定

「広告タップ時のアプリ内ブラウザ起動」「動画のインビュー判定」のため、最前面にあるUIViewControllerをinit時にセットしてください。

adg = ADGManagerViewController(locationID: "48547", adType: .adType_Sp, rootViewController: self)

self.adg = [[ADGManagerViewController alloc] initWithLocationID:@"48547"
                                                        adType:kADG_AdType_Sp
                                            rootViewController:self];

2. 失敗時の再リクエスト

広告のロードに失敗した場合は再リクエストや非表示等の処理を必ず実装し、在庫切れエラー時の再リクエストが行われることをご確認ください。

func adgManagerViewControllerFailed(toReceiveAd adgManagerViewController: ADGManagerViewController, code: kADGErrorCode) {
    print("Failed to receive an ad.")
    // エラー時のリトライは特段の理由がない限り必ず記述するようにしてください。
    switch code {
    case .adgErrorCodeNeedConnection, // ネットワーク不通
        .adgErrorCodeExceedLimit, // エラー多発
        .adgErrorCodeNoAd: // 広告レスポンスなし
        break
    default:
        adgManagerViewController.loadRequest()
    }
}

- (void)ADGManagerViewControllerFailedToReceiveAd:(ADGManagerViewController *)adgManagerViewController
                                             code:(kADGErrorCode)code {
    printf("Failed to receive an ad.")
    // エラー時のリトライは特段の理由がない限り必ず記述するようにしてください。
    switch (code) {
        case kADGErrorCodeNeedConnection: // ネットワーク不通
        case kADGErrorCodeExceedLimit:  // エラー多発
        case kADGErrorCodeNoAd: // 広告レスポンスなし
            break;
        default:
            [adgManagerViewController loadRequest];
            break;
    }
}

Android

1. 失敗時の再リクエスト

広告のロードに失敗した場合は再リクエストや非表示等の処理を必ず実装し、在庫切れエラー時の再リクエストが行われることをご確認ください。

override fun onFailedToReceiveAd(code: ADGConsts.ADGErrorCode) {
    Log.d(TAG, "Failed to receive an ad:$code")
    when (code) {
        // エラー時のリトライは特段の理由がない限り必ず記述するようにしてください。
        ADGConsts.ADGErrorCode.EXCEED_LIMIT, ADGConsts.ADGErrorCode.NEED_CONNECTION, ADGConsts.ADGErrorCode.NO_AD -> {}
        else -> adgInterstitial?.preload()
    }
}

class AdListener extends ADGListener {
    @Override
    public void onFailedToReceiveAd(ADGErrorCode code) {
        Log.d(TAG, "Failed to receive an ad:$code");
        // エラー時のリトライは特段の理由がない限り必ず記述するようにしてください。
        switch (code) {
        case EXCEED_LIMIT:
        case NEED_CONNECTION:
        case NO_AD:
            break;
        default:
            if (adg != null) {
                adg.start();
            }
            break;
        }
    }
}

Unity

1. 失敗時の再リクエスト

広告のロードに失敗した場合は再リクエストや非表示等の処理を必ず実装し、在庫切れエラー時の再リクエストが行われることをご確認ください。

public void ADGFailedToReceiveAd(string msg){
  if (ADGUnitySDK.canCallADG ()) {
    // バナー広告の場合
    ADGUnitySDK.loadADG ();

    // インタースティシャル広告の場合
    // ADGUnitySDK.loadInterADG ();
  }
}

Ad Generation SDKでのメディエーションに関するサポート状況

iOS

連携先	サポートVer	メディエーション先のリリースノート	追加するアダプター	実装マニュアル	下限OSVer	備考
LAP	20230609	● (opens new window)	● (opens new window)	●	iOS11.0+	リリースノート閲覧は要ログイン
Amazon Publisher Services(APS)	4.5.6	● (opens new window)	無し	●	iOS12.0+	リリースノート閲覧は要ログイン
AdMob	10.12.0	● (opens new window)	● (opens new window)	●	iOS11.0+	Ad GenerationからAdMobを呼び出す連携です
AdMobメディエーション	10.12.0	● (opens new window)	● (opens new window)	●	iOS11.0+	AdMobからAd Generationを呼び出す連携です
UnityAds	4.9.1	● (opens new window)	● (opens new window)	●	iOS11.0+
maio	1.6.3	● (opens new window)	● (opens new window)	●	iOS11.0+
Pangle	5.5.0.5	● (opens new window)	● (opens new window)	●	iOS12.0+	リリースノート閲覧は要ログイン

Android

連携先	サポートVer	メディエーション先のリリースノート	追加するアダプター	実装マニュアル	下限OSVer	備考
LAP	20230215	● (opens new window)	● (opens new window)	●	Android5.0+	リリースノート閲覧は要ログイン
Amazon Publisher Services(APS)	9.6.2	● (opens new window)	無し	●	Android5.0+	リリースノート閲覧は要ログイン
AdMob	21.5.0	● (opens new window)	● (opens new window)	●	Android5.0+	Ad GenerationからAdMobを呼び出す連携です
AdMobメディエーション	21.5.0	● (opens new window)	● (opens new window)	●	Android5.0+	AdMobからAd Generationを呼び出す連携です
UnityAds	4.6.1	● (opens new window)	● (opens new window)	●	Android5.0+
maio	1.1.16	● (opens new window)	● (opens new window)	●	Android5.0+
Pangle	5.1.0.6	● (opens new window)	● (opens new window)	●	Android5.0+	リリースノート閲覧は要ログイン

注意事項

• 対応のOSバージョンはアドネットワーク毎に異なります。
• 連携SDKは弊社から配布しているもの、または、実装マニュアルにて案内しているサポートバージョンをご使用ください。連携バージョンが異なると意図しないエラー発生の可能性があります。
• 連携先によっては在庫切れが多いものもございます。
• 連携先SDKを参照から外した状態で動作させるとエラーを起こすことが可能です。
• 動画SDKの場合、ローテーション時間は動画の再生完了を基準とします。
• 連携SDKのアドネットワークのローテーション設定をOFFにしてください。
• 連携SDKでの実装後、広告の表示確認および、連携先の広告レポート数値などが正常であることをご確認いただいた上でアプリのリリースをお願いいたします。