モバイル広告プラットフォームAndroid SDKアクセスガイド
8792 ワード
アプリケーション開発ではアプリケーションの収入を高めるために、一般的なプロジェクトでは広告が導入されていますが、私が開発で使っているのはiFLEモバイル広告プラットフォームのアクセスです.以下では、iFLEモバイル広告プラットフォームがどのようにアクセスを完了したかを紹介します.
1.統合の説明
1.1 appidの申請
にあるhttp://www.voiceads.cn/Webサイトに開発者として登録され、アプリケーションを識別するためのappidが作成されます.
1.2 SDKのインポート
1.最新版SDKのzipパッケージをダウンロードし、libsフォルダの下jarファイルをローカルエンジニアリングlibsサブディレクトリにコピーします.
2.Eclipseユーザーはプロジェクトルートディレクトリを右クリックし、Properties->Java Build Path->Librariesを選択し、Add External JARs...jarへのパスを選択し、OKをクリックするとインポートに成功します.
1.3 Android manifestファイルの構成
AndroidManifest.xmlファイルを開き、次の権限を追加します.
アクセス権
用途
INTERNET
プログラムのネットワーク接続と統計データの送信を許可する権限
ACCESS_NETWORK_STATE
ネットワーク接続状態の検出を適用
READ_PHONE_STATE
携帯電話機器の情報に読み取り専用でアクセスし、取得した情報によってユーザを一意に識別することを許可する
ACCESS_WIFI_STATE
Wi-Fiネットワークステータス情報へのアクセスを許可
WRITE_EXTERNAL_STORAGE
sdカードを書く権限は、広告に使用される画像をキャッシュし、トラフィックを節約し、より良いユーザー体験を得ることができます.
READ_EXTERNAL_STORAGE
sdカードを読む権限、意味はWRITE_と同じですEXTERNAL_STORAGE
ACCESS_ FINE_LOCATION
設備のアップロードデータの位置情報を取得し、統計精度を高める
GET_TASKS
現在のアプリケーションの実行情報の取得
WAKE_LOCK
携帯電話を起こして、広告が正常にダウンロードすることを保証します
meta-data
用途
IFLYTEK_APPKEY_AD
アプリケーションを一意に識別するには、次のサンプルコードのyour_を使用します.appidは、訊飛モバイル広告プラットフォームで申請したアプリケーションappidに置き換えられます.
コードの例
1.4コンポーネントの説明
1.5フラッグ広告の追加
フラッグ広告、すなわちBanner広告は、広告ビューを任意の収容可能な位置に配置することができる(収容された容器または位置はスクリーン内でなければならず、サイズは広告ビュー以上であり、インタフェースの上部または下部に配置することを推奨する).フラッグ広告はローテーション機能を備えており、デフォルトでは15秒に1回ローテーションされます.
アプリケーションの体験効果を向上させるために、開発者は広告を置いたLayoutの背景色や背景画像をカスタマイズすることができます.
1.6スクリーン広告の追加
プラグイン広告は、開発者がインタフェースの通過時に要求し、必要に応じて展示することができる間質的な広告形式である.ユーザーは、スクリーン広告の右上隅のフォーク画像をクリックすることで、広告をキャンセルします.現在、スクリーン広告は横スクリーンモードをサポートしていません.
1.7フルスクリーン広告の追加
フルスクリーン広告は、スクリーン全体をカバーして広告展示を行う広告タイプです.広告展示は一定時間後に展示を終了し、展示時間を設定することができる.
フルスクリーン広告のフルスクリーン表示は、タイトルバーとステータスバーを削除することで実現でき、コードはDemoを参照します.
1.8インタフェースの説明
1.8.1エラーコード
広告リクエストが失敗したエラーの原因を挙げ、onAdFailed(AdError error)で返します.
説明
70200
広告リクエスト成功
70204
リクエストは成功しましたが、広告内容はありません.
70400
無効な広告ビットID
70403
当日広告請求回数上限
70500
サービスエラー
71001
不明なエラー
71002
無効な広告リクエストです.たとえば、リクエストの頻度が速すぎます.
71003
ネットワークエラー
71004
Permission未設定
71005
Appidが空です
71006
無効なAppid
71007
広告ビットIDが空です
71008
広告ページのロードタイムアウト
71009
広告ページロード異常
71010
携帯電話ブラウザなし
1.8.2広告サイズ
IFLYAdSizeはリクエストの広告サイズを表し、widthとheightの2つの属性を有し、単位はdipである.SDKが提供するサイズタイプ:IFLYAdSize.BANNER、IFLYAdSize.INTERTITIAL、IFLYAdSize.FULLSCREENを使用する必要があります.
1.8.3対外インタフェース
(1) public void setAdSize (IFLYAdSizeadSize)
要求する広告のサイズを設定します(広告を最初に要求する前に設定します).
(2) publicvoid setParameter (String key, String value)
広告パラメータの設定は、2.8.4を参照してください.
(3) public void loadAd (IFLYAdListenerlistener)
広告を頼む.
(4) public void showAd ()
展示広告.
1.8.4広告設定可能なパラメータ
パラメータ
説明
適用範囲
APPID
広告アプリケーションID
フラッグ
DEBUG_MODE
デバッグモードを設定するかどうか、デバッグモードでlogを表示するかどうか、デフォルトのデバッグモード
フラッグ
BACK_KEY_ENABLE
携帯電話の後退ボタンをクリックしてスクリーン広告を破棄するかどうか、デフォルトで広告を破棄します
プラグスクリーン
SHOW_TIME_FULLSCREEN
全画面広告の展示時間、範囲5000~10000、デフォルト5000;-1に設定すると、フォーク方式で全画面広告を終了します.
フルスクリーン
DOWNLOAD_ALERT
ダウンロード広告プロンプトボックスをポップアップし、デフォルトではプロンプトボックスを弾かない
フラッグ
使用例:
1.8.5イベントの傍受
広告を追加すると、一部のリスニングイベントを使用して広告の現在のステータスを受信できます.広告リスニングイベントクラスIFLYAdListenerが定義した具体的なイベント関数は次の表の通りです.
イベントのリスニング
イベントの説明
onAdReceive
広告リクエスト成功
onAdFailed
広告リクエストに失敗し、エラーコードと説明を返します.
onAdClick
広告がクリックされます
onAdClose
広告は閉鎖されました
2.混同コード
エンジニアリング混同設定:Apkをパッケージ化または生成するときに混同する場合は、proguard.cfgに次のコードを追加します:-keep class com.iflytek.voiceads.*{*;}
3.よくある質問
1. Q:adUnitIdとは何ですか.
A:adUnitId、すなわち広告ビットIDは、訊飛モバイル広告プラットフォームが各広告ビットに割り当てる唯一の識別子である.
2. Q:広告の依頼先を自分で設定してもいいですか?
A:要求アドレスはSDK内部に封入されており、ユーザーが自分で設定することは許されません.
3. Q:SDKはどのandroidバージョンをサポートしていますか?
A:android 2.3以降のバージョンが必要です.
4. Q広告SDKバージョンの表示方法
A:Version.getVersion()で広告SDKバージョン番号を入手できます.
4.sdk 2.0統合の注意事項
1. AndroidManifest.xmlでは権限声明を書き落とさないでください.2.3を参照してください.
2. AndroidManifest.xmlにDownloadServiceを追加するには、2.4を参照してください.
3. 新しい設定オプションについては、2.8.4を参照してください.
1) 広告をダウンロードする前に、ポップアップダウンロードプロンプトボックスを設定することができます.旗、挿入画面、全画面広告の設定方法は同じです.
例えば、bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT,"true");
2) フルスクリーン広告展示時間設定、有効設定範囲5000~10000と-1.-1に設定すると、フルスクリーン広告の右上隅にあるフォークコントロールをクリックして広告を終了します.
例えば、fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN,"6000");
1.統合の説明
1.1 appidの申請
にあるhttp://www.voiceads.cn/Webサイトに開発者として登録され、アプリケーションを識別するためのappidが作成されます.
1.2 SDKのインポート
1.最新版SDKのzipパッケージをダウンロードし、libsフォルダの下jarファイルをローカルエンジニアリングlibsサブディレクトリにコピーします.
2.Eclipseユーザーはプロジェクトルートディレクトリを右クリックし、Properties->Java Build Path->Librariesを選択し、Add External JARs...jarへのパスを選択し、OKをクリックするとインポートに成功します.
1.3 Android manifestファイルの構成
AndroidManifest.xmlファイルを開き、次の権限を追加します.
アクセス権
用途
INTERNET
プログラムのネットワーク接続と統計データの送信を許可する権限
ACCESS_NETWORK_STATE
ネットワーク接続状態の検出を適用
READ_PHONE_STATE
携帯電話機器の情報に読み取り専用でアクセスし、取得した情報によってユーザを一意に識別することを許可する
ACCESS_WIFI_STATE
Wi-Fiネットワークステータス情報へのアクセスを許可
WRITE_EXTERNAL_STORAGE
sdカードを書く権限は、広告に使用される画像をキャッシュし、トラフィックを節約し、より良いユーザー体験を得ることができます.
READ_EXTERNAL_STORAGE
sdカードを読む権限、意味はWRITE_と同じですEXTERNAL_STORAGE
ACCESS_ FINE_LOCATION
設備のアップロードデータの位置情報を取得し、統計精度を高める
GET_TASKS
現在のアプリケーションの実行情報の取得
WAKE_LOCK
携帯電話を起こして、広告が正常にダウンロードすることを保証します
meta-data
用途
IFLYTEK_APPKEY_AD
アプリケーションを一意に識別するには、次のサンプルコードのyour_を使用します.appidは、訊飛モバイル広告プラットフォームで申請したアプリケーションappidに置き換えられます.
コードの例
1.4コンポーネントの説明
1.5フラッグ広告の追加
フラッグ広告、すなわちBanner広告は、広告ビューを任意の収容可能な位置に配置することができる(収容された容器または位置はスクリーン内でなければならず、サイズは広告ビュー以上であり、インタフェースの上部または下部に配置することを推奨する).フラッグ広告はローテーション機能を備えており、デフォルトでは15秒に1回ローテーションされます.
アプリケーションの体験効果を向上させるために、開発者は広告を置いたLayoutの背景色や背景画像をカスタマイズすることができます.
// :adId: (http://www.voiceads.cn/) ID
IFLYBannerAd bannerAd = IFLYBannerAd.createBannerAd(Activity.this, adId);
//
bannerAd.setAdSize(IFLYAdSize.BANNER);
//
bannerAd.setParameter(AdKeys.DEBUG_MODE, "true");
// ,
bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT, "true");
// ,
bannerAd.loadAd(mAdListener);
LinearLayout layout_ads = (LinearLayout)findViewById(R.id.layout_adview);
layout_ads.removeAllViews();
layout_ads.addView(bannerAd);
IFLYAdListener mAdListener = new IFLYAdListener(){
@Override
public void onAdReceive() {
// , 。 :
bannerAd.showAd();
}
@Override
public void onAdFailed(AdError error) {
//
// error.getErrorCode(): , error.getErrorDescription():
}
@Override
public void onAdClick() {
//
}
@Override
public void onAdClose() {
//
}
};
1.6スクリーン広告の追加
プラグイン広告は、開発者がインタフェースの通過時に要求し、必要に応じて展示することができる間質的な広告形式である.ユーザーは、スクリーン広告の右上隅のフォーク画像をクリックすることで、広告をキャンセルします.現在、スクリーン広告は横スクリーンモードをサポートしていません.
// :adId: (http://www.voiceads.cn/) ID
IFLYInterstitialAd interstitialAd = IFLYInterstitialAd.createInterstitialAd(Activity.this, adId);
//
interstitialAd.setAdSize(IFLYAdSize.INTERSTITIAL);
// , :"true": ,"false": ,
interstitialAd.setParameter(AdKeys.BACK_KEY_ENABLE, "true");
// ,
interstitialAd.loadAd(mAdListener);
IFLYAdListener mAdListener = new IFLYAdListener(){
@Override
public void onAdReceive() {
// , 。 :
interstitialAd.showAd();
}
@Override
public void onAdFailed(AdError error) {
//
// error.getErrorCode(): ,error.getErrorDescription():
}
@Override
public void onAdClick() {
//
}
@Override
public void onAdClose() {
//
}
};
1.7フルスクリーン広告の追加
フルスクリーン広告は、スクリーン全体をカバーして広告展示を行う広告タイプです.広告展示は一定時間後に展示を終了し、展示時間を設定することができる.
フルスクリーン広告のフルスクリーン表示は、タイトルバーとステータスバーを削除することで実現でき、コードはDemoを参照します.
// :adId: (http://www.voiceads.cn/) ID
IFLYFullScreenAd fullScreenAd = IFLYFullScreenAd.createFullScreenAd(Activity.this, adId);
//
fullScreenAd.setAdSize(IFLYAdSize.FULLSCREEN);
// , ms。 5000ms
fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN, "6000");
// ,
fullScreenAd.loadAd(mAdListener);
IFLYAdListener mAdListener = new IFLYAdListener(){
@Override
public void onAdReceive() {
// , 。 :
fullScreenAd.showAd();
}
@Override
public void onAdFailed(AdError error) {
//
// error.getErrorCode(): ,error.getErrorDescription():
}
@Override
public void onAdClick() {
//
}
@Override
public void onAdClose() {
//
1.8インタフェースの説明
1.8.1エラーコード
広告リクエストが失敗したエラーの原因を挙げ、onAdFailed(AdError error)で返します.
説明
70200
広告リクエスト成功
70204
リクエストは成功しましたが、広告内容はありません.
70400
無効な広告ビットID
70403
当日広告請求回数上限
70500
サービスエラー
71001
不明なエラー
71002
無効な広告リクエストです.たとえば、リクエストの頻度が速すぎます.
71003
ネットワークエラー
71004
Permission未設定
71005
Appidが空です
71006
無効なAppid
71007
広告ビットIDが空です
71008
広告ページのロードタイムアウト
71009
広告ページロード異常
71010
携帯電話ブラウザなし
1.8.2広告サイズ
IFLYAdSizeはリクエストの広告サイズを表し、widthとheightの2つの属性を有し、単位はdipである.SDKが提供するサイズタイプ:IFLYAdSize.BANNER、IFLYAdSize.INTERTITIAL、IFLYAdSize.FULLSCREENを使用する必要があります.
1.8.3対外インタフェース
(1) public void setAdSize (IFLYAdSizeadSize)
要求する広告のサイズを設定します(広告を最初に要求する前に設定します).
(2) publicvoid setParameter (String key, String value)
広告パラメータの設定は、2.8.4を参照してください.
(3) public void loadAd (IFLYAdListenerlistener)
広告を頼む.
(4) public void showAd ()
展示広告.
1.8.4広告設定可能なパラメータ
パラメータ
説明
適用範囲
APPID
広告アプリケーションID
フラッグ
DEBUG_MODE
デバッグモードを設定するかどうか、デバッグモードでlogを表示するかどうか、デフォルトのデバッグモード
フラッグ
BACK_KEY_ENABLE
携帯電話の後退ボタンをクリックしてスクリーン広告を破棄するかどうか、デフォルトで広告を破棄します
プラグスクリーン
SHOW_TIME_FULLSCREEN
全画面広告の展示時間、範囲5000~10000、デフォルト5000;-1に設定すると、フォーク方式で全画面広告を終了します.
フルスクリーン
DOWNLOAD_ALERT
ダウンロード広告プロンプトボックスをポップアップし、デフォルトではプロンプトボックスを弾かない
フラッグ
使用例:
bannerAd.setParameter(AdKeys.APPID, "544e2c99");
bannerAd.setParameter(AdKeys.DEBUG_MODE, "true");
interstitialAd.setParameter(AdKeys.BACK_KEY_ENABLE, "true");
fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN, "6000");
bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT, "true");
1.8.5イベントの傍受
広告を追加すると、一部のリスニングイベントを使用して広告の現在のステータスを受信できます.広告リスニングイベントクラスIFLYAdListenerが定義した具体的なイベント関数は次の表の通りです.
イベントのリスニング
イベントの説明
onAdReceive
広告リクエスト成功
onAdFailed
広告リクエストに失敗し、エラーコードと説明を返します.
onAdClick
広告がクリックされます
onAdClose
広告は閉鎖されました
2.混同コード
エンジニアリング混同設定:Apkをパッケージ化または生成するときに混同する場合は、proguard.cfgに次のコードを追加します:-keep class com.iflytek.voiceads.*{*;}
3.よくある質問
1. Q:adUnitIdとは何ですか.
A:adUnitId、すなわち広告ビットIDは、訊飛モバイル広告プラットフォームが各広告ビットに割り当てる唯一の識別子である.
2. Q:広告の依頼先を自分で設定してもいいですか?
A:要求アドレスはSDK内部に封入されており、ユーザーが自分で設定することは許されません.
3. Q:SDKはどのandroidバージョンをサポートしていますか?
A:android 2.3以降のバージョンが必要です.
4. Q広告SDKバージョンの表示方法
A:Version.getVersion()で広告SDKバージョン番号を入手できます.
4.sdk 2.0統合の注意事項
1. AndroidManifest.xmlでは権限声明を書き落とさないでください.2.3を参照してください.
2. AndroidManifest.xmlにDownloadServiceを追加するには、2.4を参照してください.
3. 新しい設定オプションについては、2.8.4を参照してください.
1) 広告をダウンロードする前に、ポップアップダウンロードプロンプトボックスを設定することができます.旗、挿入画面、全画面広告の設定方法は同じです.
例えば、bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT,"true");
2) フルスクリーン広告展示時間設定、有効設定範囲5000~10000と-1.-1に設定すると、フルスクリーン広告の右上隅にあるフォークコントロールをクリックして広告を終了します.
例えば、fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN,"6000");