Klaviyo でのデータウェアハウス同期について理解する

このページで学べること

Klaviyo からデータウェアハウスにデータを同期し、SFTP を介してデータウェアハウスのデータを Klaviyo にインポートする方法をご覧ください。顧客のプロファイルとイベントデータを同期できるため、Klaviyo 外で顧客に関する重要な情報を保存して分析できます。

This content requires Functional cookies to be enabled.

Update Cookie Settings

始める前に

接続するデータウェアハウスが宛先として設定されていることを確認する必要があります。これが正しく設定されていることを確認するには：

• Klaviyo に提供するユーザーに適切な権限があることを確認してください。
• ウェアハウスに基づき、以下に示す適切な名前でテーブルを設定してください。

また、Klaviyo の送信データウェアハウストラフィックの IP アドレスを許可リストに追加してください。これにより、Klaviyo のリクエストがセキュリティレイヤーによってブロックされないようになります。これらのアドレスは、次の CIDR 範囲で示されます：

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

データウェアハウスに接続します

Klaviyo にデータウェアハウス接続を追加するには、アドバンストKDP > データ管理 > 同期 に移動します。

データウェアハウスを追加するには、[コネクタを選択] モーダルでサポートされているデータウェアハウスを選択します。

または、[外部連携] > [アプリを探す] に移動し、プラットフォームを検索して、Klaviyo のアプリマーケットプレイスからデータウェアハウスを選択することもできます。

ウェアハウスを接続する際は、データウェアハウスから Klaviyo にデータをインポートするか、ウェアハウスを送信同期の宛先として設定できます。

SFTP 経由でデータをインポート

データウェアハウスから Klaviyo にデータをインポートする場合は、SFTP 経由で行えます。

データを Klaviyo にインポートするには、最初にウェアハウスの宛先に接続する際に[データをインポート] を選択するか、すでに接続が確立されている場合は Data syncing ページで[インポート] ボタンをクリックしてください。

Klaviyo に倉庫データをインポートする手順は次のとおりです：

1. データウェアハウスから必要なデータをエクスポートしてください。
2. ローカル マシンで SSH キーを生成します。
3. SFTP クライアントの設定とインポート。

データベースをエクスポートする

まず、ウェアハウスからデータをエクスポートする必要があります。ウェアハウスにログインし、Klaviyo にインポートしたいデータを CSV ファイルにエクスポートします。

ローカル マシンで SSH キーを生成する

ウェアハウスから必要なデータをエクスポートしたら、ローカル マシンで新しい SSH キーを生成し、SSH キーを追加ボタンを選択して Klaviyo に追加します。

SFTP クライアントの設定とインポート

SSH キーが Klaviyo に正常に追加されたら、SFTP クライアントを設定してデータをインポートする必要があります。

1. SFTP クライアントを開き、Klaviyo に表示される認証情報を使用して新しい接続を設定します。SSH キーを正常に追加すると、認証情報が表示されます
2. 認証後、インポートの前にデータベースが推奨ガイドラインに従っていることを確認してください。
3. SFTP クライアント経由でデータベース ファイルをアップロードし、確認します

最近のインポートのリストビューには、次の情報も表示されます。

• ステータス
  完了または未完了。
• 処理済み行数
  これまでに処理された行数の合計に対する割合。
• インポート日
  インポート日。
• インポート元
  データをインポートしたユーザー。

データをウェアハウスにエクスポート

宛先としてデータウェアハウスを設定するには、各データウェアハウスについて次の情報と認証情報のセットが必要です。

Amazon Redshift

Amazon Redshift を宛先として設定するには、次のスクリプトを実行して klaviyo_event テーブルと klaviyo_profile テーブルを作成します。

送信先として設定したら、次の一連の認証情報を使用してウェアハウスを Klaviyo に接続します：

• 名前: Redshift 内のデータベースの名前（Redshift のデータベースと同じ名前を使用することをお勧めします）
• ホスト URL: Amazon Redshift サーバーのエンドポイント（Redshift では接続 URL と呼ばれます）
• データベース: データソースを識別するための名前
• Port: Redshift で使用されるポート番号
• スキーマ: データベーススキーマ
• ユーザー名: Redshift へのログインに使用されるユーザー名
• データベース パスワード: Redshift へのログインに使用するパスワード
  

Amazon S3

宛先として Amazon S3 を設定するには、テーブル名を klaviyo_profile と klaviyo_event に設定します。

送信先として設定したら、次の一連の認証情報を使用してウェアハウスを Klaviyo に接続します：

• 名前：Amazon S3 データベースのマシン可読名。
• バケット：バケットの名前です。
• バケットの場所：ストレージ バケット作成時に選択されたリージョン名です。
• アクセスキー ID: AWS アクセスキー ID です。
• シークレット アクセスキー：AWS シークレット アクセスキーです。
  

Google BigQuery

