Conversiones móviles

​

Descripción general de MACT

La medición de promoción de aplicaciones 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 aplicación. Un socio de medición móvil de X ofrece a un anunciante la posibilidad de gestionar qué conversiones desea medir desde las aplicaciones que está promocionando en X. Una vez que el anunciante haya configurado el type y las ventanas temporales de los eventos que quiere 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 la pieza creativa con las que interactuó el usuario y que generaron la conversión.

​

Eventos de conversión

Para poder reportar un evento de conversión a X y obtener datos de atribución, el partner debe enviar el ID de la app móvil, el tipo y la marca de tiempo de la conversión, así como un valor con hash del ID de publicidad/dispositivo. Proporcionar estos datos registrará el evento de conversión en la plataforma de X y devolverá la atribución cuando corresponda. Además, el anunciante puede elegir proporcionar metadatos adicionales sobre el evento de conversión, como el valor de una compra, el ID de un producto o un método de registro.

​

Referencia de la API

​

Evento de conversión

​

POST conversion_event

Registra un evento de conversión de medición móvil. La respuesta indicará la atribución de X o de X Audience Platform (TAP).

Este endpoint está relacionado con GET conversion_attribution.

En la respuesta se asignará atribución de X, de TAP o ninguna atribución. El nodo twitter_attribution siempre estará presente y tendrá un valor de null cuando no haya atribución de X (consulta el ejemplo de respuesta a continuación). Si se asigna atribución de TAP, estará presente un nodo tpn_attribution y se rellenará en consecuencia. Consulta la descripción general de 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 tienen ningún efecto en los cálculos de atribución.

URL del recurso

https://ads-api.x.com/12/conversion_event

Parámetros

Nombre	Descripción
app_id required	El identificador único correspondiente en la tienda de aplicaciones. Tipo: int, string Ejemplo: 333903271, com.vine.android
conversion_time required	La hora del evento de conversión en formato de marca de tiempo ISO-8601, con milisegundos añadidos. Tipo: string Ejemplo: 2014-05-22T02:38:28.103Z
conversion_type required	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 required	El IDFA o AdID con hash HMAC_SHA-256. Tipo: string Ejemplo: ABCD1234XYZ
os_type required	El tipo de sistema operativo (OS) para la aplicación. Tipo: enum Valores posibles: IOS, ANDROID
click_window optional	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 optional	Dirección IPv4 o IPv6 del dispositivo cuando ocurrió el evento de conversión. Tipo: string Ejemplo: 192.133.78.1
level optional	Un nivel asociado a este evento. Tipo: int Ejemplo: 2
non_twitter_engagement_time optional	La hora de la última interacción fuera de X antes de la conversión. Tipo: string Ejemplo: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type optional	El tipo de interacción fuera de X previa al evento de conversión. Tipo: enum Valores posibles: CLICK, VIEW
number_items optional	Número de elementos asociados a este evento. Tipo: int Ejemplo: 2
price_currency optional	Se espera que sea un código ISO 4217 que indique la moneda asociada con este evento. Tipo: string Ejemplos: EUR, USD, JPY
price_micro optional	Un importe asociado a este evento en microunidades. Tipo: int Ejemplo: 123450000
user_payment_info optional	Un valor booleano que indica si la información de pago del usuario está almacenada en la aplicación asociada con este evento. Tipo: bool Valores posibles: true o false
view_through_window optional	La ventana de visualización (view-through) 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 App

​

GET accounts/:account_id/app_event_tags

Obtiene los detalles de algunas o todas las etiquetas de eventos de app asociadas a la cuenta actual.

Estas etiquetas son las que definen las ventanas de conversión configuradas para cada tipo de conversión en Mobile App Conversion Tracking.

URL del recurso

https://ads-api.x.com/12/accounts/:account_id/app_event_tags

Parámetros

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece dentro de la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excluyendo GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado. Type: string Example: 18ce54d4x5t
app_event_tag_ids optional	Limita la respuesta solo a las etiquetas de eventos de App deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 IDs. Type: string Example: jhp
count optional	Especifica la cantidad de registros que se intentará recuperar por cada solicitud independiente. Type: int Default: 200 Min, Max: 1, 1000
cursor optional	Especifica un cursor para obtener la siguiente página de resultados. Consulta Pagination para obtener más información. Type: string Example: 8x7v00oow
sort_by optional	Ordena por un atributo compatible en orden ascendente o descendente. Consulta Sorting para obtener más información. Type: string Example: created_at-asc
with_deleted optional	Incluye resultados eliminados en tu solicitud. Type: boolean Default: false Possible values: true, false
with_total_count optional	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 tasa más bajos, actualmente establecidos en 200 por cada 15 minutos. Type: boolean Default: false Possible values: 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

