転送元 - Google Analytics 4

概要

Google Analytics 4からレポートデータを転送する設定のヘルプページです。

制約

設定項目

STEP1 基本設定

STEP1の詳細設定

ジョブ実行時にエラーが発生した場合の対処

OutOfMemoryErrorが発生した場合

OutOfMemoryErrorが発生した場合、一回のリクエストで取得する行数の値を1,000まで下げることで、エラーを解消できることがあります。
ただしこの値を下げることで1リクエストあたりのトークン使用量が増加するため、後述のRateLimitErrorが発生しやすくなります。

RateLimitErrorが発生した場合

RateLimitErrorは、アナリティクス プロパティの任意の割り当てが枯渇したときに発生します。
エラーメッセージ中に含まれるbody: {"error":{"code":429,"message":xxx}}の内容から、どの割り当てが枯渇したかを確認し、適宜対応してください。

[ERROR]: Exhausted property tokens:
[ERROR]: 	tokens_per_day:{consumed:{total:21242,average:103},remaining:177780}
[ERROR]: 	tokens_per_hour:{consumed:{total:21242,average:103},remaining:25549}
[ERROR]: 	concurrent_requests:{consumed:{total:0,average:0},remaining:10}
[ERROR]: 	server_errors_per_project_per_hour:{consumed:{total:0,average:0},remaining:10}
[ERROR]: 	potentially_thresholded_requests_per_hour:{consumed:{total:0,average:0},remaining:120}
[ERROR]: 	tokens_per_project_per_hour:{consumed:{total:21242,average:103},remaining:0}
[ERROR]: Rate limit exceeded:
[ERROR]: 	status_code: 429
[ERROR]: 	body: {"error":{"code":429,"message":"Exhausted property tokens for a project per hour. These quota tokens will return in under an hour. To learn more, see https://developers.google.com/analytics/devguides/reporting/data/v1/quotas","status":"RESOURCE_EXHAUSTED"}}

割り当てが回復するまで待ってジョブを再実行する

たとえば、上記のようにtokens for a project per hourが原因の場合は、1時間程度で割り当てが回復します。
この場合、エラー発生後1時間程度経過した後にジョブを再実行してください。
アナリティクス プロパティの各割り当てについて、詳しくはGoogle Analytics Data API (GA4) - PropertyQuotaを参照ください。

1リクエストあたりのトークン消費量を抑える

割り当てが回復した状態でジョブを再実行してもRateLimitErrorが発生する場合は、1リクエストあたりのトークン消費量を減らすように調整してください。
トークン消費量は、エラーメッセージ中に含まれるconsumed内のaverageの値から確認できます。
トークン消費量の削減方法としては、以下の方法が考えられます。

• データ取得期間の範囲を狭める
• 取得対象のディメンション・メトリクスの種類を少なくする

割り当ての総量や回復のタイミングなどの各種仕様に関しては、Google Analytics Data API (GA4) - 割り当てを参照ください。

利用上の補足情報

プロパティIDの取得方法

Google Analyticsにログインし、左のバーの管理（歯車のアイコン）→プロパティ設定→プロパティ IDで確認できます。

ディメンション式について

ディメンション式のconcatenateを用いることで、すでにある複数のディメンションを連結した、新たなディメンションを定義できます。ディメンション式を利用した場合は、ディメンションのAPI Name列にある各ディメンション、およびカスタムディメンションのいずれとも重複しないディメンション名を入力してください。

メトリクス式について

メトリクス式を用いることで、既存のメトリクスに四則演算などを加えた、新たなメトリクスを定義できます。メトリクス式を利用した場合は、メトリクスのAPI Name列にある各メトリクス、およびカスタムメトリクスのいずれとも重複しないメトリクス名を入力してください。

STEP1 詳細設定

詳細設定をクリックすると、設定項目が表示されます。