Google BigQuery を送信先として設定するには、次のスクリプトを実行して klaviyo_profile テーブルと klaviyo_event テーブルを設定してください。接続プロセスを正常に完了するには、Google BigQuery アカウントに支払いプロファイルが必要です。

このスクリプトでは、プレースホルダー "SERVICE ACCOUNT EMAIL" を BigQuery サービス アカウントのメールアドレスに置き換える必要があります。

送信先として設定したら、次の一連の認証情報を使用してウェアハウスを Klaviyo に接続します：

• 名前: この宛先を識別するための名前
• プロジェクト ID: これはプロジェクト ID と呼ばれ、API コンソールで確認できます。
• データセット：スキーマとも呼ばれます。これは、セットアップのために実行すべきスクリプトで使用した名前と同じです。
• サービス アカウント キー： BigQuery でサービス アカウントを作成した際にダウンロードした JSON ファイルの内容全体を貼り付けます。
  

Microsoft Azure Synapse Analytics

Microsoft Azure を宛先として設定するには、次のスクリプトを実行して、klaviyo_profile テーブルと klaviyo_event テーブルを作成します。

送信先として設定したら、次の一連の認証情報を使用してウェアハウスを Klaviyo に接続します：

• 名前: Azure のデータベースと同じ名前を使用することをお勧めします。
• ワークスペース：Azure Synapse ワークスペース名。
• データベース名: 専用 SQL プール データベースを識別します。
• ユーザー名：専用 SQL プール データベースのログイン ユーザー名です。
• データベース パスワード:Dedicated SQL Pool データベースのログイン パスワードです。
• アカウント名：Windows Azure ストレージ アカウント、または作成した DNS プレフィックス。
• アクセス署名：Blob Storage コンテナへのアクセスを証明する共有アクセス署名（SAS）文字列。
• コンテナ名： データ転送の一時的なステージング領域として使用する Azure Blob コンテナ名です。
  

Snowflake

Snowflake を送信先として設定するには、次の手順に従ってください。

1. ターミナルで次のコマンドを実行して秘密鍵を生成します：

textCopy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. ターミナルで次のコマンドを実行して、秘密鍵を参照する公開鍵を生成します：

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. 次のスクリプトを実行して、KLAVIYO_PROFILE、KLAVIYO_EVENT、および KLAVIYO_METRIC テーブルを設定します。以下のセットアップを完了するには、securityadmin と sysadminprivileges が必要です。保有しているロールを確認するには、SHOW GRANTS TO USER <your_username> を実行し、両方のロールが一覧に表示されていることを確認してください。ロールの調整が必要な場合は、システム管理者にお問い合わせください。

送信先として設定したら、次の一連の認証情報を使用してウェアハウスを Klaviyo に接続します：

• 名前： Snowflake のデータベースと同じ名前を使用することをお勧めします。
• ユーザー名：データベースに接続するためのユーザー名です。これはセットアップスクリプトのuser_nameと同じである必要があります。
  
• 秘密鍵：生成された Snowflake 秘密鍵です。
  
• Warehouse:  Snowflake 内のウェアハウス。
• アカウント: Snowflake のアカウント。
• Database: データベース名です。これはセットアップスクリプト内の database_name と同じである必要があります。
• スキーマ： データベーススキーマです。これはセットアップ スクリプト内の schema_name と同じである必要があります。
  

同期先のデータウェアハウスの認証情報を入力したら、Klaviyo から同期するデータを選択してください。

データオブジェクト

データオブジェクトセクションでは、すべてのプロファイルデータ、特定のイベントデータのみ、または両方のデータタイプを、各オプションの横にある該当するチェックボックスをオンにして同期するよう選択できます。

除外する外部連携

除外する外部連携 フィールドで、データウェアハウス同期から除外する特定の外部連携を選択できます。これは、Klaviyo にすでに接続している特定の外部連携のデータが同期されないように削除したい場合に役立ちます。

選択的同期

Selective sync フィールドでは、Klaviyo からデータウェアハウスに同期する特定のイベントを選択します。デフォルトでは、すべてのイベントが含まれます。このフィールドで同期する特定のイベントを設定すると、選択したイベントのみが同期されます。

データの同期頻度を選択

データの同期頻度を選択というセクションの定期同期の頻度フィールドに設定した値によって、Klaviyo からデータウェアハウスへの同期がどのくらいの頻度で実行されるかが定義されます。

同期する履歴データの量の選択

同期する履歴データの量を選択セクションでは、初回接続時に Klaviyo からデータウェアハウスへ同期する履歴データの量を定義できます。次から選択できます：

• 30 日
• 90 日
• 1 年
• 全期間

レビューを同期する

外部連携を接続した後、セットアップが成功した場合は、接続が Enabled であることを示す最終画面が表示され、以下も表示されます：

• 設定した同期の詳細
• どのデータが共有されているか（プロファイル、イベント、またはその両方）
• 除外された外部連携

同期が正常に接続されなかった場合は、代わりに 接続できませんステータスが表示され、接続を再試行するか、認証情報の情報を編集するかのいずれかのオプションが表示されます。

