コンテンツにスキップ
Support Center | AppLovin

MAX メディエーションネットワークの手動ダウンロード

リリースアップデートを受け取るには、AppLovin-MAX-SDK-iOS GitHubリポジトリ をサブスクライブしてください。

最新のAndroid SDKのダウンロード

プロジェクトへのSDKの追加

ダウンロードファイルを解凍し、aarファイルをプロジェクトのlibsフォルダにドラッグアンドドロップします。 プロジェクトにlibsフォルダがない場合は、appフォルダ内に作成できます。

Gradle

build.gradleファイルに以下を追加します。

repositories {
  google()
  mavenCentral()
  flatDir {
    dirs 'libs'
  }
  ⋮
}
dependencies {
  implementation 'com.applovin:applovin-sdk:«x.y.z»@aar'
  ⋮
}

SDK Keyを追加

AndroidManifest.xmlのapplicationタグ内に次の行を追加します。

<meta-data android:name="applovin.sdk.key" android:value="«your-SDK-key»"/>

SDK KeyはAppLovinダッシュボードのAccount > General > Keys のセクションにてご確認ください。

Ad Reviewを有効化

MAX Ad Reviewサービスを有効にするには、build.gradleファイルに以下を追加します。

ルートレベルのbuild.gradleファイルへ追加

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

アプリレベルのbuild.gradleファイルへ追加

apply plugin: 'applovin-quality-service'
applovin {
    apiKey "«your-ad-review-key»"
}

Ad Review Keyは、AppLovinダッシュボードのAccount > General > Keys セクションでご確認ください。

MAX SDKを初期化

initializeSdk()メソッドを呼び出してSDKを初期化し、そのメソッドにコンテキストを渡します。 これは、アプリの起動後できるだけ早く、例えば、ローンチActivityのonCreate()メソッドで行います。

public class MainActivity extends Activity
{
  protected void onCreate(Bundle savedInstanceState)
  {
    // Set the mediation provider value to "max" to ensure proper functionality.
    AppLovinSdk.getInstance( this ).setMediationProvider( "max" );
    AppLovinSdk.initializeSdk( this, new AppLovinSdk.SdkInitializationListener() {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration configuration)
      {
        // AppLovin SDK is initialized, start loading ads
      }
    } );
  }
}

インタースティシャル広告

インタースティシャルをロード

インタースティシャル広告をロードするには、広告ユニットでMaxInterstitialAdオブジェクトをインスタンス化し、loadAd()を呼び出します。 MaxAdListenerを実装すると、広告の準備ができた場合や、その他の広告関連イベントが発生した際に通知されるようになります。

public class ExampleActivity extends Activity
        implements MaxAdListener
{
  private MaxInterstitialAd interstitialAd;
  private int retryAttempt;


  void createInterstitialAd()
  {
    interstitialAd = new MaxInterstitialAd( "«ad-unit-ID»", this );
    interstitialAd.setListener( this );


    // Load the first ad
    interstitialAd.loadAd();
  }


  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd)
  {
    // Interstitial ad is ready to be shown. interstitialAd.isReady() will now return 'true'


    // Reset retry attempt
    retryAttempt = 0;
  }


  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error)
  {
    // Interstitial ad failed to load
    // AppLovin recommends that you retry with exponentially higher delays up to a maximum delay (in this case 64 seconds)


    retryAttempt++;
    long delayMillis = TimeUnit.SECONDS.toMillis( (long) Math.pow( 2, Math.min( 6, retryAttempt ) ) );


    new Handler().postDelayed( new Runnable()
    {
      @Override
      public void run()
      {
        interstitialAd.loadAd();
      }
    }, delayMillis );
  }


  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error)
  {
    // Interstitial ad failed to display. AppLovin recommends that you load the next ad
    interstitialAd.loadAd();
  }


  @Override
  public void onAdDisplayed(final MaxAd maxAd) {}


  @Override
  public void onAdClicked(final MaxAd maxAd) {}


  @Override
  public void onAdHidden(final MaxAd maxAd)
  {
    // Interstitial ad is hidden. Pre-load the next ad
    interstitialAd.loadAd();
  }
}

インタースティシャル広告を表示

インタースティシャル広告を表示するには、上記で作成したMaxInterstitialAdオブジェクトでshowAd()を呼び出します。

if ( interstitialAd.isReady() )
{
  interstitialAd.showAd();
}

リワード広告

リワード広告をロード

リワード広告をロードするには、リワード広告ユニットでMaxRewardedAdオブジェクトを取得し、それに対してloadAd()を呼び出します。 MaxRewardedAdListenerを実装すると、広告の準備ができた場合や、その他の広告関連イベントが発生した際に通知されるようになります。

