Saltar al contenido principal

​
Descripción general de MACT

La medición de promoción de apps móviles en X permite a los anunciantes hacer un seguimiento del éxito de las campañas publicitarias en X diseñadas para impulsar instalaciones u otras conversiones dentro de la app. Un socio de medición móvil de X permite que un anunciante gestione qué conversiones desea medir de las apps que está promocionando en X. Una vez que el anunciante haya configurado el tipo y las ventanas temporales de los eventos que desea medir, el socio de medición móvil enviará todos esos eventos a X y recibirá de inmediato datos de atribución que indican la campaña y el recurso creativo con el que interactuó el usuario que impulsó la conversión.

​
Eventos de conversión

Para reportar un evento de conversión a X y obtener datos de atribución, el socio debe enviar el ID de la App móvil, el tipo y la marca temporal de la conversión, así como un valor con hash del ID publicitario/del dispositivo. Al proporcionar estos datos, se registrará el evento de conversión en la plataforma de X y, cuando corresponda, se devolverá la atribución. Además, el anunciante puede optar por proporcionar metadatos adicionales sobre el evento de conversión, como el valor de una compra, el ID de un producto o el método de registro.

​
Referencia de API

​
Evento de conversión

​
POST conversion_event

Registra un evento de conversión de medición móvil. La respuesta indicará atribución de X o de X Audience Platform (TAP). Esto se relaciona con el endpoint GET 95. En la respuesta se indicará atribución de X, de TAP o ninguna. El nodo twitter_attribution siempre estará presente y tendrá el valor null cuando no haya atribución de X (consulta el ejemplo de respuesta a continuación). Si se reclama atribución de TAP, habrá un nodo tpn_attribution y se completará en consecuencia. Consulta la introducción a TAP para obtener más información. Hay varios parámetros opcionales disponibles para establecer metadatos asociados con cada evento de conversión. Estos metadatos no afectan los cálculos de atribución.
URL del recurso
https://ads-api.x.com/12/conversion_event
Parámetros
NombreDescripción
app_id
obligatorio		El identificador único en la tienda de apps correspondiente.

Tipo: int, string

Ejemplo: 333903271, com.vine.android
conversion_time
obligatorio		La hora del evento de conversión en formato de marca de tiempo ISO-8601, con milisegundos.

Tipo: string

Ejemplo: 2014-05-22T02:38:28.103Z
conversion_type
obligatorio		El tipo de evento de conversión.

Tipo: enum

Valores posibles: PURCHASE, SIGN_UP, INSTALL, RE_ENGAGE, UPDATE, TUTORIAL_COMPLETE, RESERVATION, ADD_TO_CART, ADD_TO_WISHLIST, LOGIN, CHECKOUT_INITIATED, SEARCH, LEVEL_ACHIEVED, ACHIEVEMENT_UNLOCKED, CONTENT_VIEW, SHARE, INVITE, ADDED_PAYMENT_INFO, SPENT_CREDITS, RATED
hashed_device_id
obligatorio		El IDFA o AdID con hash HMAC_SHA-256.

Tipo: string

Ejemplo: ABCD1234XYZ
os_type
obligatorio		El tipo de sistema operativo de la App.

Tipo: enum

Valores posibles: IOS, ANDROID
click_window
opcional		La ventana de clic para este evento, en días.

Tipo: int

Nota: click_window debe ser mayor o igual que view_through_window

Predeterminado: 14
Valores posibles: 1, 7, 14, 30
device_ip_address
opcional		Dirección IPv4 o IPv6 del dispositivo cuando ocurrió el evento de conversión.

Tipo: string

Ejemplo: 192.133.78.1
level
opcional		Un nivel asociado con este evento.

Tipo: int

Ejemplo: 2
non_twitter_engagement_time
opcional		La hora de la última interacción fuera de X previa a la conversión.

Tipo: string

Ejemplo: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type
opcional		El tipo de interacción fuera de X previa al evento de conversión.

Tipo: enum

Valores posibles: CLICK, VIEW
number_items
opcional		Número de artículos asociados con este evento.

