Skip to main content
Para tener éxito con la Ads API, es importante entender cómo se relacionan entre sí las entidades de X Ads. Este tutorial repasa los conceptos básicos de la jerarquía de objetos de X Ads. Jerarquía de la X Ads API

​
Ad Group (line items)

Los ad groups, conocidos como line items en la Ads API, existen bajo las campaigns y se usan para targeting y bidding contra un conjunto de usuarios de X. Los anunciantes promocionan posts o media (por ejemplo, videos que se promocionan como In-stream ads) asociándolos con un line item. Consulta también Ad Group.

​
Account Media

Una colección de creatividades que se han subido a una cuenta de ads como account media, que puede incluir pre-roll assets de video promocionado, también llamados in-stream ads, e imágenes que se pueden promocionar en la X Audience Platform.

​
Ads Accounts

En la cima de la jerarquía de X Ads están las cuentas de ads. Una cuenta de ads puede ser gestionada por varios usuarios de X. @Furni, nuestra tienda de muebles de demostración, sería un ejemplo de un usuario que gestiona una cuenta de ads. Identificamos las cuentas de ads mediante un account_id, que es una cadena alfanumérica en base36. Bajo cada cuenta almacenamos varios tipos de entidades que pueden reutilizarse en las campaigns, como tailored audiences que se pueden usar para targeting, account media, que son videos o imágenes, y cards, que son creatividades ampliadas que puedes añadir a un post.

​
Amplify Video

Al subir un asset de video, la entidad que lo sube puede definir una categoría para el video (por ejemplo, Tweet Video, Tweet Gif, Tweet Image y Amplify Video). La categoría Amplify Video es obligatoria cuando se intenta subir un video que se servirá como anuncio in-stream. Estos videos requieren un procesamiento especial para asegurar que sean servibles, por lo que se requiere la categoría de media Amplify Video.

​
Analytics

Las métricas de analytics ayudan a los partners y anunciantes a entender el rendimiento del contenido que promocionan en X. Esto incluye información como impresiones, clics, vistas de video y gasto. Además, los partners y anunciantes pueden obtener métricas detalladas para varios segmentos de las audiencias que alcanzan. La Ads API admite dos formas de recuperar métricas detalladas del rendimiento de la campaign: sincrónicamente y asincrónicamente. Con las solicitudes de analytics síncronos, las métricas solicitadas se devuelven en la respuesta. El endpoint síncrono admite rangos de tiempo cortos y es ideal para consultar el rendimiento de campaign en tiempo real. Con los endpoints de analytics asíncronos, las métricas solicitadas están disponibles en un archivo de resultados descargable después de que el “job” asociado haya terminado de procesarse. Los endpoints asíncronos admiten solicitar métricas en un rango de tiempo mucho más largo, permiten devolver datos segmentados y están pensados para obtener mucho más datos, ideales para generar reportes o backfills históricos.

​
Campaigns

Cada campaign que ejecute el anunciante debe crearse bajo un funding instrument existente. Una campaign te permite definir cosas como el nombre, el calendario y el presupuesto de una campaña de anuncios. Siguiendo con el ejemplo de Furni, podríamos crear una campaign llamada “Furni home decor”. Vale la pena mencionar que una cuenta de ads está limitada a un máximo de 200 campaigns activas; este límite puede elevarlo el gestor de cuenta del anunciante. Una campaign se considera activa hasta que se alcanza su end time o se agota su presupuesto. Una campaign pausada sigue considerándose una campaign activa a efectos de los límites de campaigns.

​
Cards

Las Cards ofrecen una forma de extender visualmente un Tweet para incluir una imagen, video o elementos de UI. La Ads API admite varios tipos de card que se pueden usar en Tweets, los cuales pueden luego promocionarse en campaigns.

​
Creatividades

Los anunciantes pueden promocionar Tweets en campaigns que incluyan creatividades, como imágenes, GIFs y video. Estas creatividades pueden asociarse con X cards que permiten adjuntar fotos, videos y experiencias multimedia enriquecidas a los Tweets. Las creatividades también pueden adjuntarse directamente a los Tweets. Por ejemplo, puedes incluir texto y un video (o hasta 3 imágenes) y crear un Tweet promocionado. Cada line item necesita tener al menos una creatividad asociada para poder ejecutarse. Hay varias opciones de creatividades disponibles, incluyendo Promoted Accounts para ganar nuevos seguidores, Media Creatives como una imagen o video para line items en la X Audience Platform, o Promoted Posts.

​
Funding Instruments

También bajo la cuenta de ads están los funding instruments, que son las distintas fuentes de financiación que el anunciante ha configurado para usar con X Ads. Estos van desde insertion orders que ha firmado con X hasta una tarjeta de crédito asociada a la cuenta.

​
Line Items

Dentro de una campaign, puedes tener uno o más ad groups, también conocidos como line items en la Ads API. Los line items pueden considerarse como distintos segmentos de una campaign, cada uno con su propio conjunto de targeting y su propia creatividad. Las campaigns que contienen múltiples line items suelen denominarse “ad group campaigns”. Uno de los beneficios de tener múltiples line items dentro de una única campaign es que puedes crear una mayor variedad de combinaciones de targeting y creatividad. Bajo nuestra campaign “Furni home decor”, podríamos querer crear dos line items: uno podría ser “Home buyers in San Francisco” y el otro podría ser “Home buyers in London”. Se permiten hasta 100 line items por campaign, y una cuenta de ads está limitada a 4000 line items activos en total en todas las campaigns.

