Facebook Ad Library Ad
Gli annunci della Facebook Ad Library sono record pubblicitari pubblici con testo creativo, identità dell’inserzionista, media, call to action, tempistiche di diffusione, stato attivo e segnali disponibili di copertura o spesa. Questi campi supportano l’arricchimento di annunci selezionati, la revisione delle creatività, il monitoraggio pubblico della diffusione e il confronto in un preciso momento.
Funzionalità della Facebook Ad Library Ad API
- Risoluzione diretta dell’URL di Ad LibraryTrasforma un URL pubblico /ads/library con un parametro di query id numerico in al massimo un record di annuncio normalizzato.
- Contesto di creatività e inserzionistaRestituisce ID dell’archivio dell’annuncio, titolo e testo creativo, identità della pagina dell’inserzionista, URL pubblico della pagina, call to action e link di destinazione, quando esposti.
- Diffusione e segnali visibiliConserva orari di inizio e di fine, stato attivo, piattaforme di pubblicazione, contesto dei paesi, Mi piace della pagina, copertura, valuta e spesa quando il record pubblico li fornisce.
- Media normalizzati per annunci a più cardSeleziona il testo disponibile dello snapshot o della prima card per i campi standard e deduplica le risorse immagine e video trovate nello snapshot e nelle card, senza presentare una tabella completa delle varianti.
Parametri della Facebook Ad Library Ad API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL pubblico obbligatorio di un annuncio della Facebook Ad Library. Usa la forma canonica https://www.facebook.com/ads/library/?id={numeric_id}; una richiesta accetta un solo URL. |
Come usare la Facebook Ad Library Ad API
Invia un URL pubblico di Ad Library, segui l’attività asincrona e leggi il record dell’annuncio normalizzato dall’envelope di risultato standard.
- Prepara un URL pubblico della Facebook Ad Library il cui percorso è /ads/library e la cui query contiene un id numerico.
- Invia url a /v1/facebook-ad-library/ad e annota il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items; questo endpoint restituisce al massimo un record, quindi next_cursor di norma resta null e has_more resta false.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one itemCasi d’uso della Facebook Ad Library Ad API
- Arricchire un annuncio selezionato: Usa ID dell’archivio, identità dell’inserzionista, titolo creativo, testo, media, CTA, URL di destinazione e URL di input per completare un record di annuncio esistente.
- Esaminare asset creativi e destinazioni: Controlla i riferimenti deduplicati a immagini o video insieme a formato di visualizzazione, testo della CTA, tipo di CTA e link pubblico di destinazione per un annuncio noto.
- Esaminare il contesto pubblico di diffusione: Usa stato attivo, orari di inizio e di fine, piattaforme di pubblicazione, valori dei paesi e campi disponibili di copertura o spesa per esaminare il contesto pubblico di diffusione.
- Conservare istantanee degli annunci in un preciso momento: Salva i campi di creatività, inserzionista, diffusione, segnali visibili, URL di input e collected_at per confrontare in seguito lo stesso annuncio noto.
Consigli degli esperti per la Facebook Ad Library Ad API
- Invia un URL di Ad Library con il percorso esatto /ads/library e un parametro di query id numerico; URL di pagine, ID di pagine, URL di post e ID grezzi di annunci non sono input accettati.
- Considera un’attività riuscita senza record come un esito valido di annuncio non disponibile o non trovato, quando l’URL inviato è sintatticamente valido.
- Gestisci copertura, spesa, Mi piace della pagina, media, end_at, URL del profilo dell’inserzionista, CTA e valori dei paesi come campi pubblici facoltativi, invece di convertire i valori mancanti in zero.
- Per gli annunci con più card o più creatività, usa il nome e il testo normalizzati come campi rappresentativi e controlla l’elenco deduplicato dei media, senza dare per scontato che sia una tabella completa per variante.
API correlate
Oltre alla Facebook Ad Library Ad API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook Ad Library.
- Facebook Ad Library Search API — Cerca annunci pubblici per parola chiave con controlli su corrispondenza, annuncio, paese, stato, media, ordinamento, data e numero massimo di risultati.
- Facebook Ad Library Company Search API — Trova le Pagine inserzioniste candidate per nome di azienda o Pagina, con ID della Pagina, classificazioni, immagini, pubblico visibile e segnali di Instagram collegati.
- Facebook Ad Library Company Ads API — Raccoglie gli annunci pubblici di una Pagina inserzionista tramite il suo ID con creatività, diffusione, mercato, media, CTA e segnali visibili.