Tipo: int

Ejemplo: 2
price_currency
opcional		Código ISO 4217 que indica la moneda asociada con este evento.

Tipo: String

Ejemplos: EUR, USD, JPY
price_micro
opcional		Un monto de precio asociado a este evento en micros.

Tipo: int

Ejemplo: 123450000
user_payment_info
opcional		Valor booleano que indica si la información de pago del usuario está almacenada en la App asociada con este evento.

Tipo: bool

Valores posibles: true o false
view_through_window
opcional		La ventana de visualización para este evento, en días.

Nota:

click_window debe ser mayor o igual que view_through_window.

Tipo: int

Predeterminado: 1
Valores posibles: 0, 1, 7, 14, 30
Ejemplo de solicitud
https://ads-api.x.com/12/conversion_event?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=1
Ejemplo de respuesta
    {
      "data": {
        "conversion_value_micro": 0,
        "view_through_window": 1,
        "tpn_attribution": null,
        "conversion_time": "2017-01-21T01:14:00.602Z",
        "click_window": 30,
        "limit_ad_tracking": false,
        "event_metadata": null,
        "non_twitter_engagement_type": null,
        "conversion_type": "INSTALL",
        "partner_client_id": "com.appname contact id",
        "app_id": "com.appname",
        "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
        "twitter_attribution": {
          "country_code": "US",
          "engagement_time": "2017-01-21T01:13:00.602Z",
          "engagement_type": "CLICK",
          "attribution_type": "PROMOTED",
          "promoted_properties": {
            "campaign_id": "4ns44",
            "line_item_id": "3x44d",
            "publisher_app_id": "333903271"
            "account_id":"18ce11e3egb",
            "line_item_objective": "APP_INSTALLS",
            "campaign_name": null
          },
          "tweet_id": "11434635565377600"
        },
        "os_type": "ANDROID",
        "non_twitter_engagement_time": null
      },
      "request": {
        "params": {
          "version_number": "1",
          "app_id": "com.appname",
          "conversion_type": "INSTALL",
          "os_type": "ANDROID",
          "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
          "conversion_time": "2017-01-21T01:14:00.602Z",
          "click_window": "30",
          "view_through_window": "1",
          "limit_ad_tracking": "false"
        }
      }
    }

​
Etiquetas de eventos de la App

​
GET accounts/:account_id/app_event_tags

Recupera los detalles de algunas o todas las etiquetas de eventos de App asociadas a la cuenta actual. Estas etiquetas definen las ventanas de conversión configuradas para cada tipo de conversión en el seguimiento de conversiones de Apps móviles.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_event_tags
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la API de Anunciantes, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_event_tag_ids
opcional		Limita la respuesta a las etiquetas de eventos de App deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 id.

Tipo: string

Ejemplo: jhp
count
opcional		Especifica la cantidad de registros que se intentará recuperar por cada solicitud.

Tipo: int

Predeterminado: 200
Mín., Máx.: 1, 1000
cursor
opcional		Especifica un cursor para obtener la siguiente página de resultados. Consulta Paginación para más información.

Tipo: string

Ejemplo: 8x7v00oow
sort_by
opcional		Ordena por un atributo admitido en orden ascendente o descendente. Consulta Ordenación para más información.

Tipo: string

Ejemplo: created_at-asc
with_deleted
opcional		Incluye resultados eliminados en tu solicitud.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
with_total_count
opcional		Incluye el atributo de respuesta total_count.

Nota: Este parámetro y cursor son excluyentes.

