ドキュメントメニュー

Klaviyo#

プライベート API キーを使って Klaviyo を接続します。このソースは titan.klaviyo に 9 個の固定テーブルを書き込みます。

sql
select
  id,
  email,
  first_name
from titan.klaviyo.profiles
limit 10

Klaviyoを接続する#

  1. アプリを開き、アプリを接続を選択してから、Klaviyoを選択します。

  2. プライベート API キーを入力します。

  3. テーブルを確認してからソースを保存します。

  4. 初回の実行が完了するまで同期履歴を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

同期の動作#

プロフィール、リスト、キャンペーン、フロー、指標、イベント、セグメント、テンプレート、カタログ商品をまとめて同期します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトのスケジュールでは、組織のタイムゾーンで平日の 5:00、10:00、15:00、20:00 と日曜日の 20:00 に同期し、各ソースはその時刻から 30 分以内に開始します。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _synced_at と _deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。

テーブルリファレンス#

profiles#

titan.klaviyo.profiles には 8 個のソース列があります。

klaviyo.profiles8列
idstringpk

ソースのフィールド id。

emailstring

ソースのフィールド email。

first_namestring

ソースのフィールド firstName。

last_namestring

ソースのフィールド lastName。

phonestring

ソースのフィールド phone。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

propertiesjson

ソースのフィールド properties。

lists#

titan.klaviyo.lists には 4 個のソース列があります。

klaviyo.lists4列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

campaigns#

titan.klaviyo.campaigns には 6 個のソース列があります。

klaviyo.campaigns6列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

statusstring

ソースのフィールド status。

created_atdatetime

ソースのフィールド createdAt。

updated_atdatetime

ソースのフィールド updatedAt。

send_timedatetime

ソースのフィールド sendTime。

flows#

titan.klaviyo.flows には 6 個のソース列があります。

klaviyo.flows6列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

statusstring

ソースのフィールド status。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

trigger_typestring

ソースのフィールド triggerType。

metrics#

titan.klaviyo.metrics には 5 個のソース列があります。

klaviyo.metrics5列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

integrationjson

ソースのフィールド integration。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

events#

titan.klaviyo.events には 5 個のソース列があります。

klaviyo.events5列
idstringpk

ソースのフィールド id。

metric_idstring

ソースのフィールド metricId。

profile_idstring

ソースのフィールド profileId。

datetimedatetime

ソースのフィールド datetime。

event_propertiesjson

ソースのフィールド eventProperties。

segments#

titan.klaviyo.segments には 4 個のソース列があります。

klaviyo.segments4列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

templates#

titan.klaviyo.templates には 6 個のソース列があります。

klaviyo.templates6列
idstringpk

ソースのフィールド id。

namestring

ソースのフィールド name。

editor_typestring

ソースのフィールド editorType。

htmlstring

ソースのフィールド html。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

catalog_items#

titan.klaviyo.catalog_items には 6 個のソース列があります。

klaviyo.catalog_items6列
idstringpk

ソースのフィールド id。

titlestring

ソースのフィールド title。

descriptionstring

ソースのフィールド description。

urlstring

ソースのフィールド url。

createddatetime

ソースのフィールド created。

updateddatetime

ソースのフィールド updated。

削除と履歴#

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。