Fondamenti
Gerarchia e terminologia di X Ads API
Per avere successo con X Ads API, è importante comprendere come le entità in X Ads siano correlate tra loro. Questo tutorial illustra le basi della gerarchia degli oggetti di X Ads.
I gruppi di annunci, chiamati line items nella X Ads API, rientrano nelle campagne e vengono utilizzati per il targeting e per le offerte su un insieme di utenti di X. Gli inserzionisti promuovono Post o contenuti multimediali (ad esempio video promossi come annunci In-stream) associandoli a una line item. Vedi anche Gruppo di annunci.
Al vertice della gerarchia di X Ads ci sono gli account pubblicitari. Un account pubblicitario può essere gestito da più utenti X. @Furni, il nostro negozio di arredamento di esempio, è un esempio di utente che gestisce un account pubblicitario. Identifichiamo gli account pubblicitari tramite un account_id, una stringa alfanumerica in base36.
Per ciascun account archiviamo diversi tipi di entità riutilizzabili tra le campagne, ad esempio le audience personalizzate che possono essere utilizzate per il targeting, i media dell’account (video o immagini) e le card, ovvero creatività estese che puoi aggiungere a un post.
Durante il caricamento di una risorsa video, chi carica può definire una categoria per il video (ad es. Tweet Video, Tweet Gif, Tweet Image e Amplify Video). La categoria Amplify Video è necessaria quando si tenta di caricare un video che verrà distribuito come pubblicità in‑stream. Questi video richiedono un’elaborazione speciale per garantirne la distribuibilità e, di conseguenza, è richiesta la categoria multimediale Amplify Video.
Le metriche di analytics aiutano partner e inserzionisti a comprendere le prestazioni dei contenuti che promuovono su X. Queste includono informazioni come impression, clic, visualizzazioni video e spesa. Inoltre, partner e inserzionisti possono ottenere metriche dettagliate per vari segmenti delle audience raggiunte.
La X Ads API supporta due modalità per recuperare metriche dettagliate sulle prestazioni delle campagne: in modo sincrono e in modo asincrono.
Con le richieste di analytics sincroni, le metriche richieste vengono restituite nella risposta. L’endpoint sincrono supporta intervalli temporali brevi ed è ideale per interrogare le prestazioni delle campagne in tempo reale.
Con gli analytics asincroni, le metriche richieste sono disponibili in un file di risultati scaricabile dopo che il relativo job ha terminato l’elaborazione. Gli endpoint asincroni supportano la richiesta di metriche su intervalli temporali molto più lunghi, consentono di restituire dati segmentati e sono pensati per recuperare quantità di dati molto maggiori — ideali per generare report o backfill storici.
Ogni campagna avviata dall’inserzionista deve essere creata su uno strumento di finanziamento esistente. Una campagna consente di definire elementi come il nome, la programmazione e il budget di una campagna pubblicitaria. Proseguendo con l’esempio di Furni, potremmo creare una campagna chiamata “Furni home decor”.
È importante notare che un account pubblicitario è limitato a un massimo di 200 campagne attive; questo limite può essere aumentato dal responsabile dell’account dell’inserzionista. Una campagna è considerata attiva fino al raggiungimento dell’orario di fine o all’esaurimento del budget. Una campagna in pausa è comunque considerata attiva ai fini dei limiti di campagna.
Le Cards offrono un modo per estendere visivamente un Tweet includendo un’immagine, un video o elementi dell’interfaccia utente. La X Ads API supporta diversi tipi di card che possono essere utilizzati nei Tweet, che poi possono essere promossi nelle campagne.
Gli inserzionisti possono promuovere Tweet in campagne che includono creativi, come immagini, GIF e video. Questi creativi possono essere associati alle X Card, che consentono di allegare foto, video ed esperienze multimediali avanzate ai Tweet. I creativi possono anche essere allegati direttamente ai Tweet. Ad esempio, è possibile includere testo e un video (o fino a 3 immagini) e creare un Tweet sponsorizzato.
Ogni line item deve avere almeno un creativo associato per poter essere attivato. Sono disponibili diverse opzioni di creativo, tra cui Promoted Accounts per acquisire nuovi follower, Media Creatives come un’immagine o un video per i line item sulla TX Audience Platform, oppure Promoted Posts.
All’interno dell’account pubblicitario sono presenti anche gli strumenti di finanziamento, ovvero le diverse fonti di pagamento che l’inserzionista ha configurato per l’uso con X Ads. Questi vanno dagli insertion order firmati con X a una carta di credito collegata all’account.
All’interno di una campagna, puoi avere uno o più gruppi di annunci, noti anche come line items nella X Ads API. I line items possono essere considerati segmenti distinti di una campagna, ciascuno con il proprio set di targeting e i propri contenuti creativi. Le campagne che contengono più line items sono spesso denominate “campagne con gruppi di annunci”.
Uno dei vantaggi di avere più line items all’interno della stessa campagna è la possibilità di creare una maggiore varietà di combinazioni tra targeting e creatività.
Nella nostra campagna “Furni home decor”, potremmo voler creare due line items: uno potrebbe essere “Acquirenti di case a San Francisco” e l’altro “Acquirenti di case a Londra”.
Sono consentiti fino a 100 line items per campagna e un account pubblicitario è limitato a 4.000 line items attivi in totale su tutte le campagne.
La Promozione delle App mobili, o MAP, è una suite di prodotti che consente agli inserzionisti di promuovere le app mobili su X. Questi includono installazioni dell’App, conversioni e re-engagement.
La misurazione della promozione delle App per dispositivi mobili su X consente agli inserzionisti di monitorare i risultati delle campagne pubblicitarie su X progettate per generare installazioni o altre conversioni in-app. Un partner di misurazione mobile di X consente a un inserzionista di gestire quali conversioni desidera tracciare dalle App che sta promuovendo su X. Panoramica di MACT
Gli endpoint della Libreria multimediale consentono di gestire immagini, GIF e video per gli account X Ads. Le risorse multimediali nella libreria possono essere utilizzate nei post e per creare schede. Possono anche essere riutilizzate in più creativi, eliminando la necessità di caricare più volte lo stesso asset.
Le Promoted Accounts (follower campaigns) fanno parte di Who to Follow, che suggerisce account che le persone non seguono attualmente e che potrebbero trovare interessanti. Le Promoted Accounts contribuiscono a far conoscere una varietà ancora più ampia di account che le persone potrebbero apprezzare.
Le Promoted Accounts consentono agli inserzionisti di promuovere il proprio account e far crescere la propria audience su X. Le follower campaigns vengono mostrate in più posizioni sulla piattaforma X — inclusi Home Timelines, Who to Follow e i risultati di ricerca — e questo suggerimento è etichettato come Promoted per distinguerlo dagli altri account consigliati.
Ogni account X Ads può avere uno o più utenti promuovibili, ossia account che possiamo promuovere tramite l’account pubblicitario. L’handle @Furni di Furni è un esempio di utente promuovibile di tipo FULL all’interno dell’account pubblicitario di Furni, il che significa che possiamo eseguire tutti i tipi di campagne per @Furni e i suoi tweet. Può esserci un solo utente promuovibile FULL per un account pubblicitario.
Nota: possono esserci anche altri utenti promuovibili all’interno di un account pubblicitario. Ad esempio, se volessimo promuovere i Tweet di @Jack sui prodotti Furni, diventerebbe un utente promuovibile solo per Retweet sull’account, indicato da RETWEETS_ONLY. Gli inserzionisti dovrebbero contattare il proprio account manager X per informazioni sull’aggiunta di utenti per Retweet al loro account pubblicitario.
I video sponsorizzati sono video all’interno dei Tweet sponsorizzati acquistati dagli inserzionisti. Compaiono nella timeline Home, in cima ai risultati di ricerca su X e in altre aree della piattaforma, e sono chiaramente contrassegnati come “Sponsorizzato”.
Consulta X Audience Platform.
I Tweet programmati consentono a un inserzionista o a un utente di creare un Tweet da programmare per la pubblicazione in un secondo momento. Oltre a creare e gestire questi Tweet, l’API consente di associare tali Tweet a una line item, così da promuoverli una volta pubblicati. Questo permette agli inserzionisti di predisporre Tweet nativi e pianificare in anticipo le creatività di campagna in vista di iniziative chiave. Ad esempio, predisporre una creatività di un Tweet affinché venga pubblicata immediatamente al momento dell’annuncio di un nuovo prodotto.
La segmentazione consente a partner e inserzionisti di ottenere metriche suddivise in base a specifici valori di targeting, come età, dispositivi o lingue, ed è disponibile esclusivamente tramite i nostri endpoint di analisi asincroni. Per richiedere metriche segmentate, usare il parametro di richiesta segmentation_type. Per ulteriori dettagli sulle opzioni di segmentazione, vedere Metriche e segmentazione.
Le Tailored Audience da lista sono uno dei tre tipi di Tailored Audiences, create caricando un file contenente i tuoi dati di utenti e clienti. Le tue liste vengono associate agli utenti su X, così da poterli raggiungere direttamente nelle tue campagne. Consulta queste restrizioni.
Il Pubblico personalizzato dal web, uno dei tre tipi di Pubblico personalizzato, è un insieme di utenti di X che hanno visitato il tuo sito. Per utilizzare i Pubblici personalizzati dal web devi aver installato sul tuo sito il nostro pixel di X oppure utilizzare uno dei nostri partner di tag management accettati. Consulta queste restrizioni.
Come accennato in precedenza, i criteri di targeting sono associati a una voce di ordine. Offriamo un’ampia gamma di opzioni di targeting che puoi utilizzare: dalla località alle parole chiave e al genere, fino ad attributi più granulari, come i comportamenti e gli interessi degli utenti. Per la voce di ordine “Home Buyers in San Francisco”, potremmo indirizzare il comportamento “home buying” insieme alla località “San Francisco”.
Per informazioni sui diversi tipi di targeting disponibili, visita la pagina Targeting Overview sul nostro sito per sviluppatori.
Il Twitter Object Nest (TON) archivia contenuti multimediali e vari asset caricati tramite gli endpoint di Media Upload, da utilizzare come creatività.
Ogni line item deve avere almeno un creative associato per poter essere attivato. Sono disponibili diverse opzioni di creative, tra cui Promoted Accounts per ottenere nuovi follower, Media Creatives come un’immagine o un video per i line item sull’intera X Audience Platform, oppure Promoted Posts. Ecco un esempio di post che @Furni potrebbe promuovere e utilizzare come creative.
⌘I