Nota: Las solicitudes que incluyan total_count tendrán límites de frecuencia más bajos, actualmente establecidos en 200 por 15 minutos.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
Ejemplo de solicitud
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_event_tag_ids=jhp
Ejemplo de respuesta
    {
      "request": {
        "params": {
          "app_event_tag_ids": [
            "jhp"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "provider_app_event_name": null,
          "app_store_identifier": "co.vine.android",
          "post_view_attribution_window": 1,
          "deep_link_scheme": "vine://",
          "id": "jhp",
          "retargeting_enabled": true,
          "conversion_type": "INSTALL",
          "created_at": "2016-12-08T07:49:58Z",
          "post_engagement_attribution_window": 14,
          "provider_app_event_id": null,
          "last_tracked_at": "2021-05-22T17:00:04Z",
          "status": "TRACKING",
          "updated_at": "2016-12-08T23:07:54Z",
          "os_type": "ANDROID",
          "deleted": false
        }
      ]
    }

​
GET accounts/:account_id/app_event_tags/:app_event_tag_id

Recupera una etiqueta de evento de App específica asociada a la cuenta actual. Estas definen las ventanas de conversión configuradas para cada tipo de conversión en el seguimiento de conversiones de Apps móviles.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:app_event_tag_id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_event_tag_id
obligatorio		Referencia a la etiqueta de evento de App con la que operas en la solicitud.

Tipo: string

Ejemplo: jhp
with_deleted
opcional		Incluye los resultados eliminados en tu solicitud.

Tipo: boolean

Valor predeterminado: false
Valores posibles: true, false

​
Ejemplo de solicitud

GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp

​
Ejemplo de respuesta

    {
      "request": {
        "params": {
          "app_event_tag_id": "jhp",
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2016-12-08T23:07:54Z",
        "os_type": "ANDROID",
        "deleted": false
      }
    }

​
POST accounts/:account_id/app_event_tags

Crea una nueva etiqueta de evento de App asociada a la cuenta actual.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_event_tags
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Ads API, excepto GET accounts. La cuenta especificada debe estar asociada al usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_store_identifier
obligatorio		El identificador de la tienda de Apps.

Tipo: string

Ejemplo: com.twitter.android
conversion_type
obligatorio		El tipo de evento de conversión.

Tipo: enum

Valores posibles: ACHIEVEMENT_UNLOCKED, ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, INSTALL, INVITE, LEVEL_ACHIEVED, LOGIN, PURCHASE, RATED, RESERVATION, RE_ENGAGE, SEARCH, SHARE, SIGN_UP, SPENT_CREDITS, TUTORIAL_COMPLETE, UPDATE
os_type
obligatorio		El tipo de SO de la App.

Tipo: enum

Valores posibles: IOS, ANDROID
provider_app_event_id
obligatorio		El id de la etiqueta de conversión en el sitio del proveedor.

Tipo: string

Ejemplo: provider_tag_j5394
provider_app_event_name
obligatorio		El nombre de la etiqueta de conversión en el sitio del proveedor.

Tipo: string

Ejemplo: provider_name_a4382
deep_link_scheme
opcional		Especifica el URI de deep link para la App asociada con esta etiqueta.

Tipo: string

Ejemplo: twitter://
post_engagement_attribution_window
opcional		La ventana de atribución post-engagement para estos eventos.

Tipo: int

Predeterminado: 30
Valores posibles: 1, 7, 14, 30
post_view_attribution_window
opcional		La ventana de atribución post-view para estos eventos.

Tipo: int

Predeterminado: 1
Valores posibles: 0, 1, 7, 14, 30
retargeting_enabled
opcional		Indica si el retargeting debe estar habilitado para esta etiqueta de evento de App.

Tipo: boolean

Predeterminado: true
Valores posibles: true, false
Ejemplo de solicitud
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_store_identifier=com.twitter.android&os_type=ANDROID&conversion_type=PURCHASE&provider_app_event_id=abc123&provider_app_event_name=test-tag
Ejemplo de respuesta
    {
      "data": {
        "provider_app_event_name": "test-tag",
        "app_store_identifier": "com.twitter.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "https://",
        "id": "3p3t",
        "retargeting_enabled": true,
        "conversion_type": "PURCHASE",
        "created_at": "2017-09-06T06:58:22Z",
        "post_engagement_attribution_window": 30,
        "provider_app_event_id": "abc123",
        "updated_at": "2017-09-06T06:58:22Z",
        "os_type": "ANDROID",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_app_event_name": "test-tag",
          "app_store_identifier": "com.twitter.android",
          "account_id": "18ce54d4x5t",
          "conversion_type": "PURCHASE",
          "provider_app_event_id": "abc123",
          "os_type": "ANDROID"
        }
      }
    }

​
DELETE accounts/:account_id/app_event_tags/:id

Elimina la etiqueta de evento de la App especificada que pertenece a la cuenta actual.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
id
obligatorio		Una referencia a la etiqueta de evento de la App con la que operas en la solicitud.

Tipo: string

Ejemplo: jhp
Ejemplo de solicitud
DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp
Ejemplo de respuesta
    {
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2017-08-30T05:44:57Z",
        "os_type": "ANDROID",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "jhp",
          "account_id": "5gvk9h"
        }
      }
    }

