Conceptos básicos
Jerarquía y terminología de Ads API
Para tener éxito con Ads API, es importante comprender cómo se relacionan entre sí las entidades en X Ads. Este tutorial repasa los conceptos básicos de la jerarquía de objetos de X Ads.
Los grupos de anuncios, conocidos como line items en la API de anuncios, se encuentran dentro de las campañas y se utilizan para la segmentación y la puja dirigida a un conjunto de usuarios de X. Los anunciantes promocionan Publicaciones o contenido multimedia (por ejemplo, videos que se promocionan como anuncios in-stream) al asociarlos con un line item. Consulta también Grupo de anuncios.
Una colección de piezas creativas que se han subido a una cuenta de anuncios como account media y que puede incluir activos de vídeo promocionado en prerroll, también conocidos como anuncios in-stream —por ejemplo, pre-roll assets—, así como imágenes que se pueden promocionar en la Plataforma de Audiencias de X.
En la parte superior de la jerarquía de X Ads se encuentran las cuentas de anuncios. Una cuenta de anuncios puede ser administrada por varios usuarios de X. @Furni, nuestra tienda de muebles de demostración, es un ejemplo de usuario que administra una cuenta de anuncios. Identificamos las cuentas de anuncios mediante un account_id, que es una cadena alfanumérica en base36.
En cada cuenta, almacenamos distintos tipos de entidades que se pueden reutilizar en distintas campañas, como audiencias personalizadas que se pueden usar para segmentación, medios de la cuenta, que son vídeos o imágenes, y cards, que son creatividades ampliadas que se pueden añadir a una Publicación.
Al cargar un recurso de vídeo, la entidad que realiza la carga puede definir una categoría para el vídeo (por ejemplo, Tweet Video, Tweet Gif, Tweet Image y Amplify Video). La categoría Amplify Video es obligatoria cuando se intenta cargar un vídeo que se servirá como un anuncio in-stream. Estos vídeos requieren un procesamiento especial para garantizar que puedan servirse y, por lo tanto, se requiere la categoría de medios Amplify Video.
Las métricas de Analytics ayudan a socios y anunciantes a comprender el rendimiento del contenido que promocionan en X. Esto incluye información como impresiones, clics, vistas de video y gasto publicitario. Además, los socios y anunciantes pueden obtener métricas detalladas para varios segmentos de las audiencias a las que llegan.
La Ads API admite dos formas de obtener métricas detalladas de rendimiento de campañas: de forma síncrona y asíncrona.
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 campaña 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 la tarea (“job”) asociada haya terminado de procesarse. Los endpoints asíncronos admiten solicitar métricas para rangos de tiempo mucho más largos, permiten devolver datos segmentados y están diseñados para recuperar mucha más información, lo que los hace ideales para generar informes o completar históricos.
Cada campaña que ejecuta el anunciante debe crearse bajo un instrumento de financiación existente. Una campaña te permite definir cosas como el nombre, la programación y el presupuesto de una campaña publicitaria. Siguiendo con el ejemplo de Furni, podríamos crear una campaña llamada “Furni decoración del hogar”.
Es importante tener en cuenta que una cuenta de anuncios está limitada a un máximo de 200 campañas activas; este límite puede aumentarse por el administrador de la cuenta del anunciante. Se considera que una campaña está 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ñas.
Las tarjetas ofrecen una forma de extender visualmente un Tweet para incluir una imagen, un video o elementos de la interfaz de usuario (UI). La Ads API permite varios tipos de tarjetas que se pueden usar en Tweets y luego promocionar en campañas.
Los anunciantes pueden promocionar Tweets en campañas que incluyen creatives, como imágenes, GIF y videos. Estos creatives se pueden asociar con X Cards que permiten adjuntar fotos enriquecidas, videos y experiencias multimedia a los Tweets. Los creatives también se pueden adjuntar directamente a los Tweets. Por ejemplo, puedes incluir texto y un video (o hasta 3 imágenes) y crear un Tweet promocionado.
Cada elemento de línea debe tener al menos un creative asociado para poder activarse. Hay varias opciones disponibles para creatives, incluidas las Cuentas promocionadas para conseguir nuevos seguidores, los Media Creatives, como una imagen o un video, para elementos de línea en toda la TX Audience Platform o las Publicaciones promocionadas.
También dentro de la cuenta publicitaria se encuentran los instrumentos de financiación, que son las diferentes fuentes de financiación que el anunciante ha configurado para usar con X Ads. Estos abarcan desde órdenes de inserción que este ha firmado con X hasta una tarjeta de crédito asociada a la cuenta.
Dentro de una campaña, puedes tener uno o más grupos de anuncios, conocidos también como line items en la Ads API. Los line items se pueden considerar como distintos segmentos de una campaña, cada uno con su propia configuración de segmentación y su propio creativo. Las campañas que contienen varios line items suelen denominarse “campañas de grupos de anuncios”.
Uno de los beneficios de tener múltiples line items dentro de una sola campaña es que puedes crear una mayor variedad de combinaciones de segmentación y creatividades.
Dentro de nuestra campaña “Furni home decor”, podríamos crear dos line items: uno podría ser “Compradores de vivienda en San Francisco” y el otro “Compradores de vivienda en Londres”.
Se permiten hasta 100 line items por campaña, y una cuenta de anuncios está limitada a un total de 4.000 line items activos entre todas las campañas.
Mobile App Promotion, o MAP, es una suite de productos que permite a los anunciantes promocionar Apps móviles en X. Estos productos incluyen instalaciones de apps, conversiones y reengagement.
La medición de la promoción de apps móviles en X permite a los anunciantes hacer seguimiento del éxito de las campañas publicitarias en X que están 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 hacer seguimiento en las apps que están promocionando en X. Descripción general de MACT
Los endpoints de la Biblioteca de medios permiten administrar imágenes, GIFs y vídeos para cuentas de X Ads. Los recursos multimedia de la biblioteca se pueden usar en Publicaciones y para crear tarjetas. También se pueden reutilizar en múltiples creativos, lo que elimina la necesidad de subir el mismo recurso varias veces.
Las Cuentas promocionadas (campañas de seguidores) forman parte de A quién seguir, que sugiere cuentas que las personas aún no siguen y que pueden resultarles interesantes. Las Cuentas promocionadas ayudan a dar a conocer una variedad aún más amplia de cuentas que les pueden gustar a las personas.
Las Cuentas promocionadas permiten a los anunciantes promocionar su cuenta y hacer crecer su audiencia en X. Las campañas de seguidores se muestran en varios lugares de la plataforma de X —incluyendo las cronologías de Inicio, A quién seguir 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, que son usuarios que podemos promocionar a través de la cuenta de anuncios. El nombre de usuario @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.
Ten en cuenta que también puede haber otros usuarios promocionables dentro de 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 retweets en la cuenta, lo que se indica con RETWEETS_ONLY. Los anunciantes deben ponerse en contacto con su administrador 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 dentro de Tweets promocionados, pagados por anunciantes. Estos aparecen en la línea de tiempo 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 a un anunciante o a un usuario crear un Tweet que se pueda programar para que se publique en una fecha posterior. Además de poder crear y administrar estos Tweets, la API permite asociarlos con un line item para que se promocionen una vez que el Tweet se publique. Esto permite que los anunciantes preparen Tweets nativos y planifiquen sus creatividades de campaña con antelación a cualquier iniciativa clave. Por ejemplo, preparar una creatividad de Tweet para que se publique inmediatamente cuando se anuncie un nuevo producto.
La segmentación permite a socios y anunciantes obtener métricas desglosadas por valores de segmentación específicos —como edad, dispositivos o idiomas— y solo está disponible a través de nuestros endpoints de analíticas asíncronas. Para solicitar métricas segmentadas, usa el parámetro de solicitud segmentation_type. Para obtener más detalles sobre las opciones de segmentación, consulta Metrics and Segmentation.
Las audiencias personalizadas a partir de listas son uno de los tres tipos de Audiencias personalizadas, que se crean cargando un archivo que contiene tus propios datos de usuarios y clientes. Tus listas se hacen coincidir con usuarios en X para que puedas dirigirte a ellos directamente en tus campañas. Revisa estas restricciones.
La Audiencia Personalizada de la web, uno de los tres tipos de Audiencias Personalizadas, es una colección de usuarios de X que han visitado tu sitio web. Para usar Audiencias Personalizadas de la web debes tener nuestro píxel de X instalado en tu sitio web, o usar uno de nuestros socios admitidos de gestor de etiquetas. Por favor, consulta estas restricciones.
Como mencionamos anteriormente, los criterios de segmentación se asocian con una línea de pedido. Disponemos de una variedad de tipos 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 la línea de pedido “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 diferentes tipos de segmentación disponibles, visita la página Targeting Overview en nuestro sitio para desarrolladores.
Twitter Object Nest (TON) contiene contenido multimedia y otros recursos subidos mediante los endpoints de Media Upload para usarlos como Creatives.