Skip to main content
Para obtener la información más reciente sobre las versiones históricas de la Ads API de X, consulta la información a continuación.

​
Descripción general

Cada mes realizamos cambios y lanzamos varias funciones nuevas en la X Ads API. Estos cambios casi siempre son compatibles con versiones anteriores; sin embargo, solemos tener un puñado de cambios incompatibles cada año. Hemos recibido comentarios de desarrolladores sobre los desafíos que nuestro rápido ritmo de cambios en la Ads API supone para sus ciclos de desarrollo a la hora de implementar nuevas funciones, gestionar deprecaciones y probar cambios. Queremos mejorar la experiencia de los desarrolladores al usar nuestra plataforma de Ads, y por eso introdujimos el concepto de versionar nuestros endpoints. Algunas definiciones de los conceptos de los que hablamos: Versión: Se refiere al número de versión que se encuentra en la ruta de la URL de cualquier solicitud a la Ads API, por ejemplo: GET //accounts. Este estilo de versionado se conoce como versionado por URI. Cambios incompatibles: Los cambios incompatibles son cualquier cambio que requiera recursos de desarrollo para mantener la funcionalidad existente. Esto incluye recursos utilizados para investigar los cambios que deben realizarse, determinar las funciones/endpoints que se están deprecando y la implementación final de todos estos cambios. Una lista de cambios incompatibles incluye cosas como:
  • 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 (por ejemplo, estadísticas async vs sync)
  • Agregar/cambiar parámetros opcionales u obligatorios (por ejemplo, hacer que name sea un campo obligatorio en la solicitud)
Deprecación: Las versiones o productos en desuso dejarán de estar admitidos y se recomienda que los desarrolladores dejen de usar estas APIs. Retirada (sunset): Una vez que un producto o una API se retira (sunset), el conjunto correspondiente de endpoints dejará de ser accesible a través de la API.

​
Estrategia de versionado

Los principios principales de la estrategia son:
  1. Todos los cambios incompatibles se agruparán en una nueva versión
  2. El periodo de deprecación de las versiones existentes cuando se anuncie una nueva versión será de 6 meses
  3. En cualquier momento, la API permitirá solicitudes desde dos versiones simultáneamente; sin embargo, la más antigua de las dos no tendrá soporte
  4. Para facilitar una adopción más rápida de nuevos productos, estos se lanzarán de forma continua (fuera de la cadencia de versionado)
  5. Todas las respuestas de la API contendrá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 cuando se llamen endpoints de API en deprecación.
Si hubiera cambios fundamentales en los requisitos del producto que requirieran un cambio incompatible en la API (por ejemplo, deprecar la segmentación por varios grupos de edad), enviaremos un aviso con 90 días de antelación para anunciar este cambio incompatible y, después de al menos 90 días desde que se emita el aviso, se implementará el cambio incompatible.

​
v9

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 funciones, simplificar la creación de campañas e introducir actualizaciones clave en nuestros endpoints de Cards y Mobile App Promotion. Al igual que con nuestras versiones anteriores, habrá un periodo de transición de 6 meses para migrar a v9. El 31 de agosto de 2021, la versión 8 (v8) actual de la Ads API dejará de estar disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la Ads API lo antes posible para evitar interrupciones 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.
Para obtener todos los detalles, consulta el anuncio en el foro para desarrolladores.

​
v8

Hoy, 20 de septiembre de 2020, presentamos la versión 8 de la X Ads API, diseñada para introducir nueva funcionalidad de Tailored Audiences, aumentar la paridad de funcionalidades con ads.x.com y mejorar tu experiencia como desarrollador. Al igual que con versiones anteriores, habrá un período de transición de 6 meses para migrar a v8. A partir del 2021-03-02, la versión 7 de la Ads API ya no estará disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la API lo antes posible para evitar cualquier interrupción del servicio. Para más detalles, consulta el anuncio en el foro para desarrolladores.

​
v7

Hoy, 20 de marzo de 2020, presentamos la Versión 7 de la X Ads API, diseñada para aumentar la paridad de funciones con ads.x.com. Como en las versiones anteriores, habrá un período de transición de 6 meses para migrar a v7. El 1 de septiembre de 2020, la versión 6 de la Ads API dejará de estar disponible. Recomendamos a todos los desarrolladores que migren a la versión más reciente de la API lo antes posible para evitar cualquier interrupción del servicio. La versión 5 de la Ads API ha llegado al final de su vida útil y ya no está disponible. Para obtener todos los detalles, consulta el anuncio en el foro de desarrolladores.

