Servicio de valor de destino
El servicio de valor de destino funciona junto con el servicio de clave de destino para permitirle crear sus propias combinaciones de clave/valor para usarlas en la selección de destino de elementos de línea, campañas, etc. Consulte Custom Key Value Targeting (Destino de valor de clave personalizada ) para obtener más información.
Http (método) | Endpoint | Description |
---|---|---|
GET |
https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID |
Ver todos los valores de destino de una clave específica. |
GET |
https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID&id=TARGETING_VALUE_ID |
Ver un valor de destino específico. |
POST |
https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID |
Agregue un nuevo valor de destino. |
POST |
https://api.appnexus.com/targeting-value?targeting_key_id=TARGETING_KEY_ID |
Agregue varios nuevos valores de destino. |
PUT |
https://api.appnexus.com/targeting-value?id=TARGETING_VALUE_ID |
Modifique un valor de destino. |
DELETE |
https://api.appnexus.com/targeting-value?id=TARGETING_VALUE_ID |
Elimine un valor de destino. |
Campo | Tipo | Descripción |
---|---|---|
created_on |
date | Solo lectura. Fecha y hora en que se creó el valor de destino. |
id |
Entero | Identificador del valor de destino. Obligatorio activado: PUT y DELETE Valor predeterminado: número generado automáticamente. |
label |
string | Etiqueta para el valor, que se usa con fines de informes. Este valor no es necesario, pero si proporciona un valor, debe ser único dentro de una clave. Las etiquetas pueden tener un máximo de 190 caracteres. |
last_modified |
date | Solo lectura. Fecha y hora en que se modificó por última vez el valor de destino. |
name |
string | Nombre del valor de destino. Este nombre debe ser único dentro de una clave de destino determinada. |
targeting_key_id |
Entero | Identificador de la clave de destino asociada. La clave de destino debe existir antes de que se pueda crear un valor. Consulte Servicio de clave de destino. Obligatorio activado: POST y GET |
Requisitos de valor | Detalles |
---|---|
- Puede tener hasta 100 000 valores por clave. Nota: El límite máximo para el número de valores que se van a incluir en una carga es 100. - Puede tener hasta 2500 000 valores activos totales a la vez. |
- Los nombres de valor no distinguen mayúsculas de minúsculas. - La longitud máxima del nombre del valor es de 100 caracteres. - Los nombres de valor pueden contener espacios en blanco, por lo que pueden ser más de una palabra. - Los nombres de valor no pueden contener ninguno de los siguientes caracteres especiales: - " (comillas dobles) - ' (apóstrofo) - = (signo igual) - ! (signo de exclamación) - + (signo más) - # (hashtag) - * (asterisco) - ~ (tilde) - ; (punto y coma) - ^ (símbolo de intercalación) - () (paréntesis) - <> (corchetes angulares) - [] (corchetes) - , (coma) - & (ampersand) - @ (at) - : (dos puntos) - ? (signo de interrogación) - % (porcentaje) - / (barra diagonal) |
$ curl -b cookies 'https://api.appnexus.com/targeting-values?targeting_key_id=12'
"targeting-values": [
{
"id": 1,
"targeting_key_id": 12,
"name": "value1",
"label": null,
"created_on": "2016-08-26 08:52:43",
"last_modified": "2016-08-26 08:52:43"
},
{
"id": 4,
"targeting_key_id": 12,
"name": "value2",
"label": null,
"created_on": "2016-08-26 09:24:33",
"last_modified": "2016-08-26 09:24:33"
}
],...
$ curl -b cookies 'https://api.appnexus.com/targeting-value?id=4'
"targeting-value": {
"id": 4,
"targeting_key_id": 12,
"name": "value2",
"label": null,
"created_on": "2016-08-26 09:24:33",
"last_modified": "2016-08-26 09:24:33"
},
$ cat create_targeting_value.json
{
"targeting-value": {
"name": "value1"
}
}
$ curl -b cookies -X POST -d @create_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'
$ cat create_multi_targeting_value.json
{
"targeting-values": [
{
"name": "value1"
},
{
"name": "value2"
}
]
}
$ curl -b cookies -X POST -d @create_multi_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'
El name
campo requiere un valor de cadena (entre comillas). Sin embargo, si la clave se ha definido con un type
valor numérico, esa cadena debe contener caracteres numéricos.
$ cat create_targeting_value.json
{
"targeting-value": {
"name": "22"
}
}
$ curl -b cookies -X POST -d @create_targeting_value.json 'https://api.appnexus.com/targeting-value?targeting_key_id=12'
$ cat update_targeting_value.json
{
"targeting-value":
{
"name": "newvalue2"
}
}
$ curl -b cookies -X PUT -d @update_targeting_value.json 'https://api.appnexus.com/targeting-value?id=4'
Puede ordenar los resultados por id
, , name
label
, created_on
o last_modified
. Puede ordenar en orden ascendente (asc
) o descendente (desc
).
$ curl -b cookies 'https://api.appnexus.com/targeting-value?targeting_key_id=4&sort=name.asc'
"targeting-values": [
{
"id": 10,
"targeting_key_id": 12,
"name": "a test value",
"label": null,
"created_on": "2016-08-26 08:52:43",
"last_modified": "2016-08-26 08:52:43"
},
{
"id": 7,
"targeting_key_id": 12,
"name": "test value",
"label": null,
"created_on": "2016-08-26 09:24:33",
"last_modified": "2016-08-26 09:24:33"
}
],...
$ curl -b cookies -X DELETE 'https://api.appnexus.com/targeting-value?id=4'