​
Listas de Apps

​
GET accounts/:account_id/app_lists

Obtén detalles de algunas o todas las listas de App asociadas a la cuenta actual.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_lists

​
Parámetros

NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_list_ids
opcional		Limita la respuesta a las listas de App deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 id.

Tipo: string

Ejemplo: wm7x
count
opcional		Especifica la cantidad de registros que se intentará recuperar por cada solicitud.

Tipo: int

Predeterminado: 200
Mín., máx.: 1, 1000
cursor
opcional		Especifica un cursor para obtener la siguiente página de resultados. Consulta Paginación para más información.

Tipo: string

Ejemplo: 8x7v00oow
sort_by
opcional		Ordena por un atributo admitido en orden ascendente o descendente. Consulta Ordenación para más información.

Tipo: string

Ejemplo: created_at-asc
with_deleted
opcional		Incluye resultados eliminados en tu solicitud.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
with_total_count
opcional		Incluye el atributo de respuesta total_count.

Nota: Este parámetro y cursor son excluyentes.

Nota: Las solicitudes que incluyan total_count tendrán límites de frecuencia más bajos, actualmente establecidos en 200 por 15 minutos.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
Ejemplo de solicitud
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?app_list_ids=wm7x
Ejemplo de respuesta
    {
      "request": {
        "params": {
          "app_list_ids": [
            "wm7x"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "id": "wm7x",
          "name": "foo @ 14026528192426843"
        }
      ]
    }

​
GET accounts/:account_id/app_lists/:app_list_id

Obtén una lista de Apps específica asociada a la cuenta actual.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio en todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_list_id
obligatorio		Una referencia a la lista de Apps con la que operas en la solicitud.

Tipo: string

Ejemplo: 28ukf
with_deleted
opcional		Incluye los resultados eliminados en tu solicitud.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
Ejemplo de solicitud
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf
Ejemplo de respuesta
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-08-17T17:07:42Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
POST accounts/:account_id/app_lists

Crea una app_list asociada a la cuenta actual. Actualmente, hay un límite de 100 objetos app_list por account_id y 500 apps por app_list.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_lists
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada al usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_store_identifiers
obligatorio		Los identificadores de la tienda de apps que se incluirán en app_list.

Tipo: string

Ejemplo: com.twitter.android
name
obligatorio		El nombre que asignarás a app_list.

Tipo: string

Ejemplo: My First App List
Ejemplo de solicitud
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?name=app list&app_store_identifiers=com.twitter.android
Ejemplo de respuesta
    {
      "data": {
        "name": "app list",
        "id": "2a4um",
        "created_at": "2017-09-06T07:17:26Z",
        "updated_at": "2017-09-06T07:17:26Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_store_identifiers": [
            "com.twitter.android"
          ],
          "name": "app list",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
DELETE accounts/:account_id/app_lists/:app_list_id

Elimina la lista de Apps especificada asociada a la cuenta actual.
URL del recurso
https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
app_list_id
obligatorio		Una referencia a la lista de App con la que se opera en la solicitud.

Tipo: string

Ejemplo: 28ukf
Ejemplo de solicitud
DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf
Respuesta de ejemplo
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-09-12T22:20:33Z",
        "deleted": true,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
Configuración de proveedores de eventos de App

❯

​
GET accounts/:account_id/app_event_provider_configurations

Obtén los detalles de algunas o todas las configuraciones del proveedor de eventos de App (configuración principal para el seguimiento de conversiones en aplicaciones móviles) asociadas a la cuenta actual.
URL del recurso
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
count
opcional		Especifica la cantidad de registros que se intentará recuperar por cada solicitud independiente.

Tipo: int

Predeterminado: 200
Mín., máx.: 1, 1000
cursor
opcional		Especifica un cursor para obtener la página siguiente de resultados. Consulta Paginación para más información.

Tipo: string

Ejemplo: 8x7v00oow
ids
opcional		Limita la respuesta a las configuraciones deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 id.

Tipo: string

Ejemplo: 25n
sort_by
opcional		Ordena por un atributo compatible en orden ascendente o descendente. Consulta Ordenación para más información.

Tipo: string

Ejemplo: created_at-asc
with_deleted
opcional		Incluye resultados eliminados en tu solicitud.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
with_total_count
opcional		Incluye el atributo de respuesta total_count.

Nota: Este parámetro y cursor son excluyentes.

Nota: Las solicitudes que incluyen total_count tendrán límites de frecuencia más bajos, actualmente establecidos en 200 por cada 15 minutos.

Tipo: boolean

Predeterminado: false
Valores posibles: true, false
Ejemplo de solicitud
GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?ids=25n
Ejemplo de respuesta
    {
      "data": [
        {
          "provider_name": "Answers powered by Fabric",
          "id": "25n",
          "provider_advertiser_id": "54ac2766f0de9e1f7a00001a",
          "created_at": "2016-12-08T07:49:58Z",
          "provider_advertiser_identifier": "54ac2766f0de9e1f7a00001a",
          "updated_at": "2017-05-12T21:37:15Z",
          "deleted": false
        }
      ],
      "next_cursor": null,
      "request": {
        "params": {
          "ids": [
            "25n"
          ],
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
GET accounts/:account_id/app_event_provider_configurations/:id

Recupera un id específico de las configuraciones del proveedor de eventos (configuración básica para el seguimiento de conversiones en Apps móviles) asociadas con la cuenta actual.
URL del recurso
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada al usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
id
obligatorio		Una referencia a la configuración del proveedor de eventos de App con la que operas en la solicitud.

Tipo: string

Ejemplo: 25n
with_deleted
opcional		Incluye resultados eliminados en tu solicitud.

Tipo: boolean

Valor predeterminado: false
Valores posibles: true, false
Ejemplo de solicitud
GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/25n
Ejemplo de respuesta
    {
      "data_type": "app_event_provider_configuration",
      "data": {
        "provider_name": "API McTestface",
        "id": "25n",
        "provider_advertiser_id": "123",
        "created_at": "2017-03-24T22:24:56Z",
        "provider_advertiser_identifier": "123",
        "updated_at": "2017-03-24T22:24:56Z",
        "deleted": false
      },
      "request": {
        "params": {
          "id": "25n",
          "account_id": "18ce54d4x5t"
        }
      }
    }
POST accounts/:account_id/app_event_provider_configurations
Crea una nueva configuración de proveedor de eventos de App asociada con la cuenta actual. Solo puede haber un proveedor MACT asociado a una cuenta de anuncios específica.
URL del recurso
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
provider_advertiser_id
obligatorio		El identificador del anunciante en el sitio del proveedor.

Tipo: string

Ejemplo: client1
Ejemplo de solicitud
POST https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?provider_advertiser_id=client1
Ejemplo de respuesta
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-09-06T06:39:03Z",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_advertiser_id": "client1",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
DELETE accounts/:account_id/app_event_provider_configurations/:id[¶]

Elimina la configuración del proveedor de eventos de la App especificada que pertenece a la cuenta actual.
URL del recurso
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id
Parámetros
NombreDescripción
account_id
obligatorio		El identificador de la cuenta apalancada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado.

Tipo: string

Ejemplo: 18ce54d4x5t
id
obligatorio		Una referencia a la configuración del proveedor de eventos de la App con la que operas en la solicitud.

Tipo: string

Ejemplo: e5g
Ejemplo de solicitud
DELETE https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/e5g
Ejemplo de respuesta
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-08-30T05:40:26Z",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "e5g",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
Atribución de conversiones

​
GET conversion_attribution

Consulta X para verificar la atribución de conversiones sin registrar un evento de conversión. La respuesta indicará la atribución de X. Esto se relaciona con el endpoint POST conversion_event. En la respuesta se indicará atribución de X, de TAP o ninguna. El nodo twitter_attribution siempre estará presente y tendrá un valor de null cuando no haya atribución de X, y se completará como se muestra en el ejemplo de respuesta a continuación. Si se reclama atribución de TAP, habrá un nodo tpn_attribution y se completará en consecuencia. Consulta la introducción a TAP para obtener más información.
URL del recurso
https://ads-api.x.com/12/conversion_attribution
Parámetros
NombreDescripción
app_id
obligatorio		El identificador único en la tienda de apps correspondiente.

Tipo: int, string

Ejemplo: 333903271, com.vine.android
conversion_time
obligatorio		La hora del evento de conversión en formato de marca de tiempo ISO-8601, con milisegundos.

Tipo: string

Ejemplo: 2014-05-22T02:38:28.103Z
conversion_type
obligatorio		El tipo de evento de conversión.

Tipo: enum

Valores posibles: ACHIEVEMENT_UNLOCKED, ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, INSTALL, INVITE, LEVEL_ACHIEVED, LOGIN, PURCHASE, RATED, RESERVATION, RE_ENGAGE, SEARCH, SHARE, SIGN_UP, SPENT_CREDITS, TUTORIAL_COMPLETE, UPDATE
hashed_device_id
obligatorio		El IDFA o AdID con hash HMAC_SHA-256.

Tipo: string

Ejemplo: ABCD1234XYZ
os_type
obligatorio		El tipo de sistema operativo de la App.

Tipo: enum

Valores posibles: IOS, ANDROID
click_window
opcional		La ventana de clic para este evento, en días.

Tipo: int

Predeterminado: 14
Valores posibles: 1, 7, 14, 30
extra_device_ids
opcional		Un SHA256 del SHA1 del id del dispositivo pasado en hashed_device_id, más cualquier id de dispositivo adicional con hash.

Tipo: string

Ejemplo: ABCD1234XYZ, DCBA4321XYZ
non_twitter_engagement_time
opcional		La hora de la última interacción fuera de X previa a la conversión.

Tipo: string

Ejemplo: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type
opcional		El tipo de interacción fuera de X previa al evento de conversión.

Tipo: enum

Valores posibles: CLICK, VIEW
view_through_window
opcional		La ventana de visualización atribuida para este evento, en días.

Tipo: int

Predeterminado: 1
Valores posibles: 0, 1, 7, 14, 30
Ejemplo de solicitud
GET https://ads-api.x.com/12/95?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=0
Ejemplo de respuesta
    {
      data:{
        "app_id":"333903271",
        "os_type":"IOS",
        "hashed_device_id":"ABCD1234XYZ",
        "conversion_type":"INSTALL",
        "partner_client_id":"123abc",
        "conversion_time":"2013-04-16T07:00:00.123Z",
        "click_window":14,
        "view_through_window":0,
        "extra_device_ids":null,
        "twitter_attribution":{
          "engagement_type":"VIEW",
          "engagement_time":"2013-04-16T07:00:00.123Z",
          "country_code":"US",
          "tweet_id":"383034667764441088",
          "attribution_type":"PROMOTED",
          "promoted_properties":{
            "campaign_id”: “54a21",
            "campaign_name":"Vine_Contest",
            "line_item_id":"23ab2d4"
          }
        }
      },
      "data_type":"conversion_attribution",
      "request":{
        "params":{
          "app_id":"333903271",
          "os_type":"IOS",
          "hashed_device_id":"ABCD1234XYZ",
          "conversion_time":"2013-04-16T07:00:00.123Z",
          "conversion_type":"INSTALL",
          "click_window":14,
          "view_through_window":0
        }
      }
    }