Android SDK の統合手順

2024-02-26

このページでは、SDK をプロジェクトと統合する方法について説明します。

さまざまな広告の種類を表示する手順については、次を参照してください。

このセクションの手順に従って、アプリに広告を表示するように SDK を設定します。

要件

この SDK には、Android 4 以降と Android SDK バージョン 14 以降が必要です。

広告を表示するには、有効な Xandr 配置 ID が必要です。これは、広告を表示できるアプリケーションのコンテキストを表す数値 ID です。

ヒント

Google Play

フリークエンシーキャップとモバイルアプリのターゲット設定に Android Advertising ID (AAID) を有効にするには、アプリの依存関係として Google Play Services を含める必要があります。 Xandr の SDK は引き続き Google Play Services なしで機能しますが、これらの機能にはアクセスできません。
Android Studio と Gradle

次の手順では、Android Studio と Gradle を使用していることを前提としています。必要な AndroidManifest.xml エントリ (場所のアクセス許可を除く) と ProGuard の変更のほとんどは、アプリに自動的に追加されます。他のビルドシステムを使用している場合、手順が異なる場合があります。

インストール

手順 1. SDK を取得する

次に示すように、ファイルから Maven 経由でインストールします build.gradle 。 [9,10)この表記は、アプリがコンパイルされると、9.x リリースシリーズの最新バージョンの SDK が含まれることを意味します。新しいバージョンの SDK をリリースするときに、新しいバージョンを取得するために必要なのはアプリの再コンパイルです。に他の SDK build.gradleの仲介アダプターを含める場合は、「Android を使用して他の仲介ネットワークを仲介する」セクションを参照してください。

注:

これらは最上位のブロックであり、ビルドスクリプトブロックの一部ではありません。

警告

コンパイルコマンドは Gradle でサポートされなくなりました。実装コマンドに置き換えられました。

// Android: Gradle config to install the SDK
repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.appnexus.opensdk:appnexus-sdk:[9,10)'
}

手順 2. アプリのアクセス許可を編集する (省略可能)

Android マニフェストを編集して、次の (省略可能ですが推奨される) アクセス許可を含めます。

<!-- Android: XML to include recommended permissions -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

<!-- Add the permissions here... -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

ACCESS_COARSE_LOCATION (推奨) - セルタワーに基づいておおよその場所にアクセスするためのアクセス許可を SDK に付与します。
ACCESS_FINE_LOCATION (推奨) - GPS に基づいてより正確な場所にアクセスするためのアクセス許可を SDK に付与します。

ヒント

場所のアクセス許可は、ユーザーに対して次のプロンプトを表示する必要があります。

API レベル 23 (Marshmallow) 以降では、上記のいずれかの場所のアクセス許可をアプリランタイムでダイアログでユーザーに求める必要があります。 SDK は、ユーザーの同意を得た場所のアクセス許可にのみアクセスできます。

詳細については、Android ドキュメントからのアクセス許可の要求に関するページを参照してください。

技術的には必須ではありませんが、位置情報のアクセス許可により、SDK は位置情報ベースのデータを広告主に送信できます。一般に、位置情報データを送信すると収益化が向上します。

注:

SDK は、場所の更新を要求するために電話を起動することはありません。これは時間とバッテリーがかかるでしょう。代わりに、これらのアクセス許可を使用して、デバイスの最後の既知の場所にアクセスします。

手順 3. ProGuard の設定を編集する

アプリで ProGuard を使用している場合は、アプリから Google Play を削除しないように ProGuard 設定を編集する必要があります。 SDK では Google Play が機能する必要はありませんが、アプリのターゲット設定と周波数制限に使用される Android 広告主 ID (AAID) にアクセスできなくなります。プロジェクトの proguard-project.txt ファイルを編集して、次を追加します。

### Proguard settings to support Android Advertiser ID
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}

手順 4. 仲介の設定 (省略可能)

仲介のセットアップ手順については、「 Android を使用した仲介」を参照してください。

実装に関する注意: ライフサイクルコールバックの転送

SDK を使用すると、と InterstitialAdViewのサブクラスAdViewBannerAdViewのライフサイクルコールバックを転送できます。

パフォーマンスを向上させるには、ライフサイクルコールバックの転送を強くお勧めします。 AdMob/DFP バナーを仲介するすべてのユーザーには、ライフサイクルコールバックを AdMob/DFP バナーに必要に応じて転送する必要があるため、呼び出す必要があります。呼び出すメソッドとタイミングについては、以下のコードサンプルを参照してください。

アクティビティのライフサイクルの詳細については、Android ドキュメントの「アクティビティライフサイクルの管理」を参照してください。

    /**
     * To be called by the developer when the fragment/activity's onDestroy() function is called.
     */
    abstract public void activityOnDestroy();

    /**
     * To be called by the developer when the fragment/activity's onPause() function is called.
     */
    abstract public void activityOnPause();

    /**
     * To be called by the developer when the fragment/activity's onResume() function is called.
     */
    abstract public void activityOnResume();

次の方法で共有