​
Mobile App Promotion (MAP)

Mobile App Promotion, o MAP, es una suite de productos que permite a los anunciantes promocionar apps móviles a través de X. Incluyen instalaciones de app, conversiones y re-engagement.

​
Mobile App Conversion Tracking (MACT)

La medición de promoción de apps móviles de X permite a los anunciantes rastrear el éxito de las campañas publicitarias en X que están diseñadas para impulsar instalaciones u otras conversiones dentro de la app. Un partner de medición móvil de X proporciona la capacidad para que un anunciante gestione qué conversiones quiere rastrear desde las apps que está promocionando en X. MACT Overview

​
Media Library

Los endpoints de Media Library ofrecen la capacidad de gestionar imágenes, GIFs y videos para cuentas de X Ads. Los assets de media en la biblioteca se pueden usar en posts y para crear cards. También se pueden reutilizar en múltiples creatividades, eliminando la necesidad de subir el mismo asset varias veces. Las Promoted Accounts (campaigns de seguidores) forman parte de Who to Follow, que sugiere cuentas que las personas no siguen actualmente y que podrían resultarles interesantes. Las Promoted Accounts ayudan a presentar una variedad aún más amplia de cuentas que a la gente le pueden gustar. Las Promoted Accounts permiten a los anunciantes promocionar su cuenta y hacer crecer su audiencia en X. Las campaigns de seguidores se muestran en múltiples ubicaciones dentro de la plataforma de X — incluyendo Home Timelines, Who to Follow y resultados de búsqueda — y esta sugerencia se etiqueta como Promoted para distinguirla de otras cuentas recomendadas.

​
Promotable Users

Cada cuenta de X Ads puede tener uno o más promotable users, que son usuarios que podemos promocionar a través de la cuenta de ads. El handle @Furni de Furni sería un ejemplo de un promotable user FULL bajo la cuenta de ads de Furni, lo que significa que podemos ejecutar todo tipo de campaigns para @Furni y sus tweets. Solo puede haber un promotable user FULL por cuenta de ads. Ten en cuenta que también puede haber otros promotable users bajo una cuenta de ads. Por ejemplo, si quisiéramos promocionar los Tweets de @Jack sobre productos de Furni, se convertiría en un promotable user solo de retweet en la cuenta, lo cual se indica mediante RETWEETS_ONLY. Los anunciantes deben ponerse en contacto con su gestor de cuenta de X para obtener información sobre cómo añadir retweet users a su cuenta de ads. Los promoted videos son videos dentro de Promoted Tweets que son pagados por los anunciantes. Aparecen en la Home timeline, en la parte superior de los resultados de búsqueda en X y en otros lugares de la plataforma, y están claramente marcados como “Promoted”.

​
Publisher Network

Consulta la X Audience Platform.

​
Scheduled Tweets

Los Scheduled Tweets permiten a un anunciante o usuario crear un Tweet que puede programarse para publicarse en una fecha posterior. Además de poder crear y gestionar estos Tweets, la API permite asociar estos Tweets con un line item, para promocionarlos una vez que el Tweet se publique. Esto permite a los anunciantes preparar creatividades de Tweets nativos y planificar las creatividades de su campaign con antelación a cualquier iniciativa clave. Por ejemplo, preparar una creatividad de Tweet para publicarse inmediatamente tras el anuncio de un nuevo producto.

​
Segmentación

La segmentación permite a los partners y anunciantes recuperar métricas desglosadas por valores de targeting concretos, como edad, dispositivos o idiomas, y solo está disponible a través de nuestros endpoints de analytics asíncronos. Para solicitar métricas segmentadas, usa el parámetro de solicitud segmentation_type. Para más detalles sobre las opciones de segmentación, consulta Metrics and Segmentation.

​
Tailored Audience - List

Las tailored audiences a partir de listas son uno de los tres tipos de Tailored Audiences, creadas subiendo un archivo con tus propios datos de usuario y cliente. Tus listas se emparejan con usuarios en X para que puedas dirigirte directamente a ellos en tus campaigns. Por favor, revisa estas restricciones.

​
Tailored Audience - Web

Tailored Audience desde web, uno de los tres tipos de Tailored Audiences, es una colección de usuarios de X que han visitado tu sitio web. Para usar Tailored Audiences desde web debes tener nuestro X pixel instalado en tu sitio web, o usar uno de nuestros partners de tag manager aceptados. Por favor, revisa estas restricciones.

​
Targeting Criteria

Como mencionamos anteriormente, los targeting criteria están asociados a un line item. Tenemos una variedad de diferentes targetings que puedes usar, desde ubicación, palabras clave y género hasta atributos más granulares, como comportamientos e intereses de usuario. Para el line item “Home Buyers in San Francisco”, podríamos apuntar al comportamiento “home buying” junto con la ubicación “San Francisco”. Para más información sobre los diferentes tipos de targeting disponibles, visita la página Targeting Overview en nuestro sitio para desarrolladores.

​
Twitter Object Nest (TON)

El Twitter Object Nest (TON) contiene media y varios assets subidos a través de los endpoints de Media Upload para ser usados como Creatividades.

​
Creatividades

Cada line item necesita tener al menos una creatividad asociada para poder ejecutarse. Hay varias opciones de creatividades disponibles, incluyendo Promoted Accounts para ganar nuevos seguidores, Media Creatives como una imagen o video para line items en la X Audience Platform, o Promoted Posts. Aquí tienes un ejemplo de post que @Furni podría promocionar y usar como creatividad.