Ottieni statistiche e commenti del post

Restituisce ciò che la piattaforma riporta su un singolo post pubblicato su un singolo canale: le sue metriche di coinvolgimento e i commenti lasciati sul post.

Caso d'uso: un pannello di coinvolgimento per singolo post. Quando un cliente apre un post pubblicato nella tua interfaccia, chiama GET /social/posts/{postId} per ottenere l'elenco dei canali, quindi chiama questo endpoint una volta per ciascun canale usando il relativo id. Esegui il parsing di insights, visualizza le metriche che riconosci e ignora le altre: in questo modo, l'aggiunta di un campo da parte di una piattaforma non comprometterà mai il funzionamento della tua pagina.

Caso d'uso: mettere in evidenza i commenti che richiedono una risposta. Interroga periodicamente questo endpoint per i post pubblicati di recente e inoltra alla tua casella di posta le nuove voci dell'array comments ottenuto dal parsing. Tieni presente che questo endpoint è di sola lettura: la risposta a un commento va pubblicata sulla piattaforma, non tramite la Listings API.

Note.

• socialConnectedChannelId è obbligatorio ed è il valore id della connessione ottenuto dalle connessioni del brand, non il valore referenceId della piattaforma. Le statistiche sono sempre limitate a un singolo canale, perché i numeri provengono dall'API di quella piattaforma.
• Il canale deve appartenere allo stesso brand del post. Se abbini un post alla connessione di un altro brand, l'endpoint restituisce SY95052.
• Solo i post pubblicati hanno statistiche. Per un post che è ancora SCHEDULED, o la cui pubblicazione su questo canale non è riuscita, l'endpoint restituisce payload vuoti anziché un errore, quindi controlla connectedChannels[].status sul post prima di trarre conclusioni.
• L'aggiornamento delle metriche dipende dalla piattaforma: per la maggior parte delle piattaforme, ciò significa un ritardo da pochi minuti a qualche ora dopo la pubblicazione. Interroga l'endpoint a intervalli regolari anziché aspettarti dei numeri subito dopo che connectedChannels[].status passa a SUCCESS.
• Il numero di commenti è limitato a quelli che la piattaforma restituisce in una singola pagina; questo endpoint non recupera le pagine successive.