​
v6

Hoy, 28 de agosto de 2019, X presenta Ads API v6, con actualizaciones centradas en la coherencia y en mejorar la experiencia de desarrollador. Esta versión incluye un nuevo endpoint para obtener Tweets, estadísticas para Promoted Accounts, la capacidad de buscar entidades por nombre e información sobre el número actual de trabajos asíncronos de analítica que se están procesando. Además, hemos realizado actualizaciones centradas en la coherencia en los endpoints que utilizan contenido multimedia y en nuestros endpoints de criterios de segmentación. Por último, hemos realizado pequeñas actualizaciones en algunos de nuestros nombres de parámetros y atributos de respuesta y estamos marcando como obsoleto el endpoint Scoped Timeline. Para obtener todos los detalles, consulta el anuncio en el foro para desarrolladores.

​
v5

Hoy, 28 de febrero de 2019, X presenta Ads API v5, con actualizaciones centradas en mejorar la escalabilidad y la eficiencia. Esta versión incluye un nuevo endpoint para determinar qué entidades estuvieron activas en un período de tiempo determinado, estadísticas para Media Creatives (es decir, videos in-stream e imágenes en la X Audience Platform), la capacidad de obtener múltiples cards por URI de la card y más flexibilidad para recuperar criterios de segmentación y otras entidades. Además, hemos corregido algunos bugs y realizado actualizaciones en los nombres de parámetros y atributos de respuesta. Por último, las app cards sin contenido multimedia y el endpoint POST accounts/:account_id/account_media se han declarado obsoletos. Como en versiones anteriores, habrá un período 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 socios que migren a la versión más reciente de la API tan pronto como sea posible para evitar cualquier interrupción del servicio. La versión 3 de la Ads API ha llegado al final de su vida útil y ya no está disponible.

​
Nuevo

Determinación de 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 utilizarse junto con los endpoints de analítica, Active Entities funciona especificando un tipo de entidad y un intervalo de fechas —un máximo de 90 días— y devuelve un array de IDs de entidad para los que tu plataforma debe solicitar analíticas. No se deben consultar IDs distintos de los que se devuelven en solicitudes de analíticas 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 del Ads API ahora proporcionan métricas para entidades Media Creative. Los Media Creatives son la forma en que se promocionan los anuncios in-stream o las imágenes en la X Audience Platform. La interfaz 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 sincrónicos como asincrónicos 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 URI de card, ahora es posible obtener varias cards utilizando 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:
  1. La ruta de URL ahora es accounts/:account_id/cards/all. (La ruta anterior ya no está disponible.) Esto es para mantener la coherencia con el endpoint diseñado para recuperar una card por ID.
  2. 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 segmentación 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.

​
Changed

Recuperación de campañas y elementos de línea en borrador Se ha actualizado la forma en que se recuperan las campañas y los elementos de línea en borrador. Ahora, el parámetro with_draft(boolean), cuando se establece en true, devuelve tanto entidades en borrador como entidades que no están en borrador. Esto es coherente con la forma en que se recuperan las entidades eliminadas (es decir, usando with_deleted). Anteriormente, obtener tanto entidades en borrador como no en borrador requería al menos dos solicitudes. Ahora, esto se puede hacer en una sola llamada a la API. | v4 | v5 | | :--- | :--- | :--- | | draft_only | with_draft | | Segmentación por duración de activación de red La Ads API ha corregido un problema de visualización en el que, después de agregar la segmentación de Network Activation Duration, el tipo de segmentación en la respuesta incluía el sufijo _IN_SEC. Hacer referencia a segundos resultaba confuso, ya que Network Activation Duration siempre se representa en meses. Esta corrección hace que la representación sea coherente 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 exclusivos. 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 que la relación sea explícita.

​
Eliminados

Se están eliminando tres campos de las respuestas de Ads API: preview_url, account_id y parent_ids. El esfuerzo de ingeniería necesario 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 en la URL, así como en request.params. (Es intencional excluir los instrumentos de financiación de esta lista, ya que los id padre deberían estar presentes en los objetos de respuesta, cuando sea posible, y los id de cuenta son entidades padre de los instrumentos de financiación).
    • Medios de 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 campo parent_ids, ya que siempre era un array vacío.
