Brand Sentiment Analysis
Il sentiment di un brand è il tono complessivo delle pagine web che lo citano: come si distribuiscono tra positivo, negativo e neutro e quali emozioni prevalgono, dalla gioia e dall’amore alla tristezza e alla rabbia. Suddiviso per siti, paesi, lingue e tipi di pagina dietro ogni gruppo, indica se le critiche arrivano dalla stampa, dai forum o da un mercato preciso, e alimenta report sulla reputazione, bilanci delle campagne e confronti con la concorrenza.
Funzionalità della Brand Sentiment Analysis API
- Tre gruppi di sentimentsentiments restituisce i gruppi positivo, negativo e neutro, e il mentions_count di ciascuno è il numero di pagine classificate al suo interno.
- Sei categorie di emozioneemotions raggruppa le stesse pagine secondo l’emozione più forte: gioia, amore, divertimento, condivisione, tristezza e rabbia.
- I siti dietro ogni gruppotop_domains elenca fino a 10 siti con più pagine nel gruppo e mostra chi guida la conversazione positiva o negativa.
- Paesi, lingue e tipi di paginacountries, languages e page_types indicano da dove provengono le pagine di ogni gruppo. WW indica i siti a diffusione mondiale, e i tipi includono news, blogs o message-boards.
- Una riga per brandUna richiesta restituisce la suddivisione completa della ricerca, pronta da salvare come istantanea datata.
Parametri della Brand Sentiment Analysis API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Brand, prodotto o tema da analizzare (fino a 100 caratteri). Le frasi tra virgolette doppie vengono cercate in modo esatto. |
Come usare la Brand Sentiment Analysis API
Invia un brand o un tema e leggi la suddivisione in una sola riga.
- Invia {"query": "notion"} in POST a /v1/brand-monitoring/sentiment.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded. Con termini ampi possono servire alcuni minuti.
- Leggi la suddivisione in results.items. has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questo risultato di una sola riga.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"notion"}'Casi d’uso della Brand Sentiment Analysis API
- Istantanea mensile della reputazione: Registra ogni mese il mentions_count di ogni gruppo di sentiment e segui nel tempo la quota di pagine negative.
- Individuare l’origine delle critiche: Esamina top_domains, countries e page_types del gruppo negativo per capire se le critiche si concentrano su pochi siti, in un paese o nei forum.
- Confronto con la concorrenza: Analizza il tuo brand e quelli dei concorrenti con ricerche costruite allo stesso modo e confronta il numero di pagine positive, negative e neutre e le emozioni prevalenti.
- Bilancio delle campagne: Confronta gruppi di emozione come la gioia o la rabbia prima e dopo una campagna per vedere come è cambiata la conversazione.
Consigli degli esperti per la Brand Sentiment Analysis API
- Analizza nomi specifici di prodotti o campagne invece di parole comuni: un termine ampio con milioni di menzioni può richiedere alcuni minuti.
- Esegui l’analisi dei concorrenti lo stesso giorno della tua, così tutte le istantanee riflettono lo stesso stato del web.
- Quando un gruppo cambia in modo netto, chiama Brand Mentions API con la stessa query e leggi le pagine che ci sono dietro.
API correlate
Oltre alla Brand Sentiment Analysis API, usa queste API quando ti serve un altro tipo di dati pubblici di Brand Monitoring.
- Brand Mentions API — Trova le pagine web che citano un brand, un prodotto o un tema, con il passaggio, l’autore, la data, il tipo di sito, i punteggi di sentiment ed emozione e l’autorevolezza di pagina e dominio.