mixi Developer Center (ミクシィ デベロッパーセンター)

mixiアプリ

mixiアプリ » 技術仕様(新方式) » mixi API SDK for Android™ » mixiアドプログラムAPI

mixiアドプログラムAPI

mixiアドプログラムAPI

mixiアドプログラムAndroidアプリ版のAPIを利用することで、mixiアドプログラムをAndroidアプリ版mixiアプリに組み込むこと ができます。ここでは、mixiアプリにどのようにmixiアドプログラムAndroidアプリ版の機能を実装するかを説明いたします。

表示イメージ

mixiアドプログラムAndroidアプリ版の機能を実装すると、アプリ上では以下の「mixiアドプログラム専用枠」が表示されます。
※現在は下記のような弊社指定の固定画像が常に表示されますが、mixiアドプログラムのお支払い対象となります。

ad_image.png

専用枠サイズ: 横幅100%×縦37px(縦表示、横表示の場合とも)

専用枠には上記の図の1~3の場所に、リンクが設置されます。なお表示位置と表示内容は変更することができません。

制限事項

mixiアドプログラムAndroidアプリ版APIは、どなたでもご利用になれます。なお、お支払い対象となるのはmixiにAndroidアプリ版mixiアプリのお申し込みいただき、弊社が承認したmixiアプリのみとなります。

利用手順

mixiアドプログラムAndroidアプリ版APIは、mixiアプリから規定のAPIを呼び出すだけでなく、いくつか行わなければならない事前設定があります。

事前準備

1.SDKのパッケージに含まれるassets/mixi以下のファイルをmixiアプリのプロジェクトのassets以下にディレクトリごとコピー

assets/mixi/
        header.html
        common.css
        img/
                head_appli001.png
                head_appli002.png
                logo_mixi006.png

この際に、mixi以下のディレクトリ構造を変更しないでください。変更した場合は正常に動作しません。

2.各レイアウトに下記の記述を追加

<LinearLayout
    android:layout_width="fill_parent"
    android:layout_height="wrap_content">
    <include layout="@layout/mixi_ad_header"/>
</LinearLayout>

3.onCreateで下記メソッドを呼ぶ

API呼び出し

各ActivityのonCreateの最後でMixiContainer#setupAd(Activity, AdParameter);を呼ぶ。 (Activity#setContentView及びMixiContainer#initが実行してあること)
下記にサンプルコードを示します。

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        Config c = new Config();
        c.clientId = StartActivity.CLIENT_ID;
        mContainer = MixiContainerFactory.getContainer(c);
        if (!mContainer.init(this)) {
            // エラー処理
        }
        // その他アプリの初期処理
        mContainer.setupAd(this, new AdParameter());
    }

このコードは、mixiアプリの/assetsディレクトリにSDKに同梱されてたmixiディレクトリを配置した場合のコードになります。

他の場所に配置する場合はAdParameter#headerPathを正しく設定してください。

AdParameterについて

現在のところパラメータとして下記のものが設定できます。

パラメータ名 内容
String headerPath ヘッダ部分に表示するファイルのパス
(通常は設定する必要はありません)

実装後の申請

アプリへの実装が完了した後、apkファイルをメールに添付し、下記の通りお送り下さい。

宛先 contact-mixiapps@mixi.jp
件名 【ネイティブアプリ版mAPテスト実行ファイル申請】アプリ名/SAP名
内容 アップロード予定のapkファイル
(もしメール上のファイルサイズが添付ファイルを含めて10MBを越える場合は、ダウンロード先・方法を指定してください)

ファイルを送付後、下記のページからmixiアドプログラムAndroidアプリ版にお申し込みください。

http://developer.mixi.co.jp/appli/policies/map/guidelines/

このページの上部へ