Crea un'inserzione di Meta dedicata ai posizionamenti reel disponibili e scopri le best practice sulle nostre operazioni pubblicitarie.
Se non soddisfi questi prerequisiti, consulta la nostra documentazione per sviluppatori.
Meta offre un ambiente di test, che non pubblica inserzioni, ma ti consente di:
Leggi le nostre best practice di test.
Un token d'accesso è una stringa opaca che identifica un utente, un'app o una Pagina e può essere usata dall'app per effettuare chiamate API Graph. Puoi vedere quando scade e quale app l'ha generata. Le chiamate API Marketing sulle app Meta devono includere un token d'accesso.
Ottieni un token d'accesso con le autorizzazioni necessarie:
ads_management
: consente di apportare modifiche agli account pubblicitari selezionati
ads_read
: consente di leggere i dati delle inserzioni
read_insights
: consente di leggere gli insight sulle prestazioni
Usa i token d'accesso del sistema perché hanno tempi di scadenza più lunghi.
Per accedere agli endpoint dell'API Marketing, devi creare un'app business. Le app business sono soggette a un livello aggiuntivo di autorizzazione dell'API Graph noto come livelli di accesso. Durante l'analisi dell'app, la tua app deve inoltre richiedere specifiche autorizzazioni e funzioni. Devi completare la verifica dell'azienda se la tua app verrà utilizzata da utenti dell'app che non hanno un ruolo al suo interno o in un Business Manager che ha reclamato l'app.
Se la tua app gestisce gli account pubblicitari di altre persone, hai bisogno di:
ads_read
e/o
ads_management
Recupera i tuoi account pubblicitari di inserzionisti e consenti loro di designarne uno per la creazione delle inserzioni.
Attraverso la nostra API Business Management, puoi vedere tutti gli account pubblicitari a cui la loro azienda ha accesso. In questo modo, ottieni tutti gli account pubblicitari di proprietà di un Business Manager. Tieni presente che avrai bisogno dell'autorizzazione business_management
a livello di app e utente. Fai riferimento al documento API di gestione delle risorse business.
curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0
/<BUSINESS_ID>/owned_ad_accounts"
Le campagne sono la struttura organizzativa di livello più elevato all'interno di un account pubblicitario e devono rappresentare un singolo obiettivo per un inserzionista. Questi oggetti contengono il tuo obiettivo pubblicitario e uno o più gruppi di inserzioni. Questo ti aiuta a ottimizzare e misurare i risultati per ogni obiettivo pubblicitario. Scopri di più su come creare, leggere, aggiornare ed eliminare una campagna qui.
curl -X POST \
-F 'name="My campaign"' \
-F 'objective="OUTCOME_TRAFFIC"' \
-F 'status="PAUSED"' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
Per consentire agli inserzionisti di raggiungere gruppi specifici, indica questi parametri nelle tue richieste API:
In questo modo raggiungerai i potenziali clienti che potrebbero essere maggiormente interessati ai tuoi prodotti o servizi.
curl -X POST \
-F 'access_token=YOUR_ACCESS_TOKEN' \
-F 'name=My Custom Audience' \
-F 'subtype=CUSTOM' \
-F 'description=People who live in New York, aged 25-40, interested in technology' \
-F 'customer_file_source=USER_PROVIDED_ONLY' \
-F 'targeting_spec={
"geo_locations": {
"countries": ["US"],
"regions": [{"key": "4081"}] # New York region key
},
"age_min": 25,
"age_max": 40,
"interests": [{"id": "6003139266461", "name": "Technology"}]
}' \
https://graph.facebook.com/v21.0
/act_YOUR_AD_ACCOUNT_ID/customaudiences
I gruppi di inserzioni possono contenere una o più inserzioni. Tutte le inserzioni contenute in un gruppo di inserzioni devono avere targetizzazione, budget, fatturazione, obiettivo di ottimizzazione e durata uguali.
Puoi impostare le opzioni di budget, programmazione, targetizzazione, strategia di offerta e posizionamento. I gruppi di inserzioni consentono di perfezionare come e dove le inserzioni vengono pubblicate su segmenti di pubblico specifici, ottimizzando le prestazioni e raggiungendo obiettivi di marketing.
Parametri chiave:
Informazioni più dettagliate sono disponibili qui.
Puoi scegliere un posizionamento manuale che includa inserzioni di Instagram e Facebook Reels o i posizionamenti automatici predefiniti. Se non specifichi nulla per un particolare campo del posizionamento, vengono considerate tutte le posizioni predefinite possibili per tale campo.
curl -X POST \
-F 'access_token=YOUR_ACCESS_TOKEN' \
-F 'name=Reels Ad Set' \
-F 'campaign_id=YOUR_CAMPAIGN_ID' \
-F 'daily_budget=5000' \
-F 'billing_event=IMPRESSIONS' \
-F 'optimization_goal=REACH' \
-F 'start_time=2024-07-10T10:00:00-0700' \
-F 'end_time=2024-07-20T10:00:00-0700' \
-F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
-F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
-F 'status=PAUSED' \
-F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
-F 'publisher_platforms=["instagram"]' \
-F 'instagram_positions=["reels"]' \
https://graph.facebook.com/v21.0
/act_YOUR_AD_ACCOUNT_ID/adsets
publisher_platforms | facebook_position o instagram position | Obiettivi compatibili | optimization_goal |
---|---|---|---|
instagram |
| OUTCOME_APP_PROMOTION |
|
instagram |
| OUTCOME_AWARENESS |
|
instagram |
| OUTCOME_LEADS |
|
instagram |
| OUTCOME_TRAFFIC |
|
instagram |
| OUTCOME_ENGAGEMENT |
|
instagram |
|
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
facebook | facebook_reels |
|
|
Combinazione di obiettivo compatibile + optimization_goal | Reels di FB idonei? | Reels di IG idonei? |
---|---|---|
| ✅ | ❌ |
| ❌ | ✅ |
| ✅ | ❌ |
| ✅ | ❌ |
| ✅ | ❌ |
| ❌ | ✅ |
| ✅ | ❌ |
| ✅ | ❌ |
| ✅ | ❌ |
Le creatività dell'inserzione sono le componenti visive e testuali delle inserzioni, che supportano i seguenti formati pubblicitari:
Automatizza gli elementi di progettazione e ottimizza le prestazioni usando il nostro processo creativo.
Gli utenti possono fornire una nuova risorsa o riutilizzare un reel esistente dal proprio account Instagram come creatività dell'inserzione.
Puoi creare inserzioni da reel organici di Instagram o Facebook esistenti idonei per essere promossi, a condizione che:
Per riutilizzare un reel organico di Instagram come creatività dell'inserzione per una nuova campagna pubblicitaria procedi in questo modo:
Ottieni l'ID dell'account Instagram Business, che deve essere collegato a una Pagina Facebook
GET/{ad_account_id}/connected_instagram_accounts
oGET/{business_id}/instagram_business_accounts
Trova il reel che vuoi promuovere
GET/{ig-business-account-user-id}/media
Inserisci la creatività dell'inserzione
instagram_actor_id
nelle specifiche della creatività, imposta instagram_user_id
come ID utente di Instagramsource_instagram_media_id
come ID multimedialecall_to_action
per la tua promozioneUsa boost_eligibility_info
come modo pratico per determinare se i contenuti multimediali sono idonei a essere messi in evidenza come inserzione e boost_ads_list
per tracciare le informazioni sulle precedenti inserzioni in evidenza su Instagram relative all'inserzione.
curl -i -X POST \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>
Puoi automatizzare la generazione di elementi pubblicitari diversi e coinvolgenti, come immagini, video e testo. Questi strumenti basati sull'IA aiutano a ottimizzare le prestazioni delle inserzioni adattando i contenuti alle preferenze del pubblico e migliorando la varietà creativa. La creazione delle inserzioni comporterà un maggior coinvolgimento e campagne migliori.
Genere l'anteprima dell'inserzione nei formati Facebook e Instagram Reels tabulati di seguito usando:
PIATTAFORMA DI PUBBLICAZIONE | Formato pubblicitario |
---|---|
| |
|
curl -X POST \
'https://graph.facebook.com/v21.0
/act_{ad_account_id}/adpreviews' \
-F 'access_token={your_access_token}' \
-F 'creative={
"object_story_spec": {
"instagram_actor_id": "{instagram_actor_id}",
"video_data": {
"video_id": "{video_id}",
"title": "Check out our new product!",
"description": "Exciting new features and benefits.",
"call_to_action": {
"type": "LEARN_MORE",
"value": {
"link": "https://www.example.com/product"
}
}
}
}
}' \
-F 'ad_format=INSTAGRAM_REELS'
Per prenotare un'inserzione usando l'API Marketing, crea un oggetto di tipo gruppo di inserzioni e collega l'oggetto di tipo gruppo di inserzioni alla creatività dell'inserzione. Usa /act_{ad_account_id}/ads
per inviare il tuo oggetto pubblicitario e convalida la risposta per confermare la corretta prenotazione. Questo passaggio finalizza la configurazione della tua inserzione, rendendola pronta per la pubblicazione in base alle configurazioni fornite.
curl -X POST \
-F 'name="My Ad"' \
-F 'adset_id="<AD_SET_ID>"' \
-F 'creative={
"creative_id": "<CREATIVE_ID>"
}' \
-F 'status="PAUSED"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
Usa l'API Insights per recuperare le metriche dall'account pubblicitario alle inserzioni:
act_<AD_ACCOUNT_ID>/insights
<CAMPAIGN_ID>/insights
<ADSET_ID>/insights
<AD_ID>/insights
Quando pubblichi una campagna su Instagram e Facebook, aggiungi breakdowns=publisher_platform
per vedere separatamente le statistiche dei posizionamenti di Facebook e Instagram, come mostrato nella chiamata di esempio di seguito. Suddividendo gli insight per livello di posizionamento, sarà possibile vedere le prestazioni delle inserzioni tramite il posizionamento di Instagram e Facebook Reels.
curl -X GET \
'https://graph.facebook.com/v21.0
/{ad_account_id}/insights' \
-F 'access_token={your_access_token}' \
-F 'level=campaign' \
-F 'fields=campaign_name,impressions,clicks,spend' \
-F 'breakdowns=publisher_platform,platform_position' \
-F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
-F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'
OUTCOME_APP_PROMOTION
OUTCOME_AWARENESS
OUTCOME_ENGAGEMENT
OUTCOME_LEADS
OUTCOME_SALES
OUTCOME_TRAFFIC
L'API Marketing ha una propria logica di rate limiting ed è esclusa da tutte le limitazioni di rate limiting dell'API Graph. La funzione che influisce sulla quota di rate limiting dell'API Marketing è l'accesso standard a Gestione inserzioni. Per impostazione predefinita, ottieni l'accesso standard quando aggiungi il prodotto API Marketing alla tua Dashboard gestione app, che ti dà accesso come sviluppatore all'API Marketing. Per aumentare la quota del rate limiting, effettua l'upgrade all'accesso avanzato.
Le inserzioni di Reels trasformano l'attenzione in azione, migliorando i risultati. Quando le crei nel modo giusto, sono ancora più efficaci.
1. Crea inserzioni in formato video 9:16 per rendere il video accattivante: Reels è un formato video immersivo a schermo intero. Per fare in modo che le tue creatività si adattino a queste dimensioni, realizza un video e ridimensionalo nel formato 9:16.
2. Crea inserzioni in aree sicure in modo che i tuoi messaggi siano chiari: lavora all'interno delle aree sicure così che gli overlay degli adesivi con testo, le call to action e i messaggi chiave non siano oscurati dall'interfaccia utente di Reels. Evita di posizionare testo, logo e altri elementi chiave nel 35% inferiore delle tue creatività in formato 9:16.
3. Crea inserzioni con un suono che renda il video coinvolgente: che si tratti di musica, voiceover o effetti sonori, l'audio è un fattore chiave dell'interazione e dell'intrattenimento su Reels.