Servicio universal de píxeles
El servicio universal de píxeles es un conjunto de servicios de API REST que le proporcionan acceso a uno o varios píxeles universales y a cualquier audiencia y conversiones asociadas.
Introducción al servicio Universal Pixel
El píxel universal proporciona información sobre las interacciones que los usuarios tienen con tu sitio web para que puedas segmentar fácilmente a estos usuarios, medir las acciones que realizan y orientar mejor tus anuncios. El servicio universal de píxeles tiene tres conjuntos de puntos de conexión:
- API REST de píxeles universales : para crear, eliminar, ver y actualizar un píxel universal.
- API REST de audiencia : para crear, eliminar, ver y actualizar una audiencia.
- API REST de conversión : para crear, eliminar, ver y actualizar una conversión.
Consulte a continuación los ejemplos de cada punto de conexión de píxeles universales.
API REST de píxeles universales (punto de conexión)
Puede crear un píxel universal mediante el punto de /universal-pixel conexión. Una vez creado un píxel universal, puede usar el /universal-pixel punto de conexión para verlo, actualizarlo o eliminarlo.
API REST de audiencia (punto de conexión)
Puede crear una audiencia de píxeles universales mediante el punto de /universal-pixel/audience conexión. Una vez creado un público, puede usar el /universal-pixel/audience punto de conexión para verlo, actualizarlo o eliminarlo.
API REST de conversión (punto de conexión)
Cree una conversión de píxeles universales mediante el /universal-pixel/conversion punto de conexión. Una vez creada una conversión, puede usar el /universal-pixel/conversion punto de conexión para verlo, actualizarlo o eliminarlo.
API REST de píxeles universales
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/universal-pixel/pixel | Ver una lista de píxeles universales asociados a un miembro o anunciante. |
POST |
https://api.appnexus.com/universal-pixel/pixel | Cree un nuevo píxel universal. |
GET |
https://api.appnexus.com/universal-pixel/pixel/PIXEL_ID | Ver un píxel universal por identificador. |
PUT |
https://api.appnexus.com/universal-pixel/pixel/PIXEL_ID | Actualice un píxel universal por identificador. |
DELETE |
https://api.appnexus.com/universal-pixel/pixel/PIXEL_ID | Elimine un píxel universal por identificador. |
GET |
https://api.appnexus.com/universal-pixel/pixel-uuid/PIXEL_UUID | Ver un píxel universal por UUID. |
Ver una lista de píxeles universales
Campos de consulta
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a Universal Pixel para la operación. |
advertiser_id |
integer | Identificador de un anunciante asociado a Universal Pixel. |
sort |
string | Ordenar por campo y dirección: - Id. ascendente = id.asc- Id. descendente = id.dscValor predeterminado: id.asc |
num_elements |
integer | Número de elementos que se van a devolver; maximum = 1000, minimum = 1, default = 1000. |
start_element |
integer | Elemento Starting (se usa para la paginación); valor predeterminado = 0. |
Campos JSON (cuerpo de la respuesta)
| Campo | Tipo | Descripción |
|---|---|---|
data |
matriz | Matriz de objetos De píxeles universales. |
id |
integer | Identificador de píxel universal asignado por la API. |
name |
string | Nombre del píxel universal. |
uuid |
string | Identificador único del píxel universal asignado por la API. |
member_id |
integer | Identificador del miembro asociado a Universal Pixel. |
advertiser_id |
integer | Identificador del anunciante asociado a Universal Pixel. |
created_on |
string | Marca de tiempo en la que se creó el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
last_updated |
string | Marca de tiempo cuando se actualizó por última vez el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
Creación de un nuevo píxel universal
Campos de consulta para crear un nuevo píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a Universal Pixel para la operación. |
Campos JSON (cuerpo de la solicitud) para crear un nuevo píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Nombre del píxel universal. La longitud mínima de la cadena es 1 y el máximo es 100. Este es un campo obligatorio . |
advertiser_id |
integer | Identificador del anunciante asociado a Universal Pixel. |
Campos JSON (cuerpo de respuesta) para crear un nuevo píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de píxel universal asignado por la API. |
name |
string | Nombre del píxel universal. |
uuid |
string | Identificador único del píxel universal asignado por la API. |
member_id |
integer | Identificador del miembro asociado a Universal Pixel. |
advertiser_id |
integer | Identificador del anunciante asociado a Universal Pixel. |
created_on |
string | Marca de tiempo en la que se creó el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
last_updated |
string | Marca de tiempo cuando se actualizó por última vez el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
Visualización de un píxel universal por identificador
Campos de consulta para ver un píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador del píxel universal asignado por la API para la operación. |
Campos JSON (cuerpo de respuesta) para ver un píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de píxel universal asignado por la API para la operación. |
name |
string | Nombre del píxel universal. |
uuid |
string | Identificador único del píxel universal asignado por la API. |
member_id |
integer | Identificador del miembro asociado a Universal Pixel. |
advertiser_id |
integer | Identificador del anunciante asociado a Universal Pixel. |
created_on |
string | Marca de tiempo en la que se creó el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
last_updated |
string | Marca de tiempo cuando se actualizó por última vez el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
Actualización de un píxel universal por identificador
Campos de consulta para actualizar un píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador del píxel universal asignado por la API para la operación. |
Campos JSON (cuerpo de la solicitud) para actualizar un píxel universal
Cualquier campo que tenga que cambiarse de valor existente a uno nuevo. Por ejemplo:
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Se ha actualizado el nombre del píxel universal. Este es un campo obligatorio . |
Eliminación de un píxel universal por identificador
Campos de consulta para eliminar un píxel universal
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador del píxel universal asignado por la API que se eliminaría. |
Visualización de un píxel universal por UUID
Campos de consulta para ver un píxel universal por UUID
| Campo | Tipo | Descripción |
|---|---|---|
uuid |
integer | Identificador único del píxel universal asignado por la API para la operación. |
Campos JSON (cuerpo de respuesta) para ver un píxel universal por UUID
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de píxel universal asignado por la API para la operación. |
name |
string | Nombre del píxel universal. |
uuid |
string | Identificador único del píxel universal asignado por la API. |
member_id |
integer | Identificador del miembro asociado a Universal Pixel. |
advertiser_id |
integer | Identificador del anunciante asociado a Universal Pixel. |
created_on |
string | Marca de tiempo en la que se creó el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
last_updated |
string | Marca de tiempo cuando se actualizó por última vez el píxel universal. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
API REST de audiencia
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/universal-pixel/audience | Ver una lista de audiencias asociadas a un miembro o anunciante. |
POST |
https://api.appnexus.com/universal-pixel/audience | Cree un público nuevo. |
GET |
https://api.appnexus.com/universal-pixel/audience/AUDIENCE_ID | Ver una audiencia por identificador. |
PUT |
https://api.appnexus.com/universal-pixel/audience/AUDIENCE_ID | Actualice una audiencia por identificador. |
DELETE |
https://api.appnexus.com/universal-pixel/audience/AUDIENCE_ID | Elimine una audiencia por identificador. |
Visualización de una lista de audiencias
Campos de consulta para ver una lista de audiencias
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a Universal Pixel para la operación. |
advertiser_id |
integer | Identificador de un anunciante asociado a Universal Pixel. |
sort |
string | Ordenar por campo y dirección: - Id. ascendente = id.asc- Id. descendente = id.dscPredeterminado = id.asc |
num_elements |
integer | Número de elementos que se van a devolver; maximum = 1000, minimum = 1, default = 1000. |
start_element |
integer | Elemento Starting (se usa para la paginación); valor predeterminado = 0. |
universal_pixel_id |
integer | Identificador de píxel universal por el que filtrar. |
segment_id |
integer | Id. de segmento por el que se va a filtrar. |
search |
string | Término de búsqueda. |
Campos JSON (cuerpo de respuesta) para ver una lista de audiencias
| Campo | Tipo | Descripción |
|---|---|---|
data |
matriz | Matriz de objetos Audience. |
id |
integer | Identificador de audiencia asignado por la API. |
version_id |
integer | Id. de versión asociado a la audiencia. |
universal_pixel_id |
integer | Identificador del píxel universal al que asociar audiencia. |
advertiser_id |
integer | Identificador del anunciante asociado a la audiencia. |
name |
string | Nombre de la audiencia. |
user_ttl_minutes |
integer | TTL (Tiempo de vida) en minutos para un usuario de esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
segment_id |
integer | Id. de segmento que se va a usar para dirigirse a esta audiencia. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y debe contener una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
rule para el público
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},{"event":{"equals":["Purchase"]}},
{"item_id":{"equals":["123"]}}],"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Creación de una nueva audiencia
Campos de consulta para crear una nueva audiencia
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a Audience para la operación. |
Campos JSON (cuerpo de la solicitud) para crear una nueva audiencia
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de la audiencia. Es un campo obligatorio . |
universal_pixel_id |
integer | Identificador del píxel universal al que asociar audiencia. Es un campo obligatorio . |
user_ttl_minutes |
integer | TTL (Tiempo de vida) en minutos para un usuario de esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un campo obligatorio y un objeto . Debe contener una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
rule para crear una nueva audiencia (cuerpo de la solicitud)
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},
{"event":{"equals":["Purchase"]}},{"item_id":{"equals":["123"]}}],
"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Campos JSON (cuerpo de respuesta) para crear una nueva audiencia
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de audiencia asignado por la API. |
version_id |
integer | Id. de versión asociado a la audiencia. |
universal_pixel_id |
integer | Identificador de la audiencia asociada a Universal Pixel. |
name |
string | Nombre de la audiencia. |
segment_id |
integer | Id. de segmento que se va a usar para dirigirse a esta audiencia. |
user_ttl_minutes |
integer | TTL (Tiempo de vida) en minutos para un usuario de esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se cumplen para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales está en un sitio web que tiene un dominio que contiene microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
rule para crear una nueva audiencia (cuerpo de la respuesta)
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},
{"event":{"equals":["Purchase"]}},{"item_id":{"equals":["123"]}}],
"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Visualización de una audiencia por identificador
Campos de consulta para ver una audiencia por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de la audiencia asignada por la API. |
Campos JSON (cuerpo de la respuesta) para ver una audiencia por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de audiencia asignado por la API. |
version_id |
integer | Id. de versión asociado a la audiencia. |
universal_pixel_id |
integer | Identificador del píxel universal al que asociar audiencia. |
advertiser_id |
integer | Identificador del anunciante asociado a la audiencia. |
name |
string | Nombre de la audiencia. |
user_ttl_minutes |
integer | TTL (Tiempo de vida) en minutos para un usuario de esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
segment_id |
integer | Id. de segmento que se va a usar para dirigirse a esta audiencia. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
rule para ver una audiencia por identificador (cuerpo de la respuesta)
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},
{"event":{"equals":["Purchase"]}},{"item_id":{"equals":["123"]}}],
"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Actualización de una audiencia por identificador
Campos de consulta para actualizar una audiencia por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de la audiencia asignada por la API. |
Campos JSON (cuerpo de la solicitud) para actualizar una audiencia por identificador
Cualquier campo que tenga que cambiarse de valor existente a uno nuevo. Por ejemplo:
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Se ha actualizado el nombre de la audiencia. Este es un campo obligatorio . |
rule |
objeto | Conjunto de reglas para la audiencia. Se trata de un campo obligatorio y un objeto . Debe contener una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
user_ttl_minutes |
integer | TTL (Tiempo de vida) en minutos para un usuario de esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
rule para actualizar una audiencia por identificador (cuerpo de la solicitud)
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},
{"event":{"equals":["Purchase"]}},{"item_id":{"equals":["123"]}}],
"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Campos JSON (cuerpo de respuesta) para actualizar una audiencia por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de audiencia asignado por la API. |
version_id |
integer | Id. de versión asociado a la audiencia. |
universal_pixel_id |
integer | Identificador del píxel universal al que asociar audiencia. |
advertiser_id |
integer | Identificador del anunciante asociado a la audiencia. |
name |
string | Nombre de la audiencia. |
user_ttl_minutes |
integer | Minutos para que exista esta audiencia; maximum = 259200, minimum = 0, default = 43200. |
segment_id |
integer | Id. de segmento que se va a usar para dirigirse a esta audiencia. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
rule para actualizar una audiencia por identificador (cuerpo de la respuesta)
"rule":{"and":[{"domain":{"contains":["microsoft.com"]}},
{"event":{"equals":["Purchase"]}},{"item_id":{"equals":["123"]}}],
"pixel_uuid":"0b3758f1-cf0f-46c1-9957-00bd36f19ad0"},
Eliminación de una audiencia por identificador
Campos de consulta para eliminar una audiencia por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de la audiencia asignada por la API que se eliminaría. |
API REST de conversión
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/universal-pixel/conversion | Ver una lista de conversiones asociadas a un miembro o anunciante. |
POST |
https://api.appnexus.com/universal-pixel/conversion | Cree una nueva conversión. |
GET |
https://api.appnexus.com/universal-pixel/conversion/CONVERSION_ID | Ver una conversión por identificador. |
PUT |
https://api.appnexus.com/universal-pixel/conversion/CONVERSION_ID | Actualice una conversión por identificador. |
DELETE |
https://api.appnexus.com/universal-pixel/conversion/CONVERSION_ID | Elimine una conversión por identificador. |
Ver una lista de conversiones
Campos de consulta para ver una lista de conversiones
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a las conversiones para la operación. |
advertiser_id |
integer | Identificador de un anunciante asociado a las conversiones. |
sort |
string | Ordenar por campo y dirección: - Id. ascendente = id.asc- Id. descendente = id.dscPredeterminado = id.asc |
num_elements |
integer | Número de elementos que se van a devolver; maximum = 1000, minimum = 1, default = 1000. |
start_element |
integer | Elemento Starting (usado para la paginación). Valor predeterminado = 0. |
universal_pixel_id |
integer | Identificador de píxel universal por el que filtrar. |
conversion_pixel_id |
integer | Identificador del píxel de conversión heredado. |
search |
string | Término de búsqueda. |
Campos JSON (cuerpo de la respuesta) para ver una lista de conversiones
| Campo | Tipo | Descripción |
|---|---|---|
data |
matriz | Matriz de objetos de conversión. |
id |
integer | Identificador de conversión asignado por la API. |
universal_pixel_id |
integer | Identificador del píxel universal asociado a esta conversión. |
name |
string | Nombre de la conversión. |
conversion_pixel_id |
integer | Identificador del píxel de conversión heredado. |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Nota: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, clicko hybrid. |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de devolución máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
conversion_category_id valores
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para ver una lista de conversiones (cuerpo de la respuesta)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Creación de una nueva conversión
Campos de consulta para crear una nueva conversión
| Campo | Tipo | Descripción |
|---|---|---|
member_id |
integer | Identificador de un miembro asociado a Conversión para la operación. |
Campos JSON (cuerpo de la solicitud) para crear una nueva conversión
| Campo | Tipo | Descripción |
|---|---|---|
universal_pixel_id |
integer | Identificador del píxel universal al que está asociada esta conversión. Este es un campo obligatorio . |
name |
string | Nombre de la conversión. Este es un campo obligatorio . |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Nota: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, clicko hybrid. Este es un campo obligatorio . |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de devolución máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Se trata de un campo obligatorio y un objeto . Debe contener una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
conversion_category_id valores para crear una nueva conversión (cuerpo de la solicitud)
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para crear una nueva conversión (cuerpo de la solicitud)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Campos JSON (cuerpo de la respuesta) para crear una nueva conversión
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de conversión asignado por la API. |
member_id |
integer | Identificador de un miembro asociado a las conversiones para la operación. |
version_id |
integer | Versión de esta conversión. |
universal_pixel_id |
integer | Identificador del píxel universal asociado a esta conversión. |
name |
string | Nombre de la conversión. |
conversion_pixel_id |
integer | Identificador del píxel de conversión heredado. |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Advertencia: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, clicko hybrid. |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de vista posterior máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
conversion_category_id valores para crear una nueva conversión
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para crear una nueva conversión (cuerpo de la respuesta)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Visualización de una conversión por identificador
Campos de consulta para ver una conversión por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador del píxel universal asignado por la API para la operación. |
Campos JSON (cuerpo de la respuesta) para ver una conversión por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de conversión asignado por la API. |
member_id |
integer | Identificador de un miembro asociado a las conversiones para la operación. |
version_id |
integer | Versión de esta conversión. |
universal_pixel_id |
integer | Identificador del píxel universal asociado a esta conversión. |
name |
string | Nombre de la conversión. |
conversion_pixel_id |
integer | Identificador del píxel de conversión heredado. |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Importante: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, click o hybrid. |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de vista posterior máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
conversion_category_id valores para ver una conversión por identificador
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para ver una conversión por identificador (cuerpo de la respuesta)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Actualización de una conversión por identificador
Campos de consulta para actualizar una conversión por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de la conversión asignada por la API para la operación. |
Campos JSON (cuerpo de la solicitud) para actualizar una conversión por identificador
Cualquier campo que tenga que cambiarse de valor existente a uno nuevo. Por ejemplo:
| Campo | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de la conversión. |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Advertencia: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, click o hybrid. Este es un campo obligatorio . |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de vista posterior máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Se trata de un campo obligatorio y un objeto . Debe contener una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
conversion_category_id valores para actualizar una conversión por identificador
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para actualizar una conversión por identificador (cuerpo de la solicitud)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Campos JSON (cuerpo de la respuesta) para actualizar una conversión por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador de conversión asignado por la API. |
member_id |
integer | Identificador de un miembro asociado a las conversiones para la operación. |
version_id |
integer | Versión de esta conversión. |
universal_pixel_id |
integer | Identificador del píxel universal asociado a esta conversión. |
name |
string | Nombre de la conversión. |
conversion_pixel_id |
integer | Identificador del píxel de conversión heredado. |
conversion_category_id |
integer | Identificador de la categoría de eventos de conversión. Vea los valores de conversion_category_id. |
conversion_category_custom |
string | Etiqueta de la categoría de eventos de conversión personalizada. Este campo se establece en el valor de cadena de la categoría en la que se va a incluir la conversión. Advertencia: Este campo solo se establece si conversion_category_id es null. |
count_type |
enumeración | Tipo de recuento de conversiones: view, click o hybrid. |
min_minutes_per_conversion |
integer | Intervalo (en minutos) para permitir una conversión repetida. El valor máximo es 32767 (22 días).- Si se establece en 0: cuente todas las conversiones.- Si se establece en null (valor predeterminado): cuente uno por usuario. |
post_click_value |
número | Valor que se atribuye a una conversión después de un clic. |
post_click_expire_minutes |
número | Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de vista se cuente como apta. El valor máximo es 43200 (30 días). Si se establece en 0 o null, se aplica la ventana de vista posterior máxima. |
post_view_value |
número | Valor que se atribuye a una conversión después de una vista. |
post_view_expire_minutes |
número | Valor que se atribuye a una conversión después de una vista. |
rule |
objeto | Conjunto de reglas para la audiencia. Este campo es un objeto y contiene una matriz de las reglas que se deben cumplir para considerar que un incendio del píxel universal es una conversión. Por ejemplo, la regla siguiente significa que el incendio de píxeles universales debe estar en un sitio web que tenga un dominio que contenga microsoft.com, el evento para el incendio de píxeles es Purchase y item_id es 123. |
created_on |
string | Marca de tiempo cuando se creó la audiencia. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
published_on |
string | Marca de tiempo cuando se publicó el público. Formato: YYYY-MM-DD HH:MM:SS por ejemplo, 2019-03-08 15:34:18. |
conversion_category_id valores para actualizar una conversión por identificador (cuerpo de la respuesta)
{ id: 1, title: ' Page view', event: 'PageView' },
{ id: 2, title: ' Landing page', event: 'LandingPage' },
{ id: 3, title: ' Item view', event: 'ItemView' },
{ id: 4, title: ' Add to cart', event: 'AddToCart' },
{ id: 5, title: ' Initiate checkout', event: 'InitiateCheckout' },
{ id: 6, title: ' Add payment info', event: 'AddPaymentInfo' },
{ id: 7, title: ' Purchase', event: 'Purchase' },
{ id: 8, title: ' Lead', event: 'Lead' },
{ id: null, title: ' Other' },
rule para actualizar una conversión por identificador (cuerpo de la respuesta)
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
Eliminación de una conversión por identificador
Campos de consulta para eliminar una conversión por identificador
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador del píxel universal asignado por la API que se eliminaría. |
Ejemplos
Obtener una lista de píxeles universales
$ curl -b cookies "https://api.appnexus.com/universal-pixel/pixel"
{
"data": [{
"id": 0,
"name": "string",
"uuid": "string",
"member_id": 0,
"advertiser_id": 0,
"created_on": "2019-04-16T20:43:33.663Z",
"last_modified": "2019-04-16T20:43:33.663Z"
}],
"meta": {
"count": 0,
"start_element": 0,
"num_elements": 0,
"sort": [
"string"
]
}
}
Ejemplo: Creación de un nuevo píxel universal
$ cat new-universal-pixel.json
{
"name": "string",
"advertiser_id": 0
}
$ curl -b cookies -d @new-universal-pixel.json -X POST https://api.appnexus.com/universal-pixel/pixel
{
"id": 0,
"name": "string",
"uuid": "string",
"member_id": 0,
"advertiser_id": 0,
"created_on": "2019-04-16T21:23:52.049Z",
"last_modified": "2019-04-16T21:23:52.049Z"
}
Ejemplo: Visualización de un píxel universal por identificador
$ curl -b cookies "https://api.appnexus.com/universal-pixel/pixel/3"
response:
{
"created_on": "2019-04-09T21:27:54.455Z",
"id": 3,
"last_modified": "2019-04-09T21:27:54.455Z",
"member_id": 0,
"name": "Production Pixel 1",
"uuid": "b95be84e-d95b-4c88-8242-d9c6c026ed30"
}
Ejemplo: Actualización de un píxel universal por identificador
{
"name": "string"
}
Ejemplo: Visualización de un píxel universal por UUID
$ curl -b cookies "https://api.appnexus.com/universal-pixel/pixel-uuid/239e941-0356-47bd-9f92-f46e46d34d16`
response:
{
"advertiser_id": 4647027,
"created_on": "2020-05-26T16:05:12.049Z",
"id": 2716,
"last_modified": "2020-05-26T16:05:12.049Z",
"member_id": 1370,
"name": "Test",
"uuid": "7239e941-0356-47bd-9f92-f46e46d34d16"
}
Visualización de una lista de audiencias asociadas a un miembro o anunciante
- member: curl -b cookies "https://api.appnexus.com/universal-pixel/audience?member_id=1111"
- advertiser: grab the Universal Pixel ID created under the advertiser and run:
curl -b cookies "https://api.appnexus.com/universal-pixel/audience?universal_pixel_id=2716"
{
"data": [
{
"id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"advertiser_id": 0,
"name": "string",
"segment_id": 0,
"user_ttl_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"created_on": "2020-04-16T13:15:19.056Z",
"published_on": "2020-04-16T13:15:19.057Z"
}
],
"meta": {
"count": 0,
"start_element": 0,
"num_elements": 0,
"sort": [
"string"
]
}
Ejemplos: Creación de una nueva audiencia
$ cat new-audience.json
{
"universal_pixel_id": 0,
"name": "string",
"user_ttl_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
}
}
$ curl -b cookies -d @new-audience.json -X POST https://api.appnexus.com/universal-pixel/audience
{
"id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"advertiser_id": 0,
"name": "string",
"segment_id": 0,
"user_ttl_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"created_on": "2020-04-16T13:15:48.648Z",
"published_on": "2020-04-16T13:15:48.648Z"
}
Ejemplo: Visualización de una audiencia por identificador
$ curl -b cookies "https://api.appnexus.com/universal-pixel/audience/10181"
response:
{
"advertiser_id": 4443337,
"created_on": "2020-06-09T15:47:26.578Z",
"id": 11111,
"name": "purchase_capture",
"published_on": "2020-06-09T15:47:27.056Z",
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"segment_id": 22222227,
"universal_pixel_id": 2222,
"user_ttl_minutes": 43200,
"version_id": 15000
}
Ejemplo: Actualización de una audiencia por identificador
$ cat update-audience.json
{
"name": "string",
"user_ttl_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
}
$ curl -b cookies -d @new-universal-pixel.json -X POST https://api.appnexus.com/universal-pixel/audience
{
"id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"advertiser_id": 0,
"name": "string",
"segment_id": 0,
"user_ttl_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"created_on": "2020-04-16T13:17:29.915Z",
"published_on": "2020-04-16T13:17:29.915Z"
}
Ver una lista de conversiones asociadas a un miembro o anunciante
- member: curl -b cookies "https://api.appnexus.com/universal-pixel/conversion?member_id=2222"
- advertiser: grab the Universal Pixel ID created under the advertiser and run:
curl -b cookies "https://api.appnexus.com/universal-pixel/conversion?universal_pixel_id=27777"
{
"data": [
{
"id": 0,
"member_id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"name": "string",
"conversion_pixel_id": 0,
"conversion_category_id": 7,
"conversion_category_custom": "string",
"count_type": "hybrid",
"min_minutes_per_conv": 0,
"post_view_value": 0,
"post_click_value": 0,
"post_click_expire_minutes": 0,
"post_view_expire_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"published_on": "2020-04-16T13:20:02.601Z",
"created_on": "2020-04-16T13:20:02.601Z"
}
],
"meta": {
"count": 0,
"start_element": 0,
"num_elements": 0,
"sort": [
"string"
]
}
Ejemplo: Creación de una nueva conversión
$ cat new-conversion.json
{
"universal_pixel_id": 0,
"name": "string",
"conversion_category_id": 2,
"conversion_category_custom": "string",
"count_type": "hybrid",
"min_minutes_per_conv": 0,
"post_view_value": 0,
"post_click_value": 0,
"post_click_expire_minutes": 0,
"post_view_expire_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
}
}
$ curl -b cookies -d @new-conversion.json -X POST https://api.appnexus.com/universal-pixel/conversion
{
"id": 0,
"member_id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"name": "string",
"conversion_pixel_id": 0,
"conversion_category_id": 2,
"conversion_category_custom": "string",
"count_type": "hybrid",
"min_minutes_per_conv": 0,
"post_view_value": 0,
"post_click_value": 0,
"post_click_expire_minutes": 0,
"post_view_expire_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"published_on": "2020-04-16T13:20:24.931Z",
"created_on": "2020-04-16T13:20:24.931Z"
}
Ejemplo: Visualización de una conversión por identificador
$ curl -b cookies "https://api.appnexus.com/universal-pixel/conversion/4444"
response:
{
"conversion_category_custom": null,
"conversion_category_id": 7,
"conversion_pixel_id": 1111111,
"count_type": "hybrid",
"created_on": "2020-05-29T21:52:08.388Z",
"id": 4444,
"min_minutes_per_conv": 0,
"name": "Install",
"post_click_expire_minutes": 20160,
"post_click_value": null,
"post_view_expire_minutes": 20160,
"post_view_value": null,
"published_on": "2020-05-29T21:52:09.093Z",
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"universal_pixel_id": 2222,
"version_id": 4444
}
Ejemplo: Actualización de una conversión por identificador
$ cat update-conversion.json
{
"name": "string",
"conversion_category_id": 7,
"conversion_category_custom": "string",
"count_type": "hybrid",
"min_minutes_per_conv": 0,
"post_view_value": 0,
"post_click_value": 0,
"post_click_expire_minutes": 0,
"post_view_expire_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
}
}
$ curl -b cookies -d @update-conversion.json -X POST https://api.appnexus.com/universal-pixel/conversion
{
"id": 0,
"member_id": 0,
"version_id": 0,
"universal_pixel_id": 0,
"name": "string",
"conversion_pixel_id": 0,
"conversion_category_id": 7,
"conversion_category_custom": "string",
"count_type": "hybrid",
"min_minutes_per_conv": 0,
"post_view_value": 0,
"post_click_value": 0,
"post_click_expire_minutes": 0,
"post_view_expire_minutes": 0,
"rule": {
"and": [
{
"domain":
{ "contains": [ "microsoft.com" ] }
},
{
"event":
{ "equals": [ "Purchase" ] }
},
{
"item_id":
{ "equals": [ "123" ] }
}
],
"pixel_uuid": "0b3758f1-cf0f-46c1-9957-00bd36f19ad0"
},
"published_on": "2020-04-16T13:20:24.937Z",
"created_on": "2020-04-16T13:20:24.937Z"
}