ドキュメントメニュー

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. 初回の実行が完了するまで同期履歴を確認します。

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

同期の動作#

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

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _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 で絞り込んでください。