- Post Analytics: 投稿に関するアナリティクスを取得
- Social Analytics: ソーシャルアカウントに関するアナリティクスを取得
- Link Analytics: 短縮リンクに関するアナリティクスを取得
データの鮮度について
成功したアナリティクスレスポンスにはすべて、2 つのタイムスタンプが含まれます:lastUpdated: 参照しているメトリクスがソーシャルネットワークから取得された時刻です。nextUpdate: リクエストが再び新しいメトリクスを取得する最も早い時刻です。
nextUpdate が有用なシグナルとなります。
この間隔は固定ではないため、値をハードコードしないでください。間隔はソーシャルネットワークごとに異なり、一部のネットワークでは投稿の経過日数によっても変わります。エンゲージメントの大半は投稿後の最初の数日間に発生するため、数値の変動が止まった古い投稿は、最近の投稿よりもはるかに低い頻度で更新されることがあります。たとえば LinkedIn では、約 10 日を超えた投稿の更新は最大でも 1 日 1 回になります。アカウントアナリティクスには独自の間隔が適用されます。手元のレスポンスにどの間隔が適用されているかは、常に nextUpdate が示します。
定期的に数値が必要な場合は、固定タイマーでポーリングするのではなく、レスポンスの nextUpdate を読み取ってください。新しく取得できるデータがいつ利用可能になるかがわかります。
エラーレスポンスでは両方のフィールドが省略される場合があるため、常に存在すると仮定せず、防御的に読み取ってください。
Post Analytics
個別の投稿アナリティクスを利用できます。特定の投稿の詳細な分析データが欲しい場合に最適です。Ayrshare 経由で送信された投稿でも、ソーシャルネットワーク上で手動で公開された投稿でも対応します。 Post analytics は以下のソーシャルネットワークで利用できます:- Bluesky
- Snapchat
- Threads
- TikTok
- YouTube
- X/Twitter
Social Analytics
アカウントレベルのソーシャルアナリティクス(エンゲージメント、フォロワー数、人口統計、アカウントメタデータなど)も取得できます。 特定の投稿ではなく、ソーシャルアカウント全体のアナリティクスを取得したい場合はこのエンドポイントを利用してください。 ソーシャルアカウントレベルのアナリティクスは以下のソーシャルネットワークで利用できます:- Google Business Profile
- Snapchat
- Threads
- TikTok
- YouTube
- X/Twitter
Link Analytics
短縮リンクに関するアナリティクスも取得できます。Ayrshare 経由で送信されたリンクでも、ソーシャルネットワーク上で手動で公開されたリンクでも、そのリンクが何回クリックされたかを知りたい場合に最適です。 Link analytics は /links エンドポイントにあります。Link Analytics
短縮リンクに関するアナリティクスを取得します。