Skip to main content
MoEngage Campaign Stats and Reports API を使用すると、MoEngage ダッシュボードの外部でマーケティングのパフォーマンスを監視できます。これらのエンドポイントを使用して、リアルタイムのプラットフォームレベルの統計を取得したり、長期的な分析のためにダウンロード可能なレポートを生成したりできます。

​
エンドポイント

Campaign Stats and Reports API は、主に 2 つの機能領域に分かれています。
  • Get Campaign Stats: プラットフォームレベルでリアルタイムのパフォーマンス指標（クリック、インプレッション、コンバージョン）を取得します。
  • Download Campaign Report: 指定した期間のキャンペーンデータファイルを直接ダウンロードします。

​
機能の比較

​
よくある質問

​
キャンペーン統計

1 回の API 呼び出しで、campaign_ids 配列に最大 10 個のキャンペーン ID を渡すことができます。さらに多くのキャンペーンのデータが必要な場合は、offset パラメーターと limit パラメーターを使用して結果をページングしてください。
metric_type パラメーターを使用すると、表示を切り替えることができます。TOTAL はすべての発生回数をカウントし（例: 1 人のユーザーによる 3 回のクリック）、UNIQUE はアクションを実行した個別のユーザー数をカウントします。
はい。レスポンスオブジェクトは Platform > Locale > Variation の階層構造になっているため、A/B テストやローカライズされたコンテンツの詳細なパフォーマンスを確認できます。
終了日なしで開始日のみを渡した場合、API はエラーレスポンスを返します。目的のレスポンスを取得するには、開始日と終了日の両方が必要です。
キャンペーン ID を指定せずに開始日と終了日を指定した場合、API は親キャンペーンと子キャンペーンの両方の統計を返します。統計は指定した期間について取得できます。
API レスポンス内で親キャンペーンに属する統計を識別するには、「Campaign Details and Reachability」API を使用できます。この API は、リクエストに含まれるすべてのキャンペーン ID を指定して呼び出す必要があります。親キャンペーンでは親キャンペーン ID フィールドが存在しないため、子キャンペーンと区別できます。
Campaign Details and Reachability API を使用すると、子キャンペーンを親キャンペーンに関連付けることができます。

​
キャンペーンレポート

これは通常、指定した FILENAME が正しくない場合、レポートが 7 日以上前に作成された（期限切れ）場合、またはパス内の APP_ID が認証情報と一致しない場合に発生します。
はい。Report API は、ワンタイムキャンペーンと定期キャンペーンの両方をサポートしています。ファイル名が、ダウンロードしたい特定のインスタンスと一致していることを確認してください。
連結にパイプ文字（|）が APPID|FILENAME|SECRETKEY のとおり正確に使用されていることを確認してください。SHA256 でハッシュ化する前に、生成された文字列が UTF-8 でエンコードされていることを確認してください。
選択した日付に、レポートを取得できる実行済みのキャンペーンが存在しない可能性があり、その場合はエラーメッセージが返されることがあります。
生成されたレポートは、作成日から 7 日で期限切れになります。
最大 90 日間のレポートを生成できます。

​
Postman コレクション

Postman コレクションを使用して、統合をテストし、署名ロジックを検証できます。Postman コレクションを表示 →