Voltar para Notícias para desenvolvedores

Apresentamos uma nova métrica na API de Insights sobre a Página

12 de abril de 2023PorAlex Enriquez

O acompanhamento do desempenho de conteúdos na plataforma do Facebook fica cada vez mais importante à medida que as Páginas das empresas crescem em tamanho e relevância. Com base em feedbacks de parceiros, identificamos a necessidade de incluir insights mais robustos sobre vídeos compartilhados e em publicações cruzadas. Esses insights agora estarão disponíveis por meio da nova métrica page_video_views_by_uploaded_hosted.

Com essa métrica, as empresas poderão interpretar a contagem de visualização de vídeos publicados, compartilhados e em publicações cruzadas na própria Página, bem como vídeos compartilhados e em publicações cruzadas em outras Páginas.

Os filtros existentes para o ponto de extremidade /insights (por exemplo, intervalo de datas) continuam disponíveis e poderão ser adicionados à solicitação.

Esta é a estrutura da resposta:

          {
    "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},
    }
}
        

Como interpretar a resposta

A nova métrica apresenta vários campos em uma única resposta. Use estas equivalências como guia:

  • page_uploaded: visualizações de vídeos publicados pela sua Página, incluindo compartilhamentos e publicações cruzadas em outras Páginas
  • page_uploaded_from_crossposts: visualizações de vídeos em publicações cruzadas em outras Páginas
  • page_uploaded_from_shares: visualizações de vídeos compartilhados em outras Páginas
  • page_hosted_crosspost: visualização da sua Página de vídeos em publicações cruzadas em outras Páginas
  • page_hosted_share: visualizações da sua Página de vídeos compartilhados em outras Páginas
  • page_owned: visualizações da Página de vídeos originalmente publicados na sua Página

Com essa métrica, será mais fácil entender como o seu conteúdo está sendo consumido na sua Página e em outras em que foi compartilhado ou publicado de maneira cruzada.

Recursos adicionais

Se você ainda não fez a integração com a API de Insights sobre a Página, estes são alguns recursos e guias para ajudar você: