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