時間帯別クリック数取得API (v3)

指定した期間内の時間帯別（00:00〜23:59）クリック数を取得するAPIです。

特定リンク・グループ単位、またはアカウント全体の時間帯別トラフィック分布を分析できます。
キャンペーン効果の測定や最適な配信時間の特定、ユーザー行動の把握に活用できます。

このAPIはパーソナルプラン以上で利用可能です。

GET

/api/statistics/v3/clicks-by-hour?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

startYmd date required
検索開始日（例：2025-12-01）
endYmd date required
検索終了日（例：2025-12-31）。開始日と終了日の最大範囲は1か月です。
パーソナルプラン：最大7日
プレミアムプラン：最大14日
linkId string
リンクID。特殊文字やUnicodeが含まれる場合、URLエンコードが必要です。
パーソナルプラン: linkIdとdomainが必須で、個別リンクのクリック数のみ取得可能。
プレミアムプラン以上: 任意入力可能。
domain string
リンクドメイン。
grpIdx integer
リンクグループ。 グループIDXはグループ一覧APIを呼び出すか、ダッシュボードで確認できます。
指定された場合、そのグループに属するすべてのリンクのクリック数合計が返されます。プレミアムプラン以上で利用可能。 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-01",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-02",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-03",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-04",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-05",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-10",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

codeinteger
レスポンスコード: 0 = 成功、それ以外 = エラー
messagestring
レスポンスメッセージ。レスポンスコードが0以外の場合、エラー内容のメッセージが返されます。
resultarray
ymddate
日付。
hourinteger
時間 (0〜23)。
acesCntinteger
指定した時間帯の総クリック数。
pernCntinteger
その時間帯にリンクをクリックしたユニークユーザー数。

このAPIを利用する場面

リンククリックが1日のどの時間帯に集中しているかを把握したい場合に利用します。

キャンペーン配信時間の最適化や広告配信の時間設定、ユーザー行動の分析など、時間軸での意思決定に役立ちます。

特定リンクの分析やグループ単位での集計が可能です。
単なる統計ではなく、時間ベースの行動分析に活用できます。

取得対象の指定方法

取得範囲は次の3つの方法で指定できます。

linkIdとdomainを指定すると、対象リンクの時間帯別クリック数を取得できます。
grpIdxを指定すると、グループ内すべてのリンクのクリック数を合算して取得します。
いずれも指定しない場合は、アカウント全体のデータが返されます。

主な機能と分析指標

このAPIは単なるクリック数ではなく、時間単位の分析データを提供します。

時間帯別クリック数（accsCnt）

  • 各時間帯ごとの総クリック数
  • トラフィックのピーク時間帯を把握

ユーザー数（pernCnt）

  • 各時間帯のユニークユーザー数
  • クリック数とユーザー数の比率を分析

クリック数とユーザー数を比較することで、重複クリックやユーザー行動パターンの分析が可能です。

活用例

  • 配信時間の最適化: 過去データからクリックが多い時間帯に配信を集中
  • 広告配信の最適化: accsCntが高い時間帯を基準に配信時間を調整
  • ユーザー行動分析: pernCntを基準に新規流入が多い時間帯を特定
  • グループ分析: grpIdxでキャンペーングループ全体の時間別パフォーマンスを集計

利用時の注意点

  • startYmdとendYmdは必須パラメータであり、yyyy-MM-dd形式で指定してください。
  • 取得可能な最大期間はプランによって異なり、上限を超えるとエラーが返されます。
  • linkIdに特殊文字やUnicodeが含まれる場合は、URLエンコードを適用してください。
  • クリック数とユーザー数は一致しない場合があります。