Compartir a través de

Servicio de píxeles de conversión

  • Artículo

El servicio de píxeles se puede usar para crear píxeles de conversión que se colocarán en las páginas del anunciante para realizar un seguimiento de las conversiones basadas en clics y vistas.

Nota:

Una vez que tenga un identificador de píxel de conversión, el formato básico de un píxel de conversión de imagen es <img src="media/px?id=37&t=2" width="1" height="1" />.

Sugerencia

Los píxeles de segmento se crean por separado a través del servicio segment.

API de REST

Http (método) Endpoint Description
GET https://api.appnexus.com/pixel Ver todos los píxeles de conversión.
GET https://api.appnexus.com/pixel?id=123,456,789 Ver una matriz de píxeles de conversión específicos.
GET https://api.appnexus.com/pixel?advertiser_id=ADVERTISER_ID Ver todos los píxeles de conversión de uno de tus anunciantes.
GET https://api.appnexus.com/pixel?advertiser_code=ADVERTISER_CODE Ver todos los píxeles de conversión de uno de tus anunciantes.
GET https://api.appnexus.com/pixel?advertiser_id=ADVERTISER_ID& id=PIXEL_ID Ver un píxel de conversión determinado para uno de tus anunciantes.
GET https://api.appnexus.com/pixel?advertiser_code=ADVERTISER_CODE& code=PIXEL_CODE Ver un píxel de conversión determinado para uno de tus anunciantes.
GET https://api.appnexus.com/pixel/meta Averigüe por qué campos puede filtrar y ordenar.
POST https://api.appnexus.com/pixel?advertiser_id=ADVERTISER_ID Agrega un nuevo píxel de conversión a uno de tus anunciantes.
POST https://api.appnexus.com/pixel?advertiser_code=ADVERTISER_CODE Agrega un nuevo píxel de conversión a uno de tus anunciantes.
PUT https://api.appnexus.com/pixel?advertiser_id=ADVERTISER_ID& id=PIXEL_ID Modifique un píxel de conversión existente.
PUT https://api.appnexus.com/pixel?advertiser_code=ADVERTISER_CODE& code=PIXEL_CODE Modifique un píxel de conversión existente.
DELETE https://api.appnexus.com/pixel?advertiser_id=ADVERTISER_ID& id=PIXEL_ID Elimine un píxel de conversión existente.

Nota: No se puede eliminar un píxel que usa uno o varios elementos de línea. Primero debe editar el elemento de línea para quitar el píxel de conversión.

Campos JSON

Campo Tipo Descripción
advertiser_id Entero Identificador del anunciante propietario del píxel.
Obligatorio activado:POST
campaigns matriz Campañas con las que está asociado el píxel. Para obtener más información sobre los campos de esta matriz, consulte Campañas a continuación.
Solo lectura.
code string Código personalizado para el píxel.
created_on Timestamp Fecha y hora en que se creó el píxel.
Solo lectura.
id Entero Identificador interno asociado al píxel.
Obligatorio activado:PUT
name string Nombre del píxel.
Obligatorio activado:POST
last_modified Timestamp Fecha y hora en que se modificó por última vez el píxel.
Solo lectura.
line_items matriz Elementos de línea con los que está asociado el píxel. Para obtener más información sobre los campos de esta matriz, vea Elementos de línea a continuación.
Solo lectura.
min_minutes_per_conv Entero 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.
Predeterminado:null
piggyback_pixels matriz de objetos Las direcciones URL de los píxeles que quieres que activemos cuando se active el píxel de conversión. Para obtener más información, consulte Piggyback Pixels a continuación.
pixel_conversion_event matriz Categoría de eventos de conversión de píxeles con la que está asociado el píxel. Para obtener más información, vea Evento de conversión de píxeles a continuación.
Solo lectura.
pixel_conversion_event_id enumeración Opcional. Identificador del evento de conversión asociado al píxel. La configuración de una categoría de eventos no afectará a nuestros algoritmos de optimización inmediatamente. En su lugar, proporciona a nuestro equipo de optimización datos valiosos para la predicción que podemos empezar a probar e incorporar. Si no ve una buena coincidencia para el tipo de evento de conversión, deje este campo en blanco.
Los posibles valores son:
- null: no hay ninguna categoría seleccionada.
- 2: visite la página de aterrizaje : un usuario visita su sitio web después de que se le haya notificado un anuncio.
- 3: vista de elementos : un usuario visita una página de su sitio web que muestra uno o varios productos o servicios.
- 4: Agregar al carro : un usuario agrega uno o varios de sus productos o servicios a su carro de la compra.
- 5: iniciar el proceso de desprotección : un usuario comienza el proceso de desprotección.
- 6: agregar información de pago : un usuario agrega información de pago, como un número de tarjeta de crédito, durante el proceso de pago.
- 7: Compra - Una venta confirmada de su producto o servicio.
- 8: generar clientes potenciales : recopile información de clientes potenciales, como direcciones de correo electrónico o códigos postales, de personas interesadas en su negocio.
post_click_expire_mins Entero Intervalo (en minutos) del tiempo de impresión permitido para que una conversión de clics se cuente como apta. El valor máximo es 129600 (90 días). Si se establece en 0 o null, se aplica la ventana de devolución máxima.
post_click_value double Valor que se atribuye a una conversión después de un clic.
post_view_expire_mins Entero 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 double Valor que se atribuye a una conversión después de una vista.
state enumeración Estado del píxel.
Valores posibles: "active" o "inactive".
trigger_type enumeración Tipo de evento necesario para una conversión válida (con atributos). Valores posibles: view, clicko hybrid.
Predeterminado:click

