この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない可能性があります。情報に不明な点がある場合は、英語版を参照してください。
このAPIは、集計データではなく生データを抽出することを可能にします。ページビューまたはセッションレベルで生データを抽出できます。エクスポートジョブは、この生データAPIを使用してプログラム的に作成、実行、ダウンロードできます。または、生データエクスポート機能を使用して手動でダウンロードできます。
Contentsquareの分析機能の集計データを取得する必要がある場合は、メトリクスAPIを使用してください。
ユースケース
- データの所有権と柔軟性：Contentsquareデータをデータウェアハウスにロードし、履歴化し、独自のカスタム計算とレポートを実装する
- クロスデバイス分析：Webおよびアプリプロジェクトからのデータを調整する
- ユーザー中心の分析：ユーザーがジャーニーの複数のセッションでどのように行動するかを理解する
- （再）活性化：行動セグメントをエクスポートし、マーケティングスタックで活用する
- データサイエンス：詳細なContentsquareデータを掘り下げ、モデルに行動次元を追加する
ベストプラクティス
- エクスポートを、フィールドと行のフィルタリング、セグメント、デバイスに必要なものに制限してください。
- 分離されたカラムにエクスポートできるCvars / Dvars（最大10）を特定してください（パイプラインで処理しやすくなります）。
- データに配列（値のリスト）のフィールドが含まれている場合は、エクスポートをJSON形式にすることをお勧めします => JSONで解析しやすく、CSVではより複雑です。
- 新しいPOSTエンドポイントを使用して、ジョブの作成を自動化し、データの完全な履歴を構築してください。
ステップ1： API資格情報を作成する
これらの指示に従って資格情報を生成してください。
ステップ2：APIをクエリする
定期的に取得したいデータエクスポートを作成し、API資格情報を作成したので、APIを介してデータを取得する時が来ました。
APIの動作とクエリの方法に関する詳細なドキュメントについては、私たちの生データAPIドキュメントを継続してお読みください。
FAQ
クエリは私の月間リクエスト制限にカウントされますか？
いいえ。生データAPIのエンドポイントに対するクエリは、Open APIの月間リクエスト制限には寄与しません（その制限はMetrics APIエンドポイントへのリクエストによってのみ達成されます）。
エクスポートが期待通りにダウンロードされない場合はどうなりますか？
生データAPIで発生する可能性のあるエラーは、UIに明確には表示されません。期待されるファイルが最近のエクスポートインターフェースにない場合、エラーが発生したことを意味し、再試行する必要があります。エラーを確認するには、APIを通じてジョブ実行のリストを確認できます：失敗したジョブ実行は状態が「失敗」となります。
セグメント定義を変更した場合はどうなりますか？
セグメント定義の変更は、このセグメントの履歴データを再エクスポートする必要があるかもしれません。