接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：Klaviyo］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいKlaviyo 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

Klaviyo への接続

Klaviyo に接続するには、まず以下のプロパティを設定して認証方法を選択します。

AuthScheme：Klaviyo に接続する際に使用する認証の種類。

選択した方法に応じて、追加の接続プロパティが必要です。サポートされている各認証タイプの設定手順については、以下を参照してください。

カスタムフィールドへのアクセス

デフォルトでは、本製品はシステムフィールドのみ表示します。カスタムフィールドを検出して含めるには、IncludeCustomFields をtrue に設定します。 IncludeCustomFields がtrue に設定されている場合、本製品はRowScanDepth レコードをスキャンしてカスタムフィールドを検出し、そのデータ型を判定します。すべてのレコードをスキャンしてカスタムフィールドを検出するには、RowScanDepth を0 に設定します。カスタムフィールドを有効にし、RowScanDepth を0 または大きな値に設定すると、パフォーマンスに影響を与える可能性があることに注意してください。

List_{ListName} とSegment_{SegmentName} を個別のビューとしてアクセスする

デフォルトでは、本製品はシステムテーブルとビューのみを表示します。 Klaviyo インターフェースと同様に、各リストとセグメントを個別のビューとしてモデル化するには、ListDynamicViews をtrue に設定します。

Klaviyo への認証

Klaviyo への認証には、API キーまたはOAuth PKCE のいずれかを使用できます。

API キー

まだAPI キーを生成していない場合は、はじめに生成します。

ユーザーアカウントにログインします。
Private API Key creation page に移動します。
Create Private API Key をクリックします。
Private API Key Name で、キーに名前を割り当てます。
Select Access Level で、必要なアクセスレベルを選択します。接続テストを成功させるには、最低限Accounts: Read アクセスが必要です。
Create をクリックしてAPI キーを生成します。生成されたAPI キーは一度しか表示されないので、コピーして保存してください。

次に、以下のプロパティを設定します。

AuthScheme：APIKey に設定。
APIKey：生成したPrivate API Key の値に設定。

OAuth PKCE

AuthScheme をOAuthPKCE に設定します。

デスクトップアプリケーション

OAuth PKCE を使用して認証するには、カスタムOAuth アプリケーションを作成する必要があります。手順については、カスタムOAuth アプリの作成を参照してください。

OAuth アクセストークンの取得およびリフレッシュ

次のプロパティを設定して、接続してください。

OAuthClientId アプリの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret アプリの登録時に割り当てられたクライアントシークレットに設定。アプリ登録時にシークレットが生成されなかった場合、これはオプションです。
CallbackURL アプリの登録時に定義されたリダイレクトURI に設定。例： http://localhost:3333

接続すると、本製品はデフォルトブラウザでKlaviyo のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

本製品はアクセストークンの期限が切れると自動的にリフレッシュします。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

Klaviyo への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for Klaviyo