Fundamentos
Jerarquía y terminología de la X Ads API
Para tener éxito con la X Ads API, es importante comprender cómo se relacionan entre sí las entidades en X Ads. Este tutorial repasa los fundamentos de la jerarquía de objetos de X Ads.
Los grupos de anuncios, conocidos como line items en la X Ads API, forman parte de las campañas y se utilizan para segmentar y pujar por un conjunto de usuarios de X. Los anunciantes promocionan Posts o contenido multimedia (p. ej., videos promocionados como anuncios In-stream) al asociarlos con un line item. Consulte también Grupo de anuncios.
Una colección de creativos cargados en una cuenta de anuncios como medios de la cuenta, que puede incluir recursos de prerroll de video promocionado (también llamados anuncios in-stream) e imágenes que pueden promocionarse en la X Audience Platform.
En la parte superior de la jerarquía de X Ads se encuentran las cuentas de Ads. Una cuenta de Ads puede ser administrada por varios usuarios de X. @Furni, nuestra tienda de muebles de demostración, sería un ejemplo de un usuario que administra una cuenta de Ads. Identificamos las cuentas de Ads mediante un account_id, que es una cadena alfanumérica en base36.
En cada cuenta, almacenamos varios tipos de entidades que pueden reutilizarse en campañas, como audiencias personalizadas que pueden emplearse para la segmentación, medios de la cuenta (videos o imágenes) y cards, que son creatividades expandidas que puedes agregar a un Post.
Al cargar un recurso de video, la entidad que realiza la carga puede definir una categoría para el video (p. ej., Tweet Video, Tweet Gif, Tweet Image y Amplify Video). La categoría Amplify Video es obligatoria cuando se intenta cargar un video que se servirá como un anuncio in‑stream. Estos videos requieren un procesamiento especial para garantizar que puedan entregarse; por lo tanto, se requiere la categoría de medios Amplify Video.
Las métricas de analítica ayudan a socios y anunciantes a comprender el rendimiento del contenido que promocionan en X. Esto incluye información como impresiones, clics, reproducciones de video y gasto. Además, los socios y anunciantes pueden obtener métricas detalladas para diversos segmentos de las audiencias a las que llegan.
La X Ads API admite dos formas de recuperar métricas detalladas del rendimiento de campañas: de manera síncrona y asíncrona.
Con las solicitudes de analítica síncrona, 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 campañas en tiempo real.
Con los endpoints de analítica asíncrona, 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 permiten solicitar métricas durante un rango de tiempo mucho más largo, devolver data segmentada y están diseñados para obtener mucha más información, lo cual es ideal para generar informes o realizar backfills históricos.
Cada campaña que ejecute el anunciante debe crearse bajo un instrumento de financiación existente. Una campaña te permite definir aspectos como el nombre, el calendario y el presupuesto de una campaña publicitaria. Siguiendo con el ejemplo de Furni, podríamos crear una campaña llamada “Furni home decor”.
Cabe señalar que una cuenta de anuncios está limitada a un máximo de 200 campañas activas; este límite puede aumentarse por el gerente de cuenta del anunciante. Una campaña se considera activa hasta que se alcanza su hora de finalización o se agota su presupuesto. Una campaña en pausa sigue considerándose una campaña activa a efectos de los límites de campaña.
Las Cards ofrecen una forma de ampliar visualmente un Tweet para incluir una imagen, un video o elementos de la interfaz de usuario. La X Ads API admite varios tipos de Cards que pueden usarse en Tweets, los cuales luego pueden promocionarse en campañas.
Los anunciantes pueden promocionar Tweets en campañas que incluyen creativos, como imágenes, GIF y video. Estos creativos pueden asociarse con tarjetas de X que permiten adjuntar fotos, videos y experiencias multimedia enriquecidas a los Tweets. Los creativos 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 partida debe tener al menos un creativo asociado para poder ejecutarse. Hay varias opciones de creativos disponibles, incluidas Promoted Accounts para ganar nuevos seguidores, Media Creatives como una imagen o un video para partidas en toda la TX Audience Platform, o Promoted Posts.
Dentro de la cuenta de anuncios también se encuentran los instrumentos de financiación, que son las distintas fuentes de fondos que el anunciante ha configurado para utilizar con X Ads. Estos van desde órdenes de inserción firmadas con X hasta una tarjeta de crédito vinculada a la cuenta.
Dentro de una campaña, puedes tener uno o más grupos de anuncios, también conocidos como partidas en la X Ads API. Las partidas pueden considerarse como diferentes segmentos de una campaña, cada una con su propio conjunto de segmentación y su propia creatividad. Las campañas que contienen varias partidas a menudo se denominan “campañas de grupos de anuncios”.
Uno de los beneficios de tener varias partidas dentro de una sola campaña es que puedes crear una mayor variedad de combinaciones de segmentación y creatividad.
En nuestra campaña “Furni home decor”, podríamos querer crear dos partidas: una podría ser “Compradores de vivienda en San Francisco” y la otra “Compradores de vivienda en Londres”.
Se permiten hasta 100 partidas por campaña, y una cuenta de anuncios está limitada a 4.000 partidas activas en total en todas las campañas.
La Promoción de Apps móviles, o MAP, es un conjunto de productos que permite a los anunciantes promocionar Apps móviles en X. Esto incluye instalaciones de apps, conversiones y reenganche.
La medición de la promoción de apps móviles en X permite a los anunciantes hacer un seguimiento del rendimiento de las campañas publicitarias en X diseñadas para impulsar instalaciones u otras conversiones dentro de la app. Un socio de medición móvil de X ofrece a los anunciantes la posibilidad de gestionar qué conversiones desean rastrear de las apps que promocionan en X. Descripción general de MACT
Los endpoints de la Biblioteca de medios permiten gestionar imágenes, GIF y videos para cuentas de X Ads. Los recursos de la biblioteca pueden usarse en Posts y para crear tarjetas. También pueden reutilizarse en múltiples creatividades, lo que elimina la necesidad de subir el mismo recurso varias veces.
Las Cuentas promocionadas (campañas de seguidores) forman parte de Who to Follow, que sugiere cuentas que las personas aún no siguen y que podrían resultarles interesantes. Las Cuentas promocionadas ayudan a presentar una variedad aún más amplia de cuentas que podrían gustar a las personas.
Las Cuentas promocionadas permiten a los anunciantes promocionar su cuenta y ampliar su audiencia en X. Las campañas de seguidores se muestran en múltiples ubicaciones de la plataforma de X —incluidos las cronologías de Inicio, Who to Follow y los resultados de búsqueda— y esta sugerencia aparece con la etiqueta Promocionado para distinguirla de otras cuentas recomendadas.
Cada cuenta de X Ads puede tener uno o más usuarios promocionables, es decir, usuarios que podemos promocionar a través de la cuenta de anuncios. El @Furni de Furni sería un ejemplo de un usuario promocionable COMPLETO dentro de la cuenta de anuncios de Furni, lo que significa que podemos ejecutar todo tipo de campañas para @Furni y sus tweets. Solo puede haber un usuario promocionable COMPLETO por cuenta de anuncios.
Tenga en cuenta que también puede haber otros usuarios promocionables en una cuenta de anuncios. Por ejemplo, si quisiéramos promocionar los Tweets de @Jack sobre productos de Furni, se convertiría en un usuario promocionable solo para Retweet en la cuenta, lo cual se indica con RETWEETS_ONLY. Los anunciantes deben ponerse en contacto con su gerente de cuenta de X para obtener información sobre cómo agregar usuarios de Retweet a su cuenta de anuncios.
Los videos promocionados son videos incluidos en Tweets promocionados y pagados por anunciantes. Aparecen en la cronología de Inicio, 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 “Promocionado”.
Consulta X Audience Platform.
Los Tweets programados permiten que un anunciante o un usuario cree un Tweet que pueda programarse para publicarse en una fecha posterior. Además de poder crear y administrar estos Tweets, la API permite asociarlos a una línea de pedido para promocionarlos una vez que el Tweet esté publicado. Esto permite a los anunciantes preparar Tweets nativos y planificar con antelación los creativos de sus campañas de cara a cualquier iniciativa clave. Por ejemplo, dejar preparado un creativo de Tweet para que se publique inmediatamente tras el anuncio de un nuevo producto.
La segmentación permite a los socios y anunciantes obtener metrics desglosadas por valores de segmentación específicos —como edad, dispositivos o idiomas— y solo está disponible a través de nuestros endpoints de analytics asíncronos. Para solicitar metrics segmentadas, use el parámetro de solicitud segmentation_type. Para obtener más detalles sobre las opciones de segmentación, consulte Metrics and Segmentation.
Las audiencias personalizadas a partir de listas son uno de los tres tipos de audiencias personalizadas, creadas mediante la carga de un archivo que contiene tus propios datos de usuarios y clientes. Tus listas se comparan con usuarios en X para que puedas dirigirte a ellos directamente en tus campañas. Revisa estas restricciones.
La Audiencia personalizada desde la web, uno de los tres tipos de Audiencias personalizadas, es un conjunto de usuarios de X que han visitado su sitio web. Para usar Audiencias personalizadas desde la web, debe tener instalado nuestro píxel de X en su sitio web o utilizar uno de nuestros socios aceptados de gestores de etiquetas. Revise estas restricciones.
Como mencionamos anteriormente, los criterios de segmentación están asociados a un elemento de línea. Ofrecemos una variedad de opciones de segmentación que puedes usar, desde ubicación, palabras clave y género hasta atributos más granulares, como comportamientos e intereses de los usuarios. Para el elemento de línea “Home Buyers in San Francisco”, podríamos segmentar por el comportamiento “home buying” junto con la ubicación “San Francisco”.
Para obtener información sobre los distintos tipos de segmentación disponibles, visita la página Targeting Overview en nuestro sitio para desarrolladores.
Twitter Object Nest (TON) almacena contenido multimedia y diversos recursos subidos a través de los endpoints de Media Upload para usarse como Creatives.
Cada elemento de línea debe tener al menos un creativo asociado para poder ejecutarse. Hay varias opciones de creativos disponibles, incluidas Cuentas promocionadas para ganar nuevos seguidores, Creativos de medios como una imagen o un video para elementos de línea en toda la X Audience Platform, o Posts promocionados. Aquí tienes un ejemplo de Post que @Furni podría promocionar y usar como creativo.
⌘I