Obtiene una etiqueta de evento de app específica asociada con 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

Nombre	Descripción
account_id required	El identificador de la cuenta utilizada. Aparece en la ruta del recurso y generalmente 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. Type: string Example: 18ce54d4x5t
app_event_tag_id required	Una referencia a la etiqueta de evento de App que se utiliza en la solicitud. Type: string Example: jhp
with_deleted optional	Incluir los resultados eliminados en la solicitud. Type: boolean Default: false Possible values: 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

Nombre	Descripción
account_id required	El identificador de la cuenta utilizada. 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. Type: string Example: 18ce54d4x5t
app_store_identifier required	El identificador de la tienda de aplicaciones. Type: string Example: com.twitter.android
conversion_type required	El tipo de evento de conversión. Type: enum Possible values: 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 required	El tipo de sistema operativo de la app. Type: enum Possible values: IOS, ANDROID
provider_app_event_id required	El ID de la etiqueta de conversión en el sitio del proveedor. Type: string Example: provider_tag_j5394
provider_app_event_name required	El nombre de la etiqueta de conversión en el sitio del proveedor. Type: string Example: provider_name_a4382
deep_link_scheme optional	Especifica el URI de deep link para la app asociada con esta etiqueta. Type: string Example: twitter://
post_engagement_attribution_window optional	La ventana de atribución post-engagement para estos eventos. Type: int Default: 30 Possible values: 1, 7, 14, 30
post_view_attribution_window optional	La ventana de atribución posterior a la visualización para estos eventos. Type: int Default: 1 Possible values: 0, 1, 7, 14, 30
retargeting_enabled optional	Especifica si se debe habilitar el retargeting para esta etiqueta de evento de app. Type: boolean Default: true Possible values: 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 aplicación especificada asociada a la cuenta actual.

URL del recurso

https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:id

Parámetros

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece en la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, salvo GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado. Tipo: string Ejemplo: 18ce54d4x5t
id required	Una referencia a la etiqueta de evento de App con la que estás trabajando en la solicitud. Tipo: string Ejemplo: jhp

Ejemplo de solicitud

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

Respuesta de ejemplo

    {
      "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 los detalles de algunas o todas las listas de Apps asociadas a la cuenta actual.

URL del recurso

https://ads-api.x.com/12/accounts/:account_id/app_lists

​

Parámetros

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece dentro de 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 optional	Limita la respuesta únicamente a las listas de apps deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 IDs. Tipo: string Ejemplo: wm7x
count optional	Especifica la cantidad de registros que se intentará recuperar por cada solicitud. Tipo: int Predeterminado: 200 Mín., Máx.: 1, 1000
cursor optional	Especifica un cursor para obtener la página siguiente de resultados. Consulta Pagination para más información. Tipo: string Ejemplo: 8x7v00oow
sort_by optional	Ordena por un atributo compatible en orden ascendente o descendente. Consulta Sorting para más información. Tipo: string Ejemplo: created_at-asc
with_deleted optional	Incluye resultados eliminados en tu solicitud. Tipo: boolean Predeterminado: false Valores posibles: true, false
with_total_count optional	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 tasa 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/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

Obtiene una lista de aplicaciones 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

Nombre	Descripción
account_id obligatorio	El identificador de la cuenta utilizada. Aparece dentro de 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. Type: string Example: 18ce54d4x5t
app_list_id obligatorio	Una referencia a la lista de apps con la que estás operando en la solicitud. Type: string Example: 28ukf
with_deleted opcional	Incluye resultados eliminados en tu solicitud. Type: boolean Default: false Possible values: 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 existe 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

Name	Description
account_id required	El identificador de la cuenta utilizada. 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. Type: string Example: 18ce54d4x5t
app_store_identifiers required	Los identificadores de la tienda de aplicaciones que se incluirán en la app_list Type: string Example: com.twitter.android
name required	El nombre que asignarás a la app_list Type: string Example: 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 aplicaciones especificada asociada a la cuenta actual.

URL del recurso

https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id

Parameters

Name	Description
account_id required	El identificador de la cuenta utilizada. 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. Type: string Example: 18ce54d4x5t
app_list_id required	Una referencia a la lista de Apps con la que estás trabajando en la solicitud. Type: string Example: 28ukf

Ejemplo de solicitud

DELETE 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-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"
        }
      }
    }

​

Configuraciones del proveedor de eventos de la App

❯

​

GET accounts/:account_id/app_event_provider_configurations¶

Obtiene detalles de algunas o todas las configuraciones de proveedores de eventos de App (configuración básica para Mobile Application Conversion Tracking) relacionadas con la cuenta actual.

URL del recurso

https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations

Parameters

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece dentro de 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 optional	Especifica la cantidad de registros que se intentará recuperar por cada solicitud individual. Tipo: int Predeterminado: 200 Mín., máx.: 1, 1000
cursor optional	Especifica un cursor para obtener la página siguiente de resultados. Consulta Pagination para más información. Tipo: string Ejemplo: 8x7v00oow
ids optional	Limita la respuesta únicamente a las configuraciones deseadas especificando una lista de identificadores separados por comas. Se pueden proporcionar hasta 200 identificadores. Tipo: string Ejemplo: 25n
sort_by optional	Ordena por un atributo admitido en orden ascendente o descendente. Consulta Sorting para más información. Tipo: string Ejemplo: created_at-asc
with_deleted optional	Incluye resultados eliminados en tu solicitud. Tipo: boolean Predeterminado: false Valores posibles: true, false
with_total_count optional	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 tasa 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 principal para Mobile Application Conversion Tracking) asociadas a la cuenta actual.

URL del recurso

https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id

Parameters

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece dentro de 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. Type: string Example: 18ce54d4x5t
id required	Una referencia a la configuración del proveedor de eventos de App que usas en la solicitud. Type: string Example: 25n
with_deleted optional	Incluye los resultados eliminados en la solicitud. Type: boolean Default: false Possible values: 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 la aplicación asociada a la cuenta actual. Solo se puede asociar un proveedor MACT a una cuenta de anuncios determinada.

URL del recurso

https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations

Parámetros

Name	Description
account_id required	El identificador de la cuenta utilizada. Aparece dentro de la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes de la Advertiser API, excepto para GET accounts. La cuenta especificada debe estar asociada con el usuario autenticado. Tipo: string Ejemplo: 18ce54d4x5t
provider_advertiser_id required	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 de 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

Nombre	Descripción
account_id obligatorio	El identificador de la cuenta utilizada. Aparece dentro de la ruta del recurso y, por lo general, es un parámetro obligatorio para todas las solicitudes a 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 comprobar la atribución de conversiones sin registrar un evento de conversión. La respuesta indicará la atribución de X.

Esto está relacionado con el endpoint POST conversion_event.

En la respuesta se indicará atribución de X, TAP o ninguna atribución. 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 más abajo. Si se indica atribución de TAP, habrá un nodo tpn_attribution presente y se completará en consecuencia. Consulta la descripción general de TAP para obtener más información.

URL del recurso

https://ads-api.x.com/12/conversion_attribution

Parámetros

Nombre	Descripción
app_id required	El identificador único correspondiente en la tienda de aplicaciones. Tipo: int, string Ejemplo: 333903271, com.vine.android
conversion_time required	La hora del evento de conversión en formato de marca de tiempo ISO-8601, incluyendo milisegundos. Tipo: string Ejemplo: 2014-05-22T02:38:28.103Z
conversion_type required	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 required	El IDFA o AdID con hash HMAC_SHA-256. Tipo: string Ejemplo: ABCD1234XYZ
os_type required	El tipo de sistema operativo para la aplicación. Tipo: enum Valores posibles: IOS, ANDROID
click_window optional	La ventana de clic para este evento, en días. Tipo: int Valor predeterminado: 14 Valores posibles: 1, 7, 14, 30
extra_device_ids optional	Un SHA256 del SHA1 del ID de dispositivo enviado en hashed_device_id, más cualquier ID de dispositivo adicional con hash. Tipo: string Ejemplo: ABCD1234XYZ, DCBA4321XYZ
non_twitter_engagement_time optional	La hora de la última interacción fuera de X anterior a la conversión. Tipo: string Ejemplo: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type optional	El tipo de interacción fuera de X anterior al evento de conversión. Tipo: enum Valores posibles: CLICK, VIEW
view_through_window optional	La ventana de visualización para este evento, en días. Tipo: int Valor predeterminado: 1 Valores posibles: 0, 1, 7, 14, 30

Ejemplo de solicitud

GET https://ads-api.x.com/12/conversion_attribution?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
        }
      }
    }