Mobile App Instance サービス

  • [アーティクル]

この 読み取り専用 サービスは、アプリ "インスタンス" を取得するために使用されます。 このサービスの呼び出しによって取得される各オブジェクトは、Mobile App Serviceで説明されているアプリの "インスタンス" です。 アプリ インスタンスは、 Mobile App Instance List Service を使用して作成できます。

プロファイル サービスを対象とするキャンペーンに対して、モバイル アプリ インスタンスを追加または削除できます。 以下の 「例」セクションを 参照してください。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/mobile-app-instance?id=8 モバイル アプリの特定のインスタンスを取得する
GET https://api.appnexus.com/mobile-app-instance システム内のすべてのモバイル アプリ インスタンスを表示する

JSON フィールド

名前 型 説明
instance-bundle オブジェクトの配列 アプリのこの特定のインスタンスに関連付けられている識別情報。 詳細については、以下の 「インスタンス バンドル」を 参照してください。
id int このアプリ インスタンスの ID。
mobile_app_store_id int このインスタンスは、モバイル アプリ ストアで使用できます。 詳細については、「Mobile App Store Service」を参照してください。
store.name string アプリのこのインスタンスを使用できるモバイル アプリ ストアの名前。
store.url string アプリのこのインスタンスが見つかるアプリ ストア URL。
mobile_app_store multi_object アプリのこのインスタンスは、モバイル アプリ ストアにあります。
last_modified date このアプリ インスタンスがシステムで最後に更新されたとき。
created_on date このアプリ インスタンスがシステムで作成されたとき。

インスタンス バンドル

名前 型 説明
bundle_id string このアプリに関連付けられているバンドル ID。
os_family_id int このアプリに関連付けられているオペレーティング システム ファミリ ID。 詳細については、「 オペレーティング システム ファミリ サービス」を参照してください。
last_modified date このインスタンスのバンドルがシステムで最後に更新されたとき。
created_on date このインスタンスのバンドルがシステムで作成されたとき。

例

既存のモバイル アプリ インスタンスを取得する

既存のモバイル アプリ インスタンスは、次の呼び出しで GET 表示できます。

$ curl -b cookies 'https://api.appnexus.com/mobile-app-instance?id=108
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "mobile-app-instance": {
            "id": 108,
            "last_modified": "2014-01-16 17:08:50",
            "created_on": "2014-01-16 17:08:50",
            "mobile_app_store": "",
            "instance-bundle": [
                {
                    "bundle_id": "3223423",
                    "os_family_id": 3,
                    "instance_priority_id": 1,
                    "last_modified": "2014-01-23 20:42:57",
                    "created_on": "2014-01-16 17:07:24"
                }
            ]
        }
    }
}

キャンペーンのターゲット プロファイルにモバイル アプリ インスタンスを追加する

$ cat profile-update.json
 
{
    "profile": {
        "mobile_app_instance_action_include": true,
        "mobile_app_instance_targets": [
            {
                "id": 56
            }
        ]
    }
}
 
$ curl -b cookies -X PUT -d @profile-update.json 'https://api.appnexus.com/profile?id=140537'
 
{
    "response":{
         "profile":{
             "mobile_app_instance_targets":[
                {
                    "deleted":false,
                     "os_family_id":2,
                     "bundle_id":"dsad.com.com",
                     "id":56
                }
            ],
             ...SNIP...
        },
         "num_elements":100,
         "start_element":0,
         "id":"140537",
         "count":1,
         "status":"OK"
    }
}