Klaviyo とアプリ間の情報のやり取りを理解する

このページで学べること

API（アプリケーション プログラミング インターフェース）を介して、Klaviyo とサードパーティアプリ間で情報がどのように同期されるかについて説明します。Klaviyo の外部連携を介して交換されるほとんどのデータは一方向です。データは Klaviyo アカウントに取り込まれ、顧客データの幅広い範囲を活用できます。

外部連携が Klaviyo との間で情報を同期する仕組み

Klaviyo の API は、Klaviyo と Klaviyo アカウントに接続された他のアプリケーションとの間でデータをやり取りするための一連のインターフェイスです。Klaviyo を別のアプリケーションと初めて連携するには、OAuth で認証するか、API キーを使用する必要があります。API キーは、特定のアカウントに紐づく一意の識別子です。

Klaviyo では 2 種類の API キーが生成され、どちらもアカウントで確認できます：

• 公開
  公開 API キー（サイト ID と呼ばれる場合もあります）は、Klaviyo アカウントの一意の識別子です。このキーを第三者アプリが使用して、Klaviyo アカウント内の非公開情報にアクセスすることはできません。
• 非公開
  非公開 API キーは、Klaviyo からデータを読み取ったり、リストなどの機密性の高いオブジェクトを操作したりするために使用されます。購読やその他の顧客情報を更新するプロセスが安全かつ非公開になるようにします。非公開 API キーはパスワードのように扱ってください：安全な場所に保管し、公開しないでください。Klaviyo アカウントに追加されるデータのソースを追跡できるよう、アプリケーションごとに新しい非公開 API キーを生成できます。

Klaviyo API キーの種類に関するより詳細な情報については、API リファレンス ドキュメントをご覧ください。

Klaviyo の REST API

REST は、インターネット上でアプリケーション間のプラットフォームに依存しない通信のためのガイドラインを提供するアーキテクチャ スタイルです。Klaviyo REST API は主に JavaScript Object Notation（JSON）形式を使用して通信します。これにより、API メッセージに含まれる情報のための構造化されたレイアウトが提供されます。Klaviyo アカウントの以下の領域は、当社の REST API を介してアクセスできます。

• アカウント
• キャンペーン
• カタログ
• クーポン
• データプライバシー
• イベント
• フロー
• 画像
• リスト
• メトリック
• プロファイル
• レポート作成
• セグメント
• タグ
• テンプレート

上記の API はサーバーサイド アプリケーションから呼び出すように設計されていますが、クライアントサイド アプリケーションからイベントと購読を作成するためのクライアント API も用意しています。

Klaviyo JavaScript オブジェクト

klaviyo オブジェクトは、従来の _learnq オブジェクトと klOnsite オブジェクトに置き換わります。これらの JavaScript オブジェクトは、API とやり取りし、イベントを Klaviyo に送信するための簡易的な方法を提供します。klaviyo オブジェクトを使用すると、既知のプロファイルを識別し、ウェブサイト上のイベントやアクションをトラッキングできます。

その他のリソース