Klaviyo データを BigQuery に読み込む

Klaviyo から BigQuery に定期的にデータ転送を行うようにスケジュールするには、転送するデータ オブジェクトと、データ転送のスケジュールを設定する頻度を指定する転送構成を作成します。転送構成は、 コンソール Cloud de Confiance または bq コマンドラインツールを使用して作成できます。転送構成を設定すると、 BigQuery Data Transfer Service は、指定したスケジュールで最新の データを BigQuery テーブルに転送します。

Klaviyo 転送の仕組みについては、 Klaviyo データ転送の概要をご覧ください。

制限事項

• ウォーターマーク列として選択できるのは TIMESTAMP 列のみです。
• 増分取り込みは、有効なウォーターマーク列があるアセットでのみサポートされます。
• ウォーターマーク列の値は単調に増加する必要があります。
• 増分転送では、ソーステーブルの削除オペレーションを同期できません。
• 1 つの転送構成でサポートできるのは、増分取り込みまたは完全取り込みのいずれかのみです。
• 最初の増分取り込みの実行後に、asset リスト内のオブジェクトを更新することはできません。
• 最初の増分取り込みの実行後に、転送構成の書き込みモードを変更することはできません。
• 最初の増分取り込みの実行後に、ウォーターマーク列または主キーを変更することはできません。
• 宛先の BigQuery テーブルは、指定された 主キーを使用してクラスタ化され、クラスタ化テーブルの制限が適用されます。
• 既存の転送構成を増分取り込みモードに初めて更新すると、その更新後の最初のデータ転送で、データソースから使用可能なすべてのデータが転送されます。それ以降の増分データ転送では、データソースの新しい行と更新された行のみが転送されます。

始める前に

以降のセクションでは、Klaviyo のデータ転送を作成する前に必要な前提条件について説明します。

Klaviyo の前提条件

Klaviyo コネクタが BigQuery にデータを転送できるようにするには、読み取り専用の非公開 API キーが必要です。詳細については、 秘密鍵を作成するをご覧ください。

BigQuery の前提条件

• BigQuery Data Transfer Service を有効にするために必要なすべての操作が完了していることを確認します。
• データを保存する BigQuery データセットを作成します。

必要な BigQuery のロール

BigQuery Data Transfer Service データ転送の作成に必要な権限を取得するには、プロジェクトに対するBigQuery 管理者 （roles/bigquery.admin）IAM ロールを付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、BigQuery Data Transfer Service のデータ転送の作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

カスタムロールや他の 事前定義ロールを使用して、これらの権限を取得することもできます。

詳細については、bigquery.admin のアクセス権を付与するをご覧ください。

Pub/Sub の転送実行通知を設定する場合は、pubsub.topics.setIamPolicy IAM 権限があることを確認してください。メール通知のみを設定する場合は、Pub/Sub の権限は必要ありません。詳細については、 BigQuery Data Transfer Service の実行通知をご覧ください。

Klaviyo のデータ転送を設定する

次のいずれかのオプションを使用して転送構成を設定し、Klaviyo データを BigQuery に追加します。

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=klaviyo
        --display_name='My Transfer'
        --params= ' {
            "assets": [ "Events" , "Flows"] ,
            "connector.authentication.privateApiKey" : "pk_123456789123",
            "connector.startDate": "2025-10-20"
            }'

定期的なスケジュール外でデータ転送を手動で実行するには、 バックフィル実行を開始します。

Klaviyo データ転送に含まれるデータのリストについては、 Klaviyo データモデル リファレンスをご覧ください。

転送の設定に関するトラブルシューティング

データ転送の設定で問題が発生した場合は、Klaviyo の転送に関する問題をご覧ください。

次のステップ

• BigQuery Data Transfer Service の概要については、 BigQuery Data Transfer Service とはをご覧ください。
• 転送構成に関する情報の取得、転送構成の一覧表示、転送の実行履歴の表示など、転送の使用方法については、転送の管理をご覧ください。