Klaviyo のグループメンバーシップ API を使用してオンサイトコンテンツをパーソナライズする方法

推定 1 分で読めます

更新日 2025年11月18日 0:00 EST

このページで学べること

ウェブサイトでのオンサイトパーソナライゼーションを実装するために使用できる、klaviyo JavaScript オブジェクトの getGroupMembership メソッドの使用方法をご確認ください。これには、klaviyo オブジェクトを読み込み、確認するリストまたはセグメントの配列を渡す必要があります。これにより、オンサイトパーソナライゼーションに活用できる出力が返されます。

アドバンストKDP は Klaviyo の標準マーケティングアプリケーションには含まれておらず、関連機能にアクセスするにはサブスクリプションが必要です。このプランの購入方法については、請求ガイドをご覧ください。

始める前に

この機能はアドバンストKDPに契約したお客様のみに提供され、klaviyoオブジェクトを通じてのみ利用できます。klaviyo JavaScript オブジェクトとその機能の詳細については、Klaviyo オブジェクトの概要をご覧ください。

サイトに Klaviyo のオンサイトトラッキングを追加すると、"known browsers" の閲覧アクティビティのみがトラッキングされます（つまり、訪問、エンゲージメント、識別された、または "cookied" されたブラウザ）。Klaviyo のオンサイトトラッキングでは匿名ブラウザはトラッキングされません。Klaviyo がオンサイトトラッキングのためにサイト訪問者を識別する主な方法は 3 つあります：

誰かが Klaviyo Email からウェブサイトへのクリックスルーを行った場合
Klaviyo のフォームから購読した場合
誰かがサイトにログインしていて、トラッキングがインストールされている場合

グループメンバーシップ API の使用に関する Klaviyo の動画をご覧ください。

Klaviyo.js をインストールし、Klaviyo オブジェクトを読み込む

まだ行っていない場合は、まず Klaviyo.js をインストールする必要があります。Klaviyo.js は、Klaviyo のアクティブオンサイト JavaScript とも呼ばれ、klaviyo オブジェクトを自動的にサポートします。Klaviyo アカウントとの外部連携を有効にしている場合、または Klaviyo.js を手動でインストールした場合は、関連する呼び出しをリッスンするために klaviyo オブジェクトを初期化できます。

ページ読み込み時にすぐ klaviyo オブジェクトを使用するには、（上記のとおり Klaviyo.js をインストールすることに加えて）サイトに以下のスニペットを手動でインストールすることをおすすめします。klaviyo オブジェクトは、ページごとに 1 回だけ読み込む必要があります。

klaviyo オブジェクトを読み込むには：


 
!(function () {
  if (!window.klaviyo) {
    window._klOnsite = window._klOnsite || [];
    try {
      window.klaviyo = new Proxy(
        {},
        {
          get: function (n, i) {
            return "push" === i
              ? function () {
                  var n;
                  (n = window._klOnsite).push.apply(n, arguments);
                }
              : function () {
                  for (
                    var n = arguments.length, o = new Array(n), w = 0;
                    w < n;
                    w++
                  )
                    o[w] = arguments[w];
                  var t =
                      "function" == typeof o[o.length - 1] ? o.pop() : void 0,
                    e = new Promise(function (n) {
                      window._klOnsite.push(
                        [i].concat(o, [
                          function (i) {
                            t && t(i), n(i);
                          },
                        ]),
                      );
                    });
                  return e;
                };
          },
        },
      );
    } catch (n) {
      (window.klaviyo = window.klaviyo || []),
        (window.klaviyo.push = function () {
          var n;
          (n = window._klOnsite).push.apply(n, arguments);
        });
    }
  }
})();

オンサイトのパーソナライズのために、klaviyo JavaScript オブジェクトの getGroupMembership メソッドを使用するには：

コード内で、メンバーシップを確認するリスト ID またはセグメント ID を選択します。上限は 50 件のリストまたはセグメントです。
Klaviyo フォームまたはその他の方法で、サイト上のユーザーを識別します。
メンバーシップを確認するリスト ID またはセグメント ID の配列を使用して、次の形式で呼び出しを行ってください：


klaviyo.getGroupMembership(['listID1', 'listID2', 'listID3'])

提供される出力は、識別されたユーザーが所属しているリスト/セグメント ID の配列です（入力配列内にそれらの ID が含まれていた場合）。空の配列が返された場合は、渡した ID の数が多すぎるか、ユーザーが指定したリストまたはセグメントのいずれにも属していないことを意味します。

返されたセグメントとリストメンバーシップのデータを使用して、Klaviyo の顧客セグメントに基づき、関連性の高い商品、コンテンツなどでサイトをカスタマイズできます。

コード例

複数のセグメント ID を指定して getGroupMembership API を呼び出す方法の例を以下に示します。


const customerSegments = await klaviyo.getGroupMembership([
  VIPSegmentID,
  UnEngagedSegmentID,
  DogLoversSegmentID
]);

サイトのパフォーマンスへの影響

グループメンバーシップ API がサイトのパフォーマンスに与える影響は最小限です。Klaviyo がサイト上で読み込む Javascript ファイル（例：web_personalization.js）は約 1.2 KB のみで、このファイルのバンドルリクエストはメインスレッドをブロックしないため、どのページのユーザビリティにも影響しません。

顧客プロファイルに基づいてサイトをカスタマイズするために読み込まれるデータは、最初にリクエストされた後にブラウザにキャッシュされるため、追加のリクエストではバックエンド API 呼び出しは不要です。