Conceptos básicos
Jerarquía y terminología de la Ads API
Para tener éxito con la 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 Ads API, están dentro 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) asociándolos a un line item. Consulte también Grupo de anuncios.
Una colección de creatividades que se han subido a una cuenta de anuncios como medios de la cuenta, que puede incluir recursos de prerroll de video promocionado —también conocidos como 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 anuncios. Una cuenta de anuncios 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 anuncios. Identificamos las cuentas de anuncios mediante un account_id, que es una cadena alfanumérica en base36.
En cada cuenta almacenamos varios tipos de entidades que pueden reutilizarse en distintas campañas, como audiencias personalizadas que pueden emplearse para la segmentación; medios de la cuenta, que son videos o imágenes; y cards, que son creatividades ampliadas que puedes añadir 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 al intentar cargar un video que se mostrará como anuncio in-stream. Estos videos requieren un procesamiento especial para garantizar que puedan entregarse; por ello, se exige 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, visualizaciones de video y gasto. Además, los socios y anunciantes pueden obtener métricas detalladas para distintos segmentos de las audiencias a las que llegan.
La Ads API admite dos formas de obtener métricas detalladas del rendimiento de las campañas: de manera 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 intervalos de tiempo cortos y es ideal para consultar el rendimiento de campañas en tiempo real.
Con los endpoints de analytics asíncronos, las métricas solicitadas están disponibles en un archivo de resultados descargable una vez que el “job” asociado haya terminado de procesarse. Los endpoints asíncronos permiten solicitar métricas durante un intervalo de tiempo mucho más largo, permiten devolver datos segmentados y están diseñados para obtener mucha más información, lo que resulta ideal para generar informes o realizar backfills históricos.
Cada campaña que ejecute el anunciante debe crearse con 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 aumentarlo el gerente de 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ñ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 Ads API admite varios tipos de Cards que pueden usarse en Tweets y luego promocionarse en campañas.
Los anunciantes pueden promocionar Tweets en campañas que incluyen creatividades, como imágenes, GIF 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 elemento de línea debe tener al menos una creatividad asociada para poder ejecutarse. Hay varias opciones de creatividades disponibles, incluidos Promoted Accounts para ganar nuevos seguidores, Media Creatives como una imagen o un video para elementos de línea 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 usar 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 Ads API. Las partidas pueden entenderse como distintos segmentos de una campaña, cada uno con su propio conjunto de segmentación y su propio material creativo. 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 misma campaña es que puedes crear una mayor variedad de combinaciones de segmentación y creatividades.
En nuestra campaña “Furni home decor”, podríamos 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 (MAP) es un conjunto de productos que permite a los anunciantes promocionar apps móviles en X. Esto incluye instalaciones de apps, conversiones y reinteracciones.
La medición de promociones de apps móviles en X permite a los anunciantes medir el 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 permite al anunciante gestionar qué conversiones quiere medir de las apps que promociona 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 multimedia de la biblioteca pueden usarse en Posts y para crear tarjetas. También pueden reutilizarse en múltiples piezas creativas, 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 dar a conocer una variedad aún más amplia de cuentas que las personas podrían disfrutar.
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 múltiples ubicaciones de la plataforma de X —incluidos Inicio, Who to Follow y los resultados de búsqueda— y esta sugerencia aparece etiquetada como Promocionado para distinguirla de otras cuentas recomendadas.
Cada cuenta de X Ads puede tener uno o más usuarios promocionables, que son usuarios a los que podemos promocionar a través de la cuenta de anuncios. El handle @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 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 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 dentro de Tweets promocionados por los que pagan los 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 etiquetados como “Promocionado”.
Consulta X Audience Platform.
Los Tweets programados permiten a un anunciante o usuario crear un Tweet que se pueda programar para publicarse más adelante. Además de poder crear y administrar estos Tweets, la API permite asociarlos con un ítem de línea, para que se promocionen una vez que el Tweet se publique. Esto permite a los anunciantes preparar Tweets nativos y planificar con antelación los recursos creativos de su campaña de cara a cualquier iniciativa clave. Por ejemplo, preparar un recurso creativo de Tweet para que se publique inmediatamente tras el anuncio de 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 asíncronos de analítica. 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.
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 hacen coincidir con usuarios en X para poder 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 tu sitio web. Para usar audiencias personalizadas desde la web, debes tener instalado nuestro píxel de X en tu sitio web o usar uno de nuestros socios aceptados de gestores de etiquetas. Revisa estas restricciones.
Como mencionamos anteriormente, los criterios de segmentación están asociados a un elemento de línea. Ofrecemos una variedad de tipos de segmentación que puedes utilizar, 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 “compra de vivienda” 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 distintos recursos subidos mediante los endpoints de Media Upload para usarlos como creatividades.
Cada línea de pedido debe tener al menos una creatividad asociada para poder ejecutarse. Hay varias opciones de creatividades disponibles, incluidas Cuentas promocionadas para ganar nuevos seguidores, Creatividades de medios como una imagen o video para líneas de pedido en toda la plataforma de audiencia de X, o Publicaciones promocionadas. Aquí tienes un ejemplo de Post que @Furni podría promocionar y usar como creatividad.