Servicio de lista de instancias de aplicación móvil
Mobile App Instance List Service se usa para definir una lista de instancias de aplicaciones móviles a las que puede dirigirse con campañas. Piense en ella como la versión de la aplicación móvil de Domain List Service.
Recuerde que una instancia de aplicación móvil es una representación concreta de la abstracción de la "aplicación móvil". Por ejemplo, habrá varias "instancias" de una aplicación para cada plataforma a la que se dirige, como Android o iOS. Para obtener más información sobre esta distinción, consulte mobile App Service.
Este servicio también tiene el efecto secundario de crear aplicaciones móviles en el sistema si aún no existen. A continuación, estas aplicaciones se pueden ver mediante mobile App Service.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/mobile-app-instance-list?id=4 |
Ver una lista de instancias de aplicación móvil única. |
POST |
https://api.appnexus.com/mobile-app-instance-list (JSON de lista de instancias de aplicación móvil) |
Agregue una lista de instancias de aplicación móvil al sistema. |
GET |
https://api.appnexus.com/mobile-app-instance-list |
Vea todas las listas de instancias de aplicaciones móviles. |
GET |
https://api.appnexus.com/mobile-app-instance-list?search=SEARCH_TERM |
Busque instancias de aplicaciones móviles con nombres o descripciones que contengan determinados caracteres. |
Campos JSON
| Nombre | Tipo | Descripción |
|---|---|---|
apps |
matriz de objetos | Lista de instancias de aplicación asociadas a este identificador de aplicación determinado. |
id |
Entero | Identificador de esta lista de instancias. |
name |
string | Nombre de esta lista de instancias. Obligatorio activado: POST |
description |
string | Una descripción opcional de esta lista de instancias. |
member_id |
Entero | Identificador de miembro asociado a esta lista de instancias de la aplicación. |
last_modified |
date | La última vez que se actualizó esta lista de instancias de aplicación. |
created_on |
date | Cuando se creó esta lista de instancias de aplicación. |
Aplicaciones
| Nombre | Tipo | Description |
|---|---|---|
instance_id |
Entero | Identificador de instancia asociado a esta instancia de aplicación. |
bundle_id |
string | Identificador de agrupación asociado a esta instancia de aplicación. Obligatorio activado: POST |
os_family_id |
Entero | Identificador de familia del sistema operativo asociado a esta instancia de aplicación. Para obtener una lista completa de los identificadores de familia del sistema operativo, consulte El servicio de familia del sistema operativo. |
last_modified |
date | La última vez que se actualizó esta instancia de aplicación. |
Ejemplos
Adición de una lista de instancias de aplicación móvil al sistema
En este ejemplo, agregamos una pequeña lista de instancias de aplicación móvil al sistema con una POST llamada.
$ 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
}
]
},
...
}
}
Visualización de una lista de instancias de aplicación móvil existente
Una solicitud simple GET con el identificador de objeto en la cadena de consulta captura el objeto.
$ 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
}
]
},
...
}
}
Adición de una lista de instancias de aplicación móvil al perfil de destino
En este ejemplo, agregamos una lista ficticia de instancias de aplicaciones móviles a nuestro perfil de destino para que las usen las campañas. El objeto de perfil que recuperamos debe reflejar la actualización. Para obtener más información sobre los perfiles, consulte el Servicio de perfiles.
$ 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...
}
}
}
Búsqueda de listas de instancias de aplicaciones móviles con nombres o descripciones que contengan "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
}
]
}
}