ページインサイトAPIに新しい指標を導入する

ページのサイズが大きくなり、ビジネスへの適合性も高まるにつれて、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をまだ統合していない場合、以下に示す資料やガイドが入門情報として役立ちます。

• ページインサイトAPIのドキュメント - APIの全詳細情報が掲載された開発者向けドキュメント
• ページインサイトAPIスタートガイドのブログ投稿 - APIの利用を開始するための詳しい手順について説明するブログ投稿
• GitHubにあるインサイトAPIのサンプルダッシュボード - ページインサイトAPIを統合して製品ビルドの可能性を示すサンプルダッシュボードリポジトリ