Partager via


Service d’instance d’application mobile

Ce service en lecture seule est utilisé pour récupérer des « instances » d’application. Chaque objet récupéré par un appel à ce service est un « instance » d’une application décrite dans mobile App Service. Les instances d’application peuvent être créées via le service de liste des instances d’application mobile.

Vous pouvez ajouter ou supprimer des instances d’application mobile de votre campagne ciblant le service de profil. Consultez la section Exemples ci-dessous.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/mobile-app-instance?id=8 Récupérer un instance spécifique d’une application mobile
GET https://api.appnexus.com/mobile-app-instance Afficher toutes les instances d’application mobile dans notre système

Champs JSON

Nom Type Description
instance-bundle tableau d’objets Informations d’identification associées à cette instance particulière d’une application. Pour plus d’informations, consultez l’offre groupée d’instances ci-dessous.
id int ID de cette application instance.
mobile_app_store_id int Le magasin d’applications mobiles dans lequel cette instance est disponible. Pour plus d’informations, consultez Mobile App Store Service.
store.name string Nom du magasin d’applications mobiles dans lequel cette instance de l’application est disponible.
store.url string URL de l’App Store où se trouve cette instance de l’application.
mobile_app_store multi_object Le magasin d’applications mobiles dans lequel se trouve cette instance de l’application.
last_modified date Lorsque cette application instance a été mise à jour pour la dernière fois dans notre système.
created_on date Lorsque cette application instance a été créée dans notre système.

Groupe d’instances

Nom Type Description
bundle_id string ID d’offre groupée associé à cette application.
os_family_id int ID de famille de système d’exploitation associé à cette application. Pour plus d’informations, consultez le service famille de systèmes d’exploitation.
last_modified date Lors de la dernière mise à jour du bundle de ce instance dans notre système.
created_on date Lorsque cette instance a été créée dans notre système.

Exemples

Obtenir une instance d’application mobile existante

Vous pouvez afficher une application mobile existante instance avec un GET appel :

$ 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"
                }
            ]
        }
    }
}

Ajouter une application mobile instance à votre profil de ciblage de campagne

$ 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"
    }
}