Leer en inglés

Compartir a través de


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.

API de REST

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.

Campos JSON

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

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)

Ejemplos

Ver todos los valores de destino de una clave determinada

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

Visualización de un valor de destino específico

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

Agregar un valor de destino (cadena)

$ 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'

Agregar varios valores de destino (cadena)

$ 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'

Agregar un valor de destino (numérico)

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'

Modificación de un valor de destino

$ 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'

Ordenar por nombre de valor

Puede ordenar los resultados por id, , namelabel, created_ono 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"
    }
],...

Eliminación de un valor de destino

$ curl -b cookies -X DELETE 'https://api.appnexus.com/targeting-value?id=4'