Cards de App sin contenido multimedia En v5, las cards de App sin contenido multimedia ya no son compatibles. Anteriormente, se eliminó la capacidad de crear o editar cards de App sin contenido multimedia. Ahora, los endpoints restantes para este recurso se están descontinuando.
  • Nota: Esto no afecta a las cards de descarga de App de imagen y video.
Creación de medios de 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 recursos se agregan automáticamente como entidades de Account Media y, al intentar agregar un recurso ya existente al recurso Account Media, se produce un error. Esto ocurre en los siguientes casos:
  • Los recursos AMPLIFY_VIDEO agregados a la Media Library se agregan automáticamente como recursos de Account Media con el tipo creativo PREROLL.
  • Las imágenes con dimensiones específicas agregadas a la Media Library se agregan automáticamente como recursos de Account Media. El tipo creativo (por ejemplo, INTERSTITIAL) depende de las dimensiones de la imagen. (Para las dimensiones, consulta nuestra página de Enumerations.)

​
v4

La versión 4 de la Ads API se publica hoy, 28 de agosto de 2018. Esta versión incluye mejoras en nuestro producto de 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 administrar la configuración de usuario, cuenta e impuestos. Además, los endpoints accounts/:account_id/videos quedan obsoletos. Esta versión también incluye algunos cambios menores en nombres de parámetros y de respuestas. Al igual que con la versión 3, proporcionamos un período de transición de 6 meses. A partir del 2019-02-28, la versión 3 de la Ads API ya no estará disponible. Recomendamos a todos los socios que migren a la versión más reciente de la API tan pronto como sea posible para evitar cualquier interrupción del servicio. Consulta nuestra página de Versions para obtener detalles sobre nuestra estrategia de control de versiones.

​
Nuevo