Campañas

Esta matriz muestra las asociaciones de campaña. Para asociar un píxel a una campaña, use el servicio Campaign.

Campo Tipo Descripción
id string Identificador de la campaña.
Solo lectura.

Elementos de línea

Esta matriz muestra las asociaciones de elementos de línea. Para asociar un píxel a un elemento de línea, use el servicio de elementos de línea.

Campo Tipo Descripción
id string Identificador del elemento de línea.
Solo lectura.
name string Nombre del elemento de línea.
Solo lectura.
state enumeración Estado del elemento de línea.
Valores posibles: "active" o "inactive".
Solo lectura.

Píxeles de piggyback

Cada objeto de la piggyback_pixels matriz contiene los campos siguientes.

Al agregar píxeles de perrito, tenga en cuenta lo siguiente:

  • Los píxeles de imagen solo pueden quitarse de otros píxeles de imagen, y los píxeles de JavaScript solo pueden colocar otros píxeles de JavaScript.
  • Los píxeles de imagen solo pueden tener un píxel alcancía. Si necesita agregar varios píxeles, asegúrese de usar un píxel de JavaScript.
  • En AppNexus no hay límites de caracteres para los píxeles perritos, pero se pueden aplicar límites de dirección URL de explorador o servidor.
Campo Tipo (longitud) Descripción
pixel_type enumeración Tipo del píxel que se va a percarcar.
Valores posibles: "js" o "img".
url string (255) Dirección URL del píxel que se va a obtener.

Evento de conversión de píxeles

Campo Tipo Descripción
id enumeración El identificador del evento de conversión asociado opcionalmente a este píxel. Los valores posibles son enteros entre 2 y 8, que están asociados a los name valores siguientes.
- null: no hay ninguna categoría seleccionada.
- 2: LandingPage : un usuario visita su sitio web después de que se le haya notificado un anuncio.
- 3: ItemView : un usuario visita una página de su sitio web que muestra uno o varios productos o servicios.
- 4: AddToCart : un usuario agrega uno o varios de sus productos o servicios a su carro de la compra.
- 5: InitiateCheckout : un usuario comienza el proceso de desprotección.
- 6: AddPaymentInfo : un usuario agrega información de pago, como un número de tarjeta de crédito, durante el proceso de pago.
- 7: Compra - Una venta confirmada de su producto o servicio.
- 8: cliente potencial : recopile información de clientes potenciales, como direcciones de correo electrónico o códigos postales, de personas interesadas en su negocio.
Solo lectura.
name enumeración El nombre del evento de conversión asociado opcionalmente a este píxel. Los valores posibles están asociados a los id valores anteriores:
- null: no hay ninguna categoría seleccionada.
- 2: LandingPage : un usuario visita su sitio web después de que se le haya notificado un anuncio.
- 3: ItemView : un usuario visita una página de su sitio web que muestra uno o varios productos o servicios.
- 4: AddToCart : un usuario agrega uno o varios de sus productos o servicios a su carro de la compra.
- 5: InitiateCheckout : un usuario comienza el proceso de desprotección.
- 6: AddPaymentInfo : un usuario agrega información de pago, como un número de tarjeta de crédito, durante el proceso de pago.
- 7: Compra - Una venta confirmada de su producto o servicio.
- 8: cliente potencial : recopile información de clientes potenciales, como direcciones de correo electrónico o códigos postales, de personas interesadas en su negocio.
Solo lectura.

Ejemplos

Agregar un píxel de conversión para el anunciante 2

$ cat pixel

{
    "pixel": {
        "min_minutes_per_conv": 120,
        "name": "ProStarr Post View Pixel 2",
        "piggyback_pixels": [
            {
                "pixel_type": "img",
                "url": "https://www.testing.com"
            }
        ],
        "post_view_expire_mins": 3600,
        "post_view_value": 1,
        "state": "active",
        "trigger_type": "view"
    }
}

$ curl -b cookies -c cookies -X POST -d @pixel 'https://api.appnexus.com/pixel?advertiser_id=2'

{
   "response":{
      "status":"OK",
      "id":17
   }
}