public class ExampleActivity extends Activity
        implements MaxRewardedAdListener
{
  private MaxRewardedAd rewardedAd;
  private int           retryAttempt;


  void createRewardedAd()
  {
    rewardedAd = MaxRewardedAd.getInstance( "«ad-unit-ID»", this );
    rewardedAd.setListener( this );


    rewardedAd.loadAd();
  }


  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd)
  {
    // Rewarded ad is ready to be shown. rewardedAd.isReady() will now return 'true'


    // Reset retry attempt
    retryAttempt = 0;
  }


  @Override
  public void onAdLoadFailed(final String adUnitId, final int errorCode)
  {
    // Rewarded ad failed to load
    // AppLovin recommends that you retry with exponentially higher delays up to a maximum delay (in this case 64 seconds)


    retryAttempt++;
    long delayMillis = TimeUnit.SECONDS.toMillis( (long) Math.pow( 2, Math.min( 6, retryAttempt ) ) );


    new Handler().postDelayed( new Runnable()
    {
      @Override
      public void run()
      {
        rewardedAd.loadAd();
      }
    }, delayMillis );
  }


  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error)
  {
    // Rewarded ad failed to display. AppLovin recommends that you load the next ad
    rewardedAd.loadAd();
  }


  @Override
  public void onAdDisplayed(final MaxAd maxAd) {}


  @Override
  public void onAdClicked(final MaxAd maxAd) {}


  @Override
  public void onAdHidden(final MaxAd maxAd)
  {
    // rewarded ad is hidden. Pre-load the next ad
    rewardedAd.loadAd();
  }


  @Override
  public void onUserRewarded(final MaxAd maxAd, final MaxReward maxReward)
  {
    // Rewarded ad was displayed and user should receive the reward
  }
}

リワード広告を表示

リワード広告を表示するには、上記で作成したMaxRewardedAdオブジェクトでshowAd()を呼び出します。

if ( rewardedAd.isReady() )
{
  rewardedAd.showAd();
}

バナーおよびMREC

プログラムを利用してバナーやMRECをロードおよび表示する

バナー広告やミディアムレクタングル広告（MREC）をロードするには、広告ユニットでMaxAdViewオブジェクトを作成し、loadAd()を呼び出します。 表示するには、MaxAdViewオブジェクトをビュー階層のサブビューとして追加してください。 MaxAdViewAdListenerを実装すると、広告の準備ができた場合や、その他の広告関連イベントが発生した際に通知されるようになります。

public class ExampleActivity extends Activity
        implements MaxAdViewAdListener
{
  private MaxAdView adView;


  void createBannerAd()
  {
    adView = new MaxAdView( "«ad-unit-ID»", this );
    adView.setListener( this );


    // Stretch to the width of the screen for banners to be fully functional
    int width = ViewGroup.LayoutParams.MATCH_PARENT;


    // Banner height on phones and tablets is 50 and 90, respectively
    int heightPx = getResources().getDimensionPixelSize( R.dimen.banner_height );


    adView.setLayoutParams( new FrameLayout.LayoutParams( width, heightPx ) );


    // Set background or background color for banners to be fully functional
    adView.setBackgroundColor( ... );


    ViewGroup rootView = findViewById( android.R.id.content );
    rootView.addView( adView );


    // Load the ad
    adView.loadAd();
  }


  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd) {}


  @Override
  public void onAdLoadFailed(final String adUnitId, final int errorCode) {}


  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error) {}


  @Override
  public void onAdClicked(final MaxAd maxAd) {}


  @Override
  public void onAdExpanded(final MaxAd maxAd) {}


  @Override
  public void onAdCollapsed(final MaxAd maxAd) {}


  @Override
  public void onAdDisplayed(final MaxAd maxAd) { /* use this for impression tracking */ }


  @Override
  public void onAdHidden(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}

レイアウトエディターにバナーまたはMRECを表示する

別の方法として、ビューレイアウトXMLにMAXバナーまたはMRECを追加することもできます。 背景または背景色 (android:background) を設定して、広告が完全に動作することを確認してください。 バナーの場合は、幅 (android:layout_width) を画面の幅まで引き延ばしてください。 MRECの場合は、以下のようにandroid:adFormatを設定します。

<com.applovin.mediation.ads.MaxAdView
  xmlns:maxads="http://schemas.applovin.com/android/1.0"
  maxads:adUnitId="«ad-unit-ID»"
  android:background="@color/banner_background_color"
  android:layout_width="match_parent"
  android:layout_height="@dimen/banner_height" />

res/values/attrs.xmlで、ベースとなるバナーの高さが50dpであることを宣言します。

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <dimen name="banner_height">50dp</dimen>
</resources>

res/values-sw600dp/attrs.xmlで、タブレットのバナーの高さが90dpであることを宣言します。

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <dimen name="banner_height">90dp</dimen>
</resources>

バナーまたはMREC広告を非表示にするには、次を呼び出します。

adView.setVisibility( View.GONE );
adView.stopAutoRefresh();

バナーまたはMREC広告を表示するには、次を呼び出します。

adView.setVisibility( View.VISIBLE );
adView.startAutoRefresh();

メディエーションネットワークの準備

連携するアドネットワークを選択して、表示される手順に従ってください。

MAX メディエーションネットワークの手動ダウンロード
© 2025 AppLovin
ご利用規約 | プライバシー | EULA | DMCA | Cookie設定