Introduzione di una nuova metrica nell'API Page Insights

Con l'aumentare delle dimensioni e della rilevanza delle Pagine per le aziende, assume sempre più importanza la possibilità che queste ultime possano monitorare le prestazioni dei loro contenuti sulla piattaforma Facebook. Sulla base del feedback dei partner, abbiamo identificato la necessità di includere insight più solidi sui video condivisi e di cui è stato effettuato il cross-posting, che ora saranno disponibili tramite la nuova metrica page_video_views_by_uploaded_hosted.

Grazie a questa metrica, le aziende potranno comprendere il numero di visualizzazioni dei video pubblicati, condivisi o di cui è stato effettuato il cross-posting sulla propria Pagina oltre ai propri video condivisi o di cui è stato effettuato il cross-posting su altre Pagine.

Tutti i filtri esistenti per l'endpoint /insights (ovvero, l'intervallo di date) saranno ancora disponibili e potranno essere aggiunti alla richiesta.

La risposta ha la struttura seguente:

          {
    "data": [
        {
            "name": "page_video_views_by_uploaded_hosted",
            "period": "{period}",
            "values": [
                {
                    "value": {
                        "page_uploaded": 0,
                        "page_uploaded_from_crossposts": 0,
                        "page_uploaded_from_shares": 0,
                        "page_hosted_crosspost": 0,
                        "page_hosted_share": 0,
                        "page_owned": 0
                    },
                    "end_time": "2022-10-02T07:00:00+0000"
                }
            ],
            "title": {title},
            "description": "{description}",
            "id": "{page_id}/insights/{metric_name}/{period}"
        }
    ],
    "paging": {
        "previous": {link_to_previous},
        "next": {link_to_next},
    }
}
        

Comprensione della risposta

La nuova metrica ha molti campi in una singola risposta; puoi orientarti con queste equivalenze:

• page_uploaded: visualizzazioni di video pubblicati dalla tua Pagina, inclusi condivisioni e cross-posting su altre Pagine
• page_uploaded_from_crossposts: visualizzazioni di video di cui è stato effettuato il cross-posting su altre Pagine
• page_uploaded_from_shares: visualizzazioni di video condivisi su altre Pagine
• page_hosted_crosspost: visualizzazioni sulla tua Pagina di video di cui è stato effettuato il cross-posting da altre Pagine
• page_hosted_share: visualizzazioni sulla tua Pagina di video che sono stati condivisi da altre Pagine
• page_owned: visualizzazioni sulla tua Pagina di video originariamente pubblicati sulla tua Pagina

Grazie a questa nuova metrica, sarà possibile comprendere meglio come i tuoi contenuti vengono utilizzati tra la tua Pagina e altre pagine su cui sono stati condivisi o su cui è stato effettuato il cross-posting.

Risorse aggiuntive

Se non hai ancora eseguito l'integrazione con l'API Page Insights, ecco alcune risorse e guide per iniziare:

• Documentazione sull'API Page Insights - Documentazione per gli sviluppatori con tutti i dettagli dell'API
• Post del blog Primi passi con l'API Pages Insights - Post del blog con istruzioni su come iniziare a usare l'API
• Dashboard di esempi per l'API Insights su GitHub - Repository della dashboard di esempi che integrano l'API Page Insights per mostrare prodotti che è possibile creare