コンテンツにスキップ
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を初期化

SDKの初期化構成を作成する

SDKを初期化する前に、SDKの初期化構成オブジェクトを作成します。 このオブジェクトを使用すると、SDKを初期化するプロパティを設定できます。 この初期化プロパティは変更不可ですが、例外としてAppLovinSdkSettingsには、アプリのライフタイムにおいて変更可能なプロパティが含まれます。

// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
                 .setMediationProvider( AppLovinMediationProvider.MAX )
// Perform any additional configuration/setting changes
                 .build();

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

MAX SDKを初期化

初期化構成オブジェクトを使用して、AppLovin SDKを初期化します。例えば、ローンチアクティビティまたはアプリケーションクラスのonCreate()内で、できるだけ早く初期化するようにしてください。 これにより、SDKがメディエーションネットワークの広告をキャッシュするまでの時間が最大化され、ユーザー体験の向上につながります。

public class MainActivity extends Activity
{
  protected void onCreate(Bundle savedInstanceState)
  {
    // Create the initialization configuration
    AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
                     .setMediationProvider( AppLovinMediationProvider.MAX )
                     .build();


    // Initialize the SDK with the configuration
    AppLovinSdk.getInstance( this ).initialize( initConfig, new AppLovinSdk.SdkInitializationListener()
    {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration sdkConfig)
      {
        // Start loading ads
      }
    } );
  }
}

例

以下は実装の例です。

// Create the initialization configuration
AppLovinSdkInitializationConfiguration initConfig = AppLovinSdkInitializationConfiguration.builder( "«SDK-key»", this )
    .setMediationProvider( AppLovinMediationProvider.MAX )
    .setSegmentCollection( MaxSegmentCollection.builder()
                             .addSegment( new MaxSegment( 849, Arrays.asList( 1, 3 ) ) )
                             .build() )
    .build();


// Configure the SDK settings if needed before or after SDK initialization.
val settings = AppLovinSdk.getInstance( this ).getSettings();
settings.setUserIdentifier( "«user-ID»" );
settings.setExtraParameter( "uid2_token", "«token-value»" );
settings.getTermsAndPrivacyPolicyFlowSettings().setEnabled( true );
settings.getTermsAndPrivacyPolicyFlowSettings().setPrivacyPolicyUri( Uri.parse( "«https://your-company-name.com/privacy-policy»" ) );
settings.getTermsAndPrivacyPolicyFlowSettings().setTermsOfServiceUri( Uri.parse( "«https://your-company-name.com/terms-of-service»" ) );


// Initialize the SDK with the configuration
AppLovinSdk.getInstance( this ).initialize( initConfig, new AppLovinSdk.SdkInitializationListener()
{
  @Override
  public void onSdkInitialized(final AppLovinSdkConfiguration sdkConfig)
  {
    // 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設定