Visualización del píxel de conversión 17 para el anunciante 2

$ curl -b cookies -c cookies 'https://api.appnexus.com/pixel?id=17&advertiser_id=2'

{
    "response": {
        "status": "OK",
        "pixels": [
            {
                "id": 17,
                "code": null,
                "name": "ProStarr Hybrid Pixel",
                "state": "active",
                "campaigns": [
                    {
                        "id": "17607"
                    }
                ],
               "line_items": [
                    {
                        "id": 382,
                        "name": "Line Item",
                        "state": "active"
                    }
                ],
                "trigger_type": "hybrid",
                "min_minutes_per_conv": null,
                "post_view_expire_mins": null,
                "post_click_expire_mins": null,
                "post_click_value": 10,
                "post_view_value": 1,
                "piggyback_pixels": [
                    {
                        "url": "https://www.testing.com",
                        "pixel_type": "img"
                    }
                ],
                "created_on": "2010-01-01 19:24:20",
                "last_modified": "2010-01-15 21:41:40",
                "advertiser_id": 2
            }
        ]
    }
}

Visualización de píxeles de conversión para todos los anunciantes

Nota:

"advertiser_id" campo le indica al anunciante al que pertenece el píxel.

$ curl -b cookies -c cookies -X POST -d @pixel 'https://api.appnexus.com/pixel'

{
    "response": {
        "status": "OK",
        "pixels": [
            {
                "id": 5,
                "code": null,
                "name": "Sample Pixel 1",
                "state": "active",
                "campaigns": [
                    {
                        "id": "17883"
                    },
                    {
                        "id": "34091"
                    }
                ],
                "line_items": [
                    {
                        "id": 67729,
                        "name": "5556",
                        "state": "active"
                    },
                    {
                        "id": 67734,
                        "name": "7017",
                        "state": "active"
                    },
                    {
                        "id": 67733,
                        "name": "8302",
                        "state": "active"
                    }
                ],
                "trigger_type": "view",
                "min_minutes_per_conv": 32767,
                "post_view_expire_mins": 1440,
                "post_click_expire_mins": null,
                "post_click_value": null,
                "post_view_value": 0,
                "piggyback_pixels": [
                    {
                        "url": "https://test.com/test",
                        "pixel_type": "img"
                    }
                ],
                "created_on": "2011-08-12 18:11:13",
                "last_modified": "2011-09-12 19:55:21",
                "advertiser_id": 8
            },
            {
                "id": 6,
                "code": null,
                "name": "blargh2",
                "state": "active",
                "campaigns": [
                    {
                        "id": "17775"
                    },
                    {
                        "id": "17776"
                    }
                ],
                "line_items": [
                    {
                        "id": 67895,
                        "name": "7082",
                        "state": "active"
                    },
                    {
                        "id": 67477,
                        "name": "3468",
                        "state": "active"
                    },
                    {
                        "id": 67679,
                        "name": "7870",
                        "state": "active"
                    }
                ],
                "trigger_type": "click",
                "min_minutes_per_conv": 1,
                "post_view_expire_mins": null,
                "post_click_expire_mins": 20160,
                "post_click_value": 0,
                "post_view_value": null,
                "piggyback_pixels": null,
                "created_on": "2011-05-07 18:11:13",
                "last_modified": "2011-06-07 20:23:08",
                "advertiser_id": 10
            },
            ...
        ],
        "count": 10,
        "start_element": null,
        "num_elements": null
    }
}

Agregar una categoría de eventos de conversión a un píxel

En este ejemplo se agregan 1017110 de píxeles de conversión a la categoría de eventos 3 (ver un elemento).

$ cat pixel-category

{
    "pixel": 
        {"pixel_conversion_event_id": 3
        }
}

$ curl -b cookies -c cookies -X PUT -s -d @pixel-category "https://api.appnexus.com/pixel?id=1017110&advertiser_id=57992"  

{
    "response": {
        "count": 1,
        "dbg_info": {
            "output_term": "pixel",
            "version": "1.18.651",
            "warnings": []
        },
        "id": "1017110",
        "num_elements": 100,
        "pixel": {
            "advertiser_id": 57992,
            "campaigns": null,
            "code": null,
            "created_on": "2018-07-25 18:39:30",
            "id": 1017110,
            "last_modified": "2018-07-27 20:55:31",
            "line_items": null,
            "member_id": 1370,
            "min_minutes_per_conv": 0,
            "name": "Confirmation Page",
            "piggyback_pixels": null,
            "pixel_conversion_event": {
                "id": 3,
                "name": "ItemView"
            },
            "pixel_conversion_event_id": 3,
            "post_click_expire_mins": 20160,
            "post_click_value": null,
            "post_view_expire_mins": 10080,
            "post_view_value": null,
            "state": "active",
            "trigger_type": "hybrid"
        },
        "start_element": 0,
        "status": "OK"
    }
}