データウェアハウスの接続に成功すると、メインの Data syncing リストページに戻ります。ここでは、次が表示されます。

• データウェアハウスの Destination
• [有効] ステータス
• 過去 24 時間に同期で発生した可能性のあるエラー
• このイベントのタイムスタンプとともに発生した直近の同期

接続できる宛先は常に 1 つだけなので、このリストビューにも 1 つの宛先のみが表示されます。

データ同期ダッシュボード

接続に成功したら、データ同期 リストページから外部連携をクリックします。ここから、実行されたデータ同期に関する過去と現在の情報を提供するデータ同期ダッシュボードに移動します。

ここでは、同期情報が 2 つのタブに分かれて表示されます：

• 履歴
• 定期的

履歴

履歴 タブには、履歴データ同期のステータスを示すログがあります。履歴同期とは、接続を確立した際に既存のデータを Klaviyo からデータウェアハウスに同期することを指します。

各同期について、次の情報が表示されます:

• Name
  データが同期に含まれています。
• ステータス
  ステータスと同期の予測進捗（推定パーセンテージ）、または注記された潜在的なエラー。これらのステータスには、次のようなものが含まれます。
  
  
  • 完了
    この 1 回限りの同期のデータ同期が完了しました。自動的に再同期されることはありません。
  • スケジュール済み
    次の同期が自動的に実行されるようにスケジュールされている場合。
  • 進行中
    データはデータウェアハウスにアクティブに同期されており、完了率の推定割合が表示されます。
  • エラー
    エラーが発生しましたが、Klaviyo は接続の再確立を試行し続けます。外部連携によっては、このタイミングがわずかに異なる場合があります。
  • 失敗
    接続の再確立を試みた後も同期が完全に失敗しました。そのため、設定構成の見直しや、場合によってはデータウェアハウスのセットアップの確認も必要になります。
  • 一時停止
    同期を手動で一時停止しました。
  • 無効
    外部連携自体が無効化または削除されたため、同期が無効になりました。
• 開始日時
  同期の開始時刻。
• 終了日
  同期の終了時刻です。

定期的

Periodic タブには、定期同期のステータスを示すログがあります。顧客が引き続きブランドとやり取りし、新しいデータが作成されると、そのデータは定期的にデータウェアハウスに送信されます。データウェアハウス接続を設定すると、定期同期は 1 時間ごとに実行されます。

各同期について、次の情報が表示されます:

• Name
  データが同期に含まれています。
• ステータス
  ステータスと同期の予測進捗（推定パーセンテージ）、または注記された潜在的なエラー。これらのステータスには、次のようなものが含まれます。
  
  
  • 完了
    この 1 回限りの同期のデータ同期が完了しました。自動的に再同期されることはありません。
  • スケジュール済み
    次の同期が自動的に実行されるようにスケジュールされている場合。
  • 進行中
    データはデータウェアハウスにアクティブに同期されており、完了率の推定割合が表示されます。
  • エラー
    エラーが発生しましたが、Klaviyo は接続の再確立を試行し続けます。外部連携によっては、このタイミングがわずかに異なる場合があります。
  • 失敗
    接続の再確立を試みた後でも同期が完全に失敗しました。これは、構成設定、またはデータウェアハウスのセットアップを確認する必要があることを意味します。
  • 一時停止
    同期を手動で一時停止しました。
  • 無効
    外部連携自体が無効化または削除されたため、同期は無効になりました。
• データの鮮度
  データの鮮度とは、データがどの程度最新であるかを指します。たとえば、同期の鮮度が 2 分の場合、直近 2 分間に Klaviyo で作成された新しいデータは、まだデータウェアハウスに存在しないことを意味します。
• [一時停止]、[再開]、および個別の同期の再有効化のボタン。

データウェアハウス接続の削除

Klaviyo アカウントからデータウェアハウス接続を削除するには、 [外部連携] タブを選択します。

データウェアハウス外部連携の横にあるメニューを開き、[外部連携を削除] を選択して接続を削除します。

エラーログを表示

Klaviyo とデータウェアハウス間のデータ同期に問題が発生している場合、関連するエラー ログを確認すると、問題の原因に関する追加情報を得られます。

エラーを確認するには、同期中ページでウェアハウスの宛先をクリックします。履歴と定期同期タブの両方に、エクスポートとそのステータスの一覧、およびアクティブなエラーがあるかどうかを示すインジケーターが表示されます。

特定のエラーの詳細を確認するには、失敗が発生しているエクスポートをクリックします。

ここでは、送信方向の同期のタイムラインと、同期のステータスに基づくエラーまたは成功メッセージを確認できます。

特定のエラーをクリックすると、以下の情報を含むドロワーが開きます。

• 概要
  データウェアハウスから返されたエラーの簡単な説明
• コード
  エラーのエラーコード
• External message
  データウェアハウスから返された実際のエラーメッセージです。
• 日付
  エラーが発生した日時

その他のリソース