Audience API La nueva Audiences API está basada en nuestro nuevo backend de procesamiento de audiencias, que ofrece mayor solidez y confiabilidad. Este nuevo endpoint permitirá a los socios proporcionar varios tipos de identificadores de usuario para un solo usuario, lo que significa que podremos usar señales adicionales para la asociación. La documentación de referencia para el nuevo endpoint de Audience se puede encontrar aquí. Planeamos seguir lanzando actualizaciones y mejoras de este producto durante el resto del año. Los siguientes endpoints dejarán de estar disponibles en v4 debido a funcionalidad redundante (seguirán funcionando en v3 y se retirarán por completo (sunset) cuando 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/:accounti_d/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. Settings Endpoints Ahora permitimos que los administradores de cuentas establezcan y actualicen la configuración de usuario, cuenta e impuestos. La configuración de usuario corresponde a las preferencias de contacto específicas del usuario para una cuenta de anuncios determinada. Mediante el endpoint PUT accounts/:account_id, los anunciantes ahora pueden actualizar el nombre de su cuenta y el tipo de industria. Por último, los endpoints de configuración de impuestos permiten a los anunciantes en países donde se cobra un 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 es propiedad del anunciante o de una agencia que anuncia en nombre de un anunciante.

​
Cambiado

Cambios de nombre universales de Lookalike Estamos actualizando los valores del enum para el parámetro lookalike_expansion en los endpoints POST accounts/:account_id/line_items y PUT accounts/:accountit/line_items/:line_item_id. Uso de country_code en todas partes Como parte de un esfuerzo más amplio relacionado con la consistencia en la Ads API, estamos cambiando el nombre de los parámetros en los siguientes endpoints de app_country_code a country_code. Esto no afecta el comportamiento ni los valores aceptados para estos parámetros y es únicamente un cambio de nombre. preview_url siempre null Tal 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 debido a la introducción de los endpoints de Media Library. Consulta la siguiente comparación de uso.
  • endpoint de videos v3: twurl -H ads-api.x.com "/3/accounts/18ce54d4x5t/videos"
  • endpoint v4 de Media Library para videos: twurl -H ads-api.x.com "/4/accounts/18ce54d4x5t/media_library?media_type=VIDEO"
Los endpoints de Media Library tienen plena paridad con los endpoints de videos y también admiten funcionalidad adicional, como la posibilidad de gestionar imágenes y GIF. Se solicita a los socios que utilicen exclusivamente Media Library para cualquier gestión de medios. as_user_id en la 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 si fuera del autor del Tweet.

​
v3

La versión 3 de Ads API se lanzó el 1 de febrero de 2018. La versión 2 de Ads API llegará al final de su vida útil el 1 de agosto de 2018. Esta versión incluye nuestro nuevo producto Audience Intelligence, acceso a Media Library y flujos de trabajo de cards mejorados. También anunciamos la obsolescencia 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 inferior en el tamaño de los lotes. Al igual que 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 que migren a v3 lo antes posible. Audience Intelligence Audience Intelligence ofrece información en tiempo real sobre los hashtags principales, @handles y eventos más relevantes para una audiencia determinada en X. Por ejemplo, introduce “Hombre 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, recuperar los hashtags principales, @handles y eventos más relevantes.
  • Dada una audiencia de entrada, recuperar información demográfica clave (como edad, género e ingresos del hogar).
  • Dada una palabra clave, recuperar la serie temporal del volumen de Tweets.
Media Library La Media Library permite gestionar imágenes, GIFs y vídeos para cuentas de anuncios. Estos objetos multimedia se pueden usar en Tweets y para crear cards. También se pueden reutilizar en múltiples creatividades, eliminando la necesidad de subir el mismo recurso varias veces. Los objetos de la biblioteca se identifican mediante un media_key. Las media keys son valores de tipo string con el siguiente formato: 13_875943225764098048, por ejemplo. En Ads API, avanzamos 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 Media Library para crear o actualizar cards. Además, estamos introduciendo dos nuevos endpoints para obtener detalles de cards. Estos endpoints se pueden usar para buscar cards utilizadas en Tweets o Tweets programados, por ejemplo, especificando ya sea el card_uri o el id. Anteriormente, esto no era posible.

​
Otros cambios

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.
Modificado
  • 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, preview_url será null. Cuando una card no tiene un card_uri, solo se devolverá 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. Aunque las cards existentes basadas en imágenes 5:2 seguirán funcionando, recomendamos a los socios cambiar a las relaciones de aspecto con mejor rendimiento 1.91:1 o 1:1 (cuando se admitan).
Eliminado Nota Tanto las Video Website Cards como los Tweets programados han salido ahora de la versión beta. Consulte este hilo para ver los cambios que hemos realizado en los Tweets programados desde su lanzamiento. Esto incluye la capacidad de generar vistas previas HTML para Tweets programados (previews).

​
v2

La versión 2 de la Ads API se lanzó el 10 de julio de 2017. La versión 1 de la Ads API llegará al fin de su vida útil el 10 de enero de 2018. Cambios importantes/funciones obsoletas
  • 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 line_items y campaigns se sustituyen por un único parámetro entity_status
  • El parámetro status ha pasado a llamarse text en los endpoints POST accounts/:account_id/tweet y GET accounts/:account_id/tweet/preview
  • Los valores enumerados location_type del endpoint GET targeting_criteria/locations ahora son plurales. 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 el hecho de que el tipo de ubicación se refiere a Designated Marker Areas (DMA) o “metros”.
  • display_properties en los endpoints PUT accounts/:account_id/promoted_tweets. Este valor tampoco se devolverá ya 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 v2
  • El atributo de respuesta data_type ya no se devuelve
Nuevas funciones
  1. Cards v2
  2. Creación y activación de campañas/line items en borrador
  3. Tweets programados
  4. Resúmenes de trabajos asíncronos
Cards v2
  • Se debe usar el parámetro de solicitud card_uri en lugar de añadir preview_url al texto del Tweet cuando se asocia una tarjeta con un Tweet
  • Si el parámetro card_uri no se devuelve en la respuesta (durante el paso de creación de la tarjeta), utilice entonces preview_url
  • Todos los nuevos formatos de tarjeta estarán disponibles de forma nativa en la API, aprovechando el parámetro card_uri.
Nuevos formatos de Card: Draft Campaigns Las campañas en borrador han estado disponibles para su visualización a través del endpoint GET accounts/:account_id/camapaigns. Con v2, ahora es posible crear y activar campañas en borrador a través de la API. Notas
  • Las líneas de pedido o campañas en borrador solo se pueden convertir de un entity_status de DRAFT a PAUSED o ACTIVE.
  • Para activar una campaña completa (con múltiples líneas de pedido), cada línea de pedido dentro de la campaña, así como la propia campaña, deben establecerse con un entity_status de ACTIVE.
  • Para cambiar el entity_status de cualquier campaña o línea de pedido, utiliza el endpoint PUT correspondiente.
Tweets programados

​
v1

La versión 1 de la Ads API se lanzó el 31 de marzo de 2016 y llegará al final de su vida útil el 10 de enero de 2018. Cambios en la versión 1:
  • Compatibilidad con versiones
  • CUSTOM objective ya no se admite
  • Los endpoints por lotes ya están disponibles de forma general
  • Cambios en las estimaciones de alcance:
  • Para ofrecer una mejor estimación del alcance, el endpoint ahora tiene en cuenta el presupuesto. Ahora se requieren los siguientes parámetros:
    • [nuevo] campaign_daily_budget_amount_local_micro
    • currency
    • bid
    • objective
  • El objeto de respuesta ha cambiado y ahora devuelve rangos de valores en la respuesta.
  • infinite_count se ha renombrado como infinite_bid_count para evitar confusión sobre su finalidad
  • Además de count e infinite_bid_count, ahora se devolverán los siguientes nuevos datos:
    • impressions
    • engagements
    • estimated_daily_spend_local_micro
  • Cambio de tipo de datos para audiencias personalizadas
  • El data_type correspondiente a Tailored Audiences se ha cambiado de tailored_audiences a tailored_audience en todas nuestras respuestas.
  • Las Shared Tailored Audiences ahora están disponibles en versión beta solo mediante API. Las Shared Tailored Audiences permiten que una única audiencia se utilice en varias cuentas publicitarias. Usa el endpoint POST accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions (y los relacionados) para administrar los permisos de una audiencia personalizada que quieras compartir entre varias cuentas publicitarias.
  • Mejoras significativas en cómo recopilas métricas de rendimiento para cuentas de anunciantes:
  • Para alinearnos con nuestras mejores prácticas, ahora solo permitiremos recuperar hasta 7 días de datos para los endpoints síncronos de estadísticas.
  • Para simplificar la recuperación de métricas, hemos reemplazado el parámetro metrics por un nuevo parámetro metric_groups. Los desarrolladores solo tienen que indicar qué grupos de métricas quieren que se devuelvan para una solicitud determinada.
    • Cualquier solicitud de métricas que no sean apropiadas para una entidad determinada se excluirán de la respuesta y se representarán como valores null. Estas métricas no se contabilizarán para tu límite de costos de análisis.
  • La respuesta se ha simplificado significativamente y ahora se alineará mejor con la forma en que las métricas se exponen en nuestra interfaz de usuario.
    • Anteriormente exponíamos una métrica separada para cada ubicación (Tweets promocionados en Búsqueda, Tweets promocionados en cronologías, Tweets promocionados en perfiles y detalles del Tweet, 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 en una de las siguientes categorías, como una única métrica, impressions (esto se aplica a todas las métricas):
    • ALL_ON_TWITTER
    • PUBLISHER_NETWORK
    • Cuando realices una solicitud, obtendrás una única métrica impressions para que hacer corresponder los valores en nuestra interfaz de usuario sea más sencillo.
    • Debes hacer dos consultas para obtener tanto los datos de ALL_ON_TWITTER como de 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 recuperar datos históricos.
    • Coloca en cola una tarea de estadísticas mediante un único endpoint nuevo. Obtendremos los datos que has solicitado según lo permitan los recursos.
    • Puedes consultar un endpoint de estado de la tarea para comprobar 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 de hasta 20 entidades en una sola tarea.
  • Consulta nuestra guía de migración de analytics v1, que incluye la correspondencia entre las métricas de v0 y las de v1
  • Mejoras del Sandbox * Ahora puedes crear varias cuentas de anuncios de prueba en el entorno Sandbox. * Ahora puedes crear varios instrumentos de financiación para una cuenta de anuncios de prueba, solo en el entorno Sandbox. Esto te permite hacer pruebas con todos nuestros tipos de instrumentos de financiación. Antes, solo estaba 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 Sandbox y ajustarlas a tus necesidades de prueba.

​
v0

La versión 0 de la Ads API se lanzó oficialmente el 21 de febrero de 2013 y contó con soporte hasta el 31 de octubre de 2016. Todos los endpoints de analítica de la versión 0 han quedado obsoletos y dejarán de estar disponibles después del 31 de octubre de 2016. Estos endpoints se han sustituido por 3 endpoints de analítica en la versión 1. El endpoint de estimación de alcance presenta un nuevo comportamiento en la versión 1.