Para obtener la información más actualizada sobre las versiones históricas de la X Ads API, consulta la siguiente información.
| Versión | Ruta | Fecha de introducción | Fecha de obsolescencia | Fecha de fin de vida útil |
|---|
| 12.0 | /12/ | 27 de octubre de 2022 | Por definir | Por definir |
| 11.0 | /11/ | 31 de marzo de 2022 | Por definir | Por definir |
| 10.0 | /10/ | 31 de agosto de 2021 | 31 de marzo de 2022 | 27 de octubre de 2022 |
| 9.0 | /9/ | 2 de marzo de 2021 | 31 de agosto de 2021 | 31 de marzo de 2022 |
| 8.0 | /8/ | 8 de septiembre de 2020 | 2 de marzo de 2021 | 31 de agosto de 2021 |
| 7.0 | /7/ | 3 de marzo de 2020 | 1 de septiembre de 2020 | 2 de marzo de 2021 |
| 6.0 | /6/ | 28 de agosto de 2019 | 3 de marzo de 2020 | 1 de septiembre de 2020 |
| 5.0 | /5/ | 28 de febrero de 2019 | 28 de agosto de 2019 | 3 de marzo de 2020 |
| 4.0 | /4/ | 28 de agosto de 2018 | 28 de febrero de 2019 | 28 de agosto de 2019 |
| 3.0 | /3/ | 1 de febrero de 2018 | 28 de agosto de 2018 | 28 de febrero de 2019 |
| 2.0 | /2/ | 10 de julio de 2017 | 1 de febrero de 2018 | 1 de agosto de 2018 |
| 1.0 | /1/ | 31 de marzo de 2016 | 7 de julio de 2017 | 10 de enero de 2018 |
| 0.0 | /0/ | 21 de febrero de 2013 | N/D | 31 de octubre de 2016 |
-
Eliminar un parámetro de la solicitud/respuesta de la API
-
Modificar el nombre de cualquier parámetro o endpoint
-
Cambio en la representación de valores (preview_url → card_uri)
-
Cambio en el comportamiento de los endpoints (p. ej., estadísticas asíncronas vs. síncronas)
-
Agregar/modificar parámetros opcionales u obligatorios (p. ej., hacer que name sea un campo obligatorio en la solicitud)
Deprecación: Las versiones o productos obsoletos no tendrán soporte y se recomienda que los desarrolladores dejen de usar estas APIs.
Retiro: Una vez que un producto o API se retire, el conjunto correspondiente de endpoints ya no será accesible a través de la API.
Los principios clave de la estrategia son:
-
Todos los cambios disruptivos se agruparán en una nueva versión
-
El periodo de depreciación para las versiones existentes cuando se anuncia una nueva versión es de 6 meses
-
En cualquier momento, la API permitirá solicitudes de dos versiones simultáneamente; sin embargo, la más antigua de las dos no tendrá soporte
-
Para agilizar la adopción de nuevos productos, estos se lanzarán de forma continua (fuera de la cadencia de versionado)
-
Todas las respuestas de la API incluirán un
x-current-api-version, que se establecerá en la versión actual de la API, además de un encabezado x-api-warn al llamar a cualquier endpoint de la API en desuso.
Si hubiera cambios fundamentales en los requisitos del producto que exigieran un cambio disruptivo en la API (p. ej., retirar la segmentación por múltiples grupos de edad), enviaremos un aviso con 90 días de antelación para anunciar este cambio; y, transcurridos al menos 90 días desde la publicación del aviso, se implementará el cambio.
Hoy, 3 de marzo de 2021, la versión 9 (v9) de la X Ads API ya está disponible. Esta versión está diseñada para aumentar la paridad de funcionalidades, simplificar la creación de campañas e introducir actualizaciones clave en nuestros endpoints de Cards y Mobile App Promotion.
Como en nuestras versiones anteriores, habrá un período de transición de 6 meses para migrar a v9. El 31 de agosto de 2021, la versión 8 (v8) de la Ads API dejará de estar disponible. Recomendamos a todos los desarrolladores migrar a la versión más reciente de la Ads API lo antes posible para evitar cualquier interrupción del servicio.
Nota: A partir de esta versión, la versión 7 (v7) de la Ads API ha llegado al final de su vida útil y ya no está disponible.
accounts/:account_id/account_media han quedado obsoletos.
Como en versiones anteriores, habrá un periodo de transición de 6 meses para migrar a v5. El 2019-08-28, la versión 4 de la Ads API dejará de estar disponible. Recomendamos a todos los partners migrar a la versión más reciente de la API lo antes posible para evitar cualquier interrupción del servicio. La versión 3 de Ads API ha llegado al final de su vida útil y ya no está disponible.
Determinar qué entidades estuvieron activas
El endpoint Active Entities indica si las métricas de analítica para entidades de anuncios han cambiado. Diseñado para usarse junto con los endpoints de analítica, Active Entities funciona especificando un tipo de entidad y un rango de fechas —un máximo de 90 días— y devuelve un array de IDs de entidades para las que tu plataforma debería solicitar analíticas. No se deben consultar IDs distintos de los devueltos en solicitudes de analítica posteriores.
Este endpoint admite los siguientes tipos de entidad: CAMPAIGN, FUNDING_INSTRUMENT, LINE_ITEM, MEDIA_CREATIVE y PROMOTED_TWEET.
Estadísticas de MEDIA_CREATIVE
Los endpoints de analítica de Ads API ahora proporcionan métricas para entidades de Media Creative. Los Media Creatives son la forma en que se promocionan anuncios in-stream o imágenes en X Audience Platform. La UI de X Ads muestra las métricas de Media Creative en las pestañas “In-stream videos” y “Display creatives”. Tanto los endpoints de analítica síncronos como asíncronos ahora admiten el enum de entidad MEDIA_CREATIVE.
Obtener varias cards
Mejorando la versión v3 del endpoint diseñado para recuperar una sola card por su valor de card URI, ahora es posible obtener varias cards usando el endpoint GET accounts/:account_id/cards/all. Ahora, en lugar de hacer una solicitud por cada card, puedes recuperar hasta 200 cards en una sola solicitud.
Dos cosas a tener en cuenta:
- La ruta URL ahora es
accounts/:account_id/cards/all. (La ruta anterior ya no está disponible). Esto es para mantener la consistencia con el endpoint diseñado para recuperar una card por ID.
- El parámetro de solicitud obligatorio ahora se llama card_uris (plural).
Flexibilidad en la recuperación
El endpoint GET accounts/:account_id/targeting_criteria ahora admite múltiples IDs de line item. El parámetro line_item_ids, que acepta hasta 200 IDs, es obligatorio. Anteriormente, solo se aceptaba un único line item, lo que dificultaba la sincronización. Con este cambio, ahora es posible recuperar más segmentaciones en menos tiempo.
Los siguientes endpoints ahora también admiten múltiples IDs de line item, aunque el parámetro line_item_ids es opcional para estos.
Obtención de campañas y partidas en borrador
Se ha actualizado la forma de obtener las campañas y las partidas en borrador. Ahora, el parámetro with_draft (boolean), cuando se establece en true, devuelve entidades en borrador y no en borrador por igual. Esto es coherente con la forma en que se obtienen las entidades eliminadas (p. ej., usando with_deleted). Anteriormente, para obtener tanto entidades en borrador como no en borrador se requerían al menos dos solicitudes. Ahora puede hacerse en una sola llamada a la API.
| v4 | v5 |
| :--- | :--- | :--- |
| draft_only | with_draft | |
Segmentación por duración de activación de la red
La Ads API ha resuelto un problema de visualización por el cual, tras agregar la segmentación de duración de activación de la red, el tipo de segmentación en la respuesta incluía el sufijo _IN_SEC. Hacer referencia a segundos resultaba confuso, ya que la duración de activación de la red siempre se representa en meses. Esta corrección unifica la representación y reduce la confusión.
| v4 | v5 |
| :--- | :--- | :--- |
| NETWORK_ACTIVATION_DURATION_IN_SEC | NETWORK_ACTIVATION_DURATION | |
Recuentos totales y cursores
En v5, with_total_count y cursor son mutuamente excluyentes. Especificar ambos en una solicitud devolverá el código de error EXCLUSIVE_PARAMETERS. Antes de v5, with_total_count se ignoraba cuando se especificaba cursor. Este cambio hace explícita la relación.
Se están eliminando tres fields de las respuestas de Ads API: preview_url, account_id y parent_ids. El nivel de esfuerzo de ingeniería para estos tres es mínimo.
- En v4, se anunció que el parámetro de respuesta preview_url para las cards siempre era null. El paso final en esta migración es eliminar preview_url de todas las respuestas de cards.
- El atributo de respuesta account_id se está eliminando para los siguientes recursos, dado que el id de la cuenta de anuncios ya está presente tanto en la URL como en request.params. (Es intencional excluir los instrumentos de financiación de esta lista, ya que los parent IDs deberían estar presentes en los objetos de respuesta, cuando sea posible, y los account IDs son entidades padre de los instrumentos de financiación).
- Medios de la cuenta
- Proveedores de eventos de App
- Etiquetas de eventos de App
- Campañas
- Cards
- Line items
- Usuarios promocionables
- Criterios de segmentación
- Para las solicitudes GET accounts/:account_id/targeting_criteria, ya no devolvemos el field parent_ids, ya que siempre era un array vacío.
App cards sin contenido multimedia
En v5, las app cards sin contenido multimedia ya no son compatibles. Anteriormente, se eliminó la capacidad de crear o editar app cards sin contenido multimedia. Ahora, los endpoints restantes para este recurso quedan obsoletos.
- Nota: Esto no afecta a las image y video app download cards.
Creaciones de medios de la cuenta
El endpoint POST accounts/:account_id/account_media ya no está disponible en v5. Otros endpoints para este recurso no se ven afectados. La razón de este cambio es que, al agregar contenido multimedia a la Media Library, hay casos en los que esos assets se agregan automáticamente como entidades de Account Media y tratar de agregar un asset ya existente al recurso Account Media da como resultado un error. Esto sucede en los siguientes casos.
- Los assets
AMPLIFY_VIDEO agregados a la Media Library se agregan automáticamente como asset de Account Media con el tipo de creativo PREROLL.
- Las imágenes con dimensiones específicas agregadas a la Media Library se agregan automáticamente como assets de Account Media. El tipo de creativo (p. ej.,
INTERSTITIAL) depende de las dimensiones de la imagen. (Para las dimensiones, consulta nuestra página de Enumerations.)
La versión 4 de la Ads API se lanza hoy, 28 de agosto de 2018.
Esta versión incluye mejoras en nuestro producto Audiences, incluida una nueva interfaz de API basada en un backend de procesamiento de audiencias más sólido. La versión 4 también incluye un conjunto de endpoints para gestionar la configuración de usuario, cuenta e impuestos. Además, los endpoints accounts/:account_id/videos quedarán obsoletos. Esta versión también incluye algunos cambios menores en los nombres de parámetros y de respuestas.
Al igual que con la versión 3, ofrecemos un período de transición de 6 meses. El 2019-02-28, la versión 3 de la Ads API ya no estará disponible. Recomendamos a todos los partners que migren a la versión más reciente de la API lo antes posible para evitar interrupciones del servicio. Consulta nuestra página de Versions para obtener detalles sobre nuestra estrategia de versionado.
Audience API
La nueva Audiences API está basada en nuestro nuevo backend de procesamiento de audiencias, que ofrece mayor solidez y fiabilidad. Este nuevo endpoint permitirá a los socios aportar varios tipos de identificadores para un mismo usuario, lo que nos permite usar señales adicionales para el emparejamiento. La documentación de referencia del nuevo endpoint de Audience está disponible aquí. Planeamos seguir publicando actualizaciones y mejoras de este producto durante el resto del año.
Los siguientes endpoints dejarán de estar disponibles en la v4 debido a funcionalidad redundante (seguirán funcionando en la v3 y se retirarán por completo cuando la v3 ya no esté disponible):
- TON Upload:
- GET accounts/:account_id/tailored_audience_changes
- GET accounts/:account_id/tailored_audience_changes/:tailored_audience_change_id
- POST accounts/:account_id/tailored_audience_changes
- PUT accounts/:account_id/tailored_audiences/global_opt_out
- Real Time Audiences:
- POST tailored_audience_memberships
Por último, el parámetro list_type se eliminará de la solicitud y la respuesta en todos los endpoints de Tailored Audiences en la versión 4.
Endpoints de configuración
Ahora ofrecemos la posibilidad de que los administradores de cuentas establezcan y actualicen la configuración de usuario, de cuenta y fiscal. La configuración de usuario corresponde a las preferencias de contacto específicas del usuario para una cuenta de anuncios determinada. Con el endpoint PUT accounts/:account_id, los anunciantes ahora pueden actualizar el nombre de su cuenta y el sector. Por último, los endpoints de configuración fiscal permiten a los anunciantes en países donde se aplica el impuesto al valor agregado (IVA) actualizar información como el nombre de la empresa, la dirección, el ID de IVA y si la cuenta pertenece al anunciante o a una agencia que anuncia en su nombre.
Cambios
Cambios de nombre en Universal Lookalike
Estamos actualizando los valores del enum del parámetro lookalike_expansion en los endpoints POST accounts/:account_id/line_items y PUT accounts/:accountit/line_items/:line_item_id.
| v3 | v4 |
|---|
NARROW | DEFINED |
BALANCED | EXPANDED |
country_code en todos los casos
Como parte de un esfuerzo mayor por la consistencia en el Ads API, estamos cambiando los nombres de los parámetros en los siguientes endpoints de app_country_code a country_code.
Esto no afecta el comportamiento ni los valores aceptados de estos parámetros; es únicamente un cambio de nombre.
preview_url siempre null
Como se prometió en el anuncio de v3, todas las tarjetas existentes ahora tienen un card_uri. Como resultado, el valor de preview_url siempre será null.
Como recordatorio, asocia una tarjeta con un Tweet usando su valor card_uri. Consulta el siguiente ejemplo de solicitud.
$ twurl -X POST -H ads-api.x.com “/4/accounts/18ce54d4x5t/tweet?text=Version 4&card_uri=card://958225772740714496”
Eliminado
Endpoints de video
Los endpoints accounts/:account_id/videos ya no estarán disponibles en v4. Este endpoint ha quedado obsoleto con la introducción de los endpoints de Media Library. Consulta la siguiente comparación de uso.
-
Endpoint de videos en v3:
twurl -H ads-api.x.com "/3/accounts/18ce54d4x5t/videos"
-
Endpoint de Media Library en v4 para videos:
twurl -H ads-api.x.com "/4/accounts/18ce54d4x5t/media_library?media_type=VIDEO"
Los endpoints de Media Library tienen paridad total con los endpoints de videos y también admiten funcionalidades adicionales, como la capacidad de manejar imágenes y GIF. Se solicita a los partners que utilicen exclusivamente Media Library para cualquier gestión de medios.
as_user_id en vista de Tweet
El parámetro as_user_id disponible en el endpoint GET accounts/:account_id/tweet/preview/:tweet_id ya no será aceptado. La vista previa siempre se mostrará como el autor del Tweet.
La versión 3 de Ads API se lanzó el 1 de febrero de 2018. La versión 2 de Ads API alcanzará su fin de vida útil el 1 de agosto de 2018.
Esta versión incluye nuestro nuevo producto Audience Intelligence, acceso a la Media Library y flujos de trabajo de cards mejorados. También anunciamos la retirada del endpoint PUT accounts/:account_id/targeting_criteria. Por último, la versión 3 incluye algunos cambios menores en parámetros y respuestas, y un límite más bajo para el tamaño de los lotes.
Como con la versión 2, damos a los partners 6 meses para la transición. El 2018-08-01, la v2 de Ads API se desactivará. Recomendamos a todos los partners y desarrolladores migrar a la v3 lo antes posible.
Audience Intelligence
Audience Intelligence ofrece información en tiempo real sobre los principales hashtags, @handles y eventos más relevantes para una audiencia determinada de X. Por ejemplo, ingresa Male 18-34 en EE. UU. y verás #nintendoswitch, #cardinal y @ricegum como tendencias entre esta audiencia.
Los endpoints de Audience Intelligence proporcionarán la siguiente funcionalidad:
- Dada una audiencia de entrada, obtener los principales hashtags, @handles y eventos relevantes.
- Dada una audiencia de entrada, obtener información demográfica clave (como edad, género e ingresos del hogar).
- Dada una palabra clave, obtener la serie temporal del volumen de Tweets
Media Library
La Media Library permite administrar imágenes, GIF y videos para cuentas de anuncios. Estos objetos multimedia pueden usarse en Tweets y para crear cards. También pueden reutilizarse en múltiples creatividades, lo que elimina la necesidad de cargar el mismo recurso varias veces.
Los objetos de la biblioteca se identifican mediante un media_key. Las media keys son valores de cadena con el siguiente formato, por ejemplo: 13_875943225764098048. En Ads API, estamos avanzando hacia el uso de media keys para todos los medios.
Flujo de trabajo de cards mejorado
Todos nuestros endpoints de cards ahora admiten media keys. Esto permite usar objetos de la Media Library para crear o actualizar cards.
Además, presentamos dos nuevos endpoints para recuperar detalles de cards. Estos endpoints pueden usarse para buscar cards utilizadas en Tweets o Tweets programados, por ejemplo, especificando la card_uri o el id. Anteriormente, esto no era posible.
Además de estas nuevas funciones, incluimos los siguientes cambios en la versión 3.
Nuevo
- La respuesta del endpoint GET insights/keywords/search ahora incluye un atributo related_keywords con 30 términos relacionados con las palabras clave de entrada.
Cambiado
- El tamaño máximo del lote de criterios de segmentación ahora es 500.
- Los atributos de respuesta card_uri y preview_url ahora son mutuamente excluyentes. Cuando una card tiene un card_uri, el preview_url será null. Cuando una card no tiene un card_uri, solo se devolverá el preview_url.
- Todas las cards creadas a partir de 2018-01-29 tendrán un card_uri.
- Para la versión 4, todas las cards existentes tendrán un card_uri.
- Ya no es posible crear cards con imágenes 5:2. Si bien las cards existentes con imágenes 5:2 seguirán funcionando, recomendamos a los partners cambiar al uso de relaciones de aspecto de mayor rendimiento (1.91:1 o 1:1, donde estén disponibles).
Eliminado
- El endpoint PUT accounts/:account_id/targeting_criteria ya no está disponible. Decidimos realizar este cambio porque el comportamiento de reemplazo con este endpoint causaba confusión entre los anunciantes y no era consistente con nuestros otros endpoints PUT que actualizan un único recurso a la vez. En su lugar, los partners deben usar el endpoint POST batch/accounts/:account_id/targeting_criteria, que ofrece mayor flexibilidad, incluida la capacidad de agregar y eliminar segmentaciones en una sola solicitud.
- El atributo de respuesta paused ya no se devuelve para los instrumentos de financiación. En su lugar, consulta el atributo de respuesta entity_status para determinar si un instrumento de financiación está en pausa o no. Además, debido a que paused y cancelled corresponden al mismo valor, cancelled tampoco se devuelve en la respuesta.
- Hemos eliminado el parámetro card_id del endpoint GET accounts/:account_id/tweet/preview.
- Debido a que no es posible recuperar Tweets programados eliminados, el parámetro with_deleted ya no es compatible.
- El parámetro draft_only se ha eliminado de los siguientes endpoints, ya que estas entidades nunca pueden estar en estado de borrador:
Nota
Tanto las Video Website Cards como los Tweets programados han salido de beta. Consulta este hilo para conocer los cambios que hemos realizado en los Tweets programados desde el lanzamiento. Esto incluye la posibilidad de generar vistas previas en HTML para los Tweets programados: previews.
La versión 2 de Ads API se lanzó el 10 de julio de 2017. La versión 1 de Ads API llegará al final de su vida útil el 10 de enero de 2018.
Cambios incompatibles/Deprecaciones¶
-
total_count ahora es un atributo de respuesta opcional. Solo estará disponible si with_total_count se establece en true
-
Los campos
paused y draft_only en los objetos de solicitud y respuesta de line_items y campaigns se sustituyen por un único parámetro entity_status
-
El parámetro
status pasa a llamarse text en los endpoints POST accounts/:account_id/tweet y GET accounts/:account_id/tweet/preview
-
Los enumerados
location_type del endpoint GET targeting_criteria/locations ahora están en plural. COUNTRY ahora es COUNTRIES, REGION ahora es REGIONS, y así sucesivamente. La única excepción es que, en v2, CITY ahora es METROS, para reflejar correctamente que el tipo de ubicación se refiere a Designated Marker Areas (DMAs) o “áreas metropolitanas”.
-
display_properties en los endpoints PUT accounts/:account_id/promoted_tweets. Este valor tampoco se devolverá como parte de la respuesta
-
Como resultado del punto anterior, ya no es posible actualizar (PUT) entidades promoted_tweets
-
Se ha eliminado el parámetro
line_item_id en el endpoint GET accounts/:account_id/promoted_tweets
-
Ya no será posible crear Website Cards 5:2 en los endpoints de v2
-
El atributo de respuesta
data_type ya no se devuelve
Nuevas funciones¶
- Cards v2
- Creación y activación de campañas/bloques de anuncios en borrador
- Tweets programados
- Resúmenes de trabajos asíncronos
Cards v2¶
- Se debe usar el parámetro de solicitud
card_uri en lugar de anexar el preview_url al texto del Tweet al asociar una card con un Tweet
- Si el parámetro
card_uri no se devuelve en la respuesta (durante el paso de creación de la card), entonces use preview_url
- Todos los nuevos formatos de card estarán disponibles de forma nativa en la API, aprovechando el parámetro
card_uri.
Nuevos formatos de Card:¶
Campañas en borrador¶
Las campañas en borrador se han podido consultar a través del endpoint GET accounts/:account_id/camapaigns. Con v2, ahora es posible crear y activar campañas en borrador mediante la API.
| Campaña en borrador | Elemento de línea en borrador |
|---|
funding_instrument_id | campaign_id |
name | objective |
start_time | product_type |
| placements |
- Los elementos de línea o campañas en borrador solo pueden convertirse de un
entity_status de DRAFT a PAUSED o ACTIVE.
- Para activar una campaña completa (con múltiples elementos de línea), cada elemento de línea de la campaña, así como la campaña en sí, debe configurarse con un
entity_status de ACTIVE.
- Para cambiar el
entity_status de cualquier campaña o elemento de línea, usa el endpoint PUT correspondiente.
Tweets programados¶
-
Los Tweets programados constan de los siguientes endpoints nuevos
-
Tweets programados:
-
Gestión de campañas:
-
Los Tweets programados nuevos pueden programarse para cualquier fecha futura.
-
Actualmente no es posible previsualizar un Tweet programado.
-
Solo los Tweets programados en el estado
SCHEDULED pueden editarse o eliminarse.
-
Los Tweets programados no se propagan al Firehose empresarial ni a ninguna otra API de datos hasta la fecha y hora
scheduled_at.
La versión 1 de la Ads API se lanzó el 31 de marzo de 2016 y alcanzará el fin de su vida útil el 10 de enero de 2018.
Cambios en la versión 1:¶
- Compatibilidad con versiones
CUSTOM objective ya no es compatible- Endpoints por lotes ya están disponibles de forma general
- Cambios en la estimación del alcance:
- Para ofrecer una mejor estimación del alcance, el endpoint ahora tiene en cuenta el presupuesto. Los siguientes parámetros ahora son obligatorios:
- [nuevo]
campaign_daily_budget_amount_local_micro
currencybidobjective
- El objeto de respuesta ha cambiado y ahora devuelve intervalos para los valores de la respuesta.
infinite_count ha pasado a llamarse infinite_bid_count para evitar confusiones sobre su propósito- Además de
count e infinite_bid_count, ahora se devolverán estos nuevos puntos de datos:
impressionsengagementsestimated_daily_spend_local_micro
- Cambio de tipo de dato para audiencias personalizadas
- El
data_type de Tailored Audiences se ha cambiado de tailored_audiences a tailored_audience en todas nuestras respuestas.
- Las Audiencias Personalizadas Compartidas ahora están disponibles como una beta exclusiva de API. Las audiencias personalizadas compartidas permiten usar una única audiencia en varias cuentas publicitarias. Usa el endpoint POST accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions (y los relacionados) para gestionar los permisos de una audiencia personalizada que quieras compartir entre cuentas publicitarias.
- Mejoras importantes en la forma de recopilar analíticas de rendimiento para cuentas de anunciantes:
- Para alinearnos con nuestras mejores prácticas, a partir de ahora solo permitiremos extraer datos por un máximo de 7 días para los endpoints de estadísticas síncronas.
- Para simplificar la obtención de métricas, hemos reemplazado el parámetro
metrics por un nuevo parámetro metric_groups. Los desarrolladores simplemente deben indicar qué grupos de métricas desean que se devuelvan para una solicitud determinada.
- Cualquier solicitud de métricas que no correspondan a una entidad determinada se excluirá de la respuesta y se mostrará como valores
null. Estas métricas no contarán para tu límite de costos de analytics.
- La respuesta se ha simplificado considerablemente y ahora se ajustará más estrechamente a cómo mostramos las métricas en nuestra interfaz.
- Anteriormente publicábamos una métrica independiente para cada ubicación de publicación (Promoted Tweets in Search, Promoted Tweets in Timelines, Promoted Tweets in Profiles & Tweet Details, X Audience Platform). Ahora devolveremos un conjunto estandarizado de métricas para cada una (en lugar de
promoted_tweet_timeline_impressions, promoted_tweet_search_impressions, promoted_tweets_profile_impressions, promoted_tweets_tpn_impressions), que se expondrán, cuando se soliciten dentro de una de las siguientes categorías, como una única métrica: impressions (esto aplica a todas las métricas):
ALL_ON_TWITTERPUBLISHER_NETWORK- Al hacer una solicitud, recibirás una única métrica
impressions, lo que simplifica la conciliación de valores con nuestra interfaz.
- Debes realizar dos consultas para obtener los datos de
ALL_ON_TWITTER y PUBLISHER_NETWORK, ya que no se pueden combinar.
- ¡Los endpoints de estadísticas asíncronas ya están disponibles, gracias a los comentarios de nuestros desarrolladores!
- Un nuevo conjunto de endpoints para solicitar estadísticas de forma asíncrona, para datos que no necesitas de inmediato o para extracciones de datos históricos.
- Encola un trabajo de estadísticas usando un único endpoint nuevo. Extraeremos los datos que has solicitado según lo permitan los recursos.
- Puedes consultar un endpoint de estado del trabajo para determinar si los datos están disponibles.
- Una vez que los datos estén disponibles, proporcionaremos un id de recogida para que descargues la respuesta JSON, que reflejará la respuesta del endpoint síncrono.
- Consulta hasta 90 días de datos sobre hasta 20 entidades en un único trabajo.
- Consulta nuestra guía de migración a analytics v1, que incluye el mapeo de métricas de v0 a v1
- Mejoras del Sandbox * Ahora puedes crear varias cuentas de anuncios de prueba en el entorno de Sandbox. * Ahora puedes crear varios instrumentos de financiación para una cuenta de anuncios de prueba únicamente en el entorno de Sandbox. Esto te permite probar todos nuestros tipos de instrumentos de financiación. Antes, solo había disponible una fuente de financiación
CREDIT_CARD para realizar pruebas. * ¿Quieres probar una función beta? Ahora puedes activar o desactivar funciones para una cuenta en el entorno de Sandbox para adaptarlas a tus necesidades de prueba.
La versión 0 de la Ads API se lanzó oficialmente el 21 de febrero de 2013 y tuvo soporte hasta el 31 de octubre de 2016.
Todos los endpoints de análisis de la versión 0 están obsoletos y dejarán de estar disponibles después del 31 de octubre de 2016. Estos endpoints se han sustituido por 3 endpoints de análisis en la versión 1.
El endpoint de estimación de alcance presenta un comportamiento nuevo en la versión 1. 
