Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le service de liste d’instances d’application mobile est utilisé pour définir une liste d’instances d’application mobile que vous pouvez cibler avec des campagnes. Considérez-le comme la version de l’application mobile du service de liste de domaines.
N’oubliez pas qu’une application mobile instance est une représentation concrète de l’abstraction « application mobile ». Par exemple, il y aura plusieurs « instances » d’une application pour chaque plateforme qu’elle cible, comme Android ou iOS. Pour plus d’informations sur cette distinction, consultez mobile App Service.
Ce service a également pour effet secondaire de créer des applications mobiles dans le système si elles n’existent pas déjà. Ces applications peuvent ensuite être consultées à l’aide de mobile App Service.
API REST
| HTTP, méthode | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/mobile-app-instance-list?id=4 |
Afficher une seule liste de instance d’applications mobiles. |
POST |
https://api.appnexus.com/mobile-app-instance-list (application mobile instance liste JSON) |
Ajoutez une liste de instance d’applications mobiles au système. |
GET |
https://api.appnexus.com/mobile-app-instance-list |
Affichez toutes vos listes de instance d’applications mobiles. |
GET |
https://api.appnexus.com/mobile-app-instance-list?search=SEARCH_TERM |
Recherchez des instances d’application mobile avec des noms ou des descriptions contenant certains caractères. |
Champs JSON
| Nom | Type | Description |
|---|---|---|
apps |
tableau d’objets | Liste des instances d’application associées à cet ID d’application particulier. |
id |
int | ID de cette liste instance. |
name |
string | Nom de cette liste instance. Obligatoire sur : POST |
description |
string | Description facultative de cette liste instance. |
member_id |
int | L’ID de membre associé à cette application instance liste. |
last_modified |
date | Lorsque cette instance liste a été mise à jour pour la dernière fois. |
created_on |
date | Lorsque cette application instance liste a été créée. |
Applications
| Nom | Type | Description |
|---|---|---|
instance_id |
int | L’ID instance associé à cette application instance. |
bundle_id |
string | L’ID de bundle associé à cette application instance. Obligatoire sur : POST |
os_family_id |
int | L’ID de la famille de systèmes d’exploitation associé à cette application instance. Pour obtenir la liste complète des ID de famille de systèmes d’exploitation, consultez le service famille de systèmes d’exploitation. |
last_modified |
date | Lorsque cette application instance a été mise à jour pour la dernière fois. |
Exemples
Ajouter une liste de instance d’applications mobiles au système
Dans cet exemple, nous ajoutons une petite liste d’applications mobiles instance au système avec un POST appel.
$ cat the-list.json
{
"mobile-app-instance-list": {
"name": "A Series of Unfortunate Apps",
"description": "Mobile games which we'd like to exclude from our campaigns due to their complete lack of smurfiness.",
"apps": [
{
"bundle_id": "com.unfortunate.screamfest",
"os_family_id": 2
},
{
"bundle_id": "com.unfortunate.eggsmash",
"os_family_id": 2
}
]
}
}
$ curl -b cookies -c cookies -X POST -d @the-list.json https://api.appnexus.com/mobile-app-instance-list?member_id=1309
{
"response": {
"status": "OK",
"count": 1,
"id": 77,
"start_element": 0,
"num_elements": 100,
"mobile-app-instance-list": {
"id": 77,
"name": "A Series of Unfortunate Apps",
"description": "Mobile games which we'd like to exclude from our campaigns due to their complete lack of smurfiness.",
"member_id": 1309,
"last_modified": "2014-02-04 20:39:03",
"created_on": "2014-02-04 20:39:03",
"apps": [
{
"instance_id": 220,
"last_modified": "2014-02-04 20:39:03",
"bundle_id": "com.unfortunate.screamfest",
"os_family_id": 2
},
{
"instance_id": 221,
"last_modified": "2014-02-04 20:39:03",
"bundle_id": "com.unfortunate.eggsmash",
"os_family_id": 2
}
]
},
...
}
}
Afficher une liste de instance d’applications mobiles existantes
Une simple GET requête avec l’ID d’objet dans la chaîne de requête extrait l’objet.
$ curl -b cookies https://api.appnexus.com/mobile-app-instance-list?id=77
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"mobile-app-instance-list": {
"id": 77,
"name": "A Series of Unfortunate Apps",
"description": "Mobile games which we'd like to exclude from our campaigns due to their complete lack of smurfiness.",
"member_id": 1309,
"last_modified": "2014-02-04 20:39:03",
"created_on": "2014-02-04 20:39:03",
"apps": [
{
"instance_id": 220,
"last_modified": "2014-02-04 20:39:03",
"bundle_id": "com.unfortunate.screamfest",
"os_family_id": 2
},
{
"instance_id": 221,
"last_modified": "2014-02-04 20:39:03",
"bundle_id": "com.unfortunate.eggsmash",
"os_family_id": 2
}
]
},
...
}
}
Ajouter une liste de instance d’applications mobiles à votre profil de ciblage
Dans cet exemple, nous ajoutons une liste de instance d’applications mobiles fictives à notre profil de ciblage pour une utilisation par les campagnes. L’objet de profil que nous obtenons doit refléter la mise à jour. Pour plus d’informations sur les profils, consultez service de profil.
$ cat update.json
{
"profile": {
"mobile_app_instance_list_targets": [
{
"id": 2
}
],
"mobile_app_instance_list_action_include": true
}
}
$ curl -b cookies -X PUT -d @update.json 'https://api.appnexus.com/profile?id=140537'
{
"response": {
"status": "OK",
"count": 1,
"id": "140537",
"start_element": 0,
"num_elements": 100,
"profile": {
"mobile_app_instance_targets": "",
"mobile_app_instance_list_targets": [
{
"id": 2,
"name": "Angry List",
"description": "List of games that will be played by everyone",
"deleted": false
}
],
...SNIP...
}
}
}
Recherche de listes de instance d’applications mobiles avec des noms ou des descriptions contenant"test"
$ curl -b cookies -c cookies 'https://api.appnexus.com/mobile-app-instance-list?search=test'
{
"response": {
"status": "OK",
"start_element": 0,
"num_elements": 100,
"mobile-app-instance-lists": [{
"id": 31,
"name": "Sample Test IPHONE list",
"description": "",
"member_id": 927,
"last_modified": "2014-02-24 18:55:57",
"created_on": "2014-02-24 18:45:57",
"apps": [{
"instance_id": 2,
"last_modified": "2014-02-24 18:55:57",
"bundle_id": "it.studios.fish",
"os_family_id": 3
},
{
"instance_id": 14576,
"last_modified": "2014-02-24 18:55:57",
"bundle_id": "587033035",
"os_family_id": 3
},
{
"instance_id": 14576,
"last_modified": "2014-02-24 18:55:57",
"bundle_id": "com.cshomegrown.LX-Player",
"os_family_id": 3
},
{
"instance_id": 14576,
"last_modified": "2014-02-24 18:55:57",
"bundle_id": "561921433",
"os_family_id": 3
}
],
"num_apps": 4
},
{
"id": 61,
"name": "test",
"description": "test APP 428312806",
"member_id": 2350,
"last_modified": "2014-03-13 13:13:55",
"created_on": "2014-03-13 13:13:55",
"apps": [{
"instance_id": 225,
"last_modified": "2014-03-13 13:13:55",
"bundle_id": "com.wordfeud.free",
"os_family_id": 3
},
{
"instance_id": 225,
"last_modified": "2014-03-13 13:13:55",
"bundle_id": "428312806",
"os_family_id": 3
}
],
"num_apps": 2
}
]
}
}