Новая метрика в API Page Insights

Когда компании развивают свои Страницы и добавляют всё больше актуальной информации для клиентов, им очень важно отслеживать, насколько эффективно работает их контент на платформе Facebook. На основании партнерских отзывов мы выявили потребность в более подробной статистике о кросспостинге и публикации видео. Теперь она доступна в новой метрике — page_video_views_by_uploaded_hosted.

Эта метрика позволяет компаниям отслеживать количество просмотров видео, которые они опубликовали, которыми поделились или для которых сделали кросспостинг на своей или других Страницах.

Существующие фильтры для конечной точки /insights (например, диапазон дат) по-прежнему доступны, их можно добавлять в запросы.

Ответ имеет следующую структуру:

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

Расшифровка ответа

Ответ метрики содержит множество полей. Вот что они означают:

• page_uploaded — количество просмотров видео, опубликованных вашей Страницей, в том числе когда этими видео поделились или сделали кросспостинг на других страницах;
• page_uploaded_from_crossposts — количество просмотров видео, для которых сделали кросспостинг на других страницах;
• page_uploaded_from_shares — количество просмотров видео, которыми поделились на других страницах;
• page_hosted_crosspost — количество просмотров видео, которые находятся на вашей Странице и для которых сделали кросспостинг с других страниц;
• page_hosted_share — количество просмотров видео, которые находятся на вашей Странице и которыми поделились с других страниц;
• page_owned — количество просмотров видео, которые находятся на вашей Странице и изначально были на ней опубликованы.

Благодаря новой метрике вы сможете понять, как ваш контент воспринимают пользователи на вашей и других страницах, где он был опубликован.

Дополнительные ресурсы

Если вы ещё не используете API Page Insights, эти ресурсы помогут начать работу с ним:

• Документация по API Page Insights — подробная документация для разработчиков.
• Запись в блоге о начале работы с API Page Insights — статья с подробными инструкциями по началу работы.
• Пример панели API Insights на GitHub — репозиторий с примером панели, интегрируемым с API Page Insights, который поможет понять, как работать с API.