コンバージョン計測

    コンバージョン計測


    記事の要約

    概要

    Shopliveが提供するスクリプトを使用して、コンバージョンイベントを計測することができます。

    ユーザーの購入が以下の条件を満たした場合、Shoplive経由コンバージョンとして計測されます。

    • ライブ配信(またはアーカイブ動画)、もしくはショート動画を3秒以上視聴

    • ライブ配信(またはアーカイブ動画)、もしくはショート動画に掲載された商品を、オンラインで購入

    • 掲載された商品を視聴した日から、28日以内に商品を購入

    ユーザーが複数のライブ配信/ショート動画を見ている場合、ユーザーが最後に視聴したライブ配信/ショート動画に対してのみコンバージョンが計上されます。
    また、ライブ配信(またはアーカイブ動画)と、ショート動画は別々にコンバージョンが集計されます。

    そのため、ライブ配信(またはアーカイブ動画)とショート動画の両方を視聴しているユーザーが1つの商品を購入した場合、ライブ配信に1件、ショート動画に1件と、それぞれに対してコンバージョンが計上されます。

    sendConversionEvent 関数

    購入完了ページで使用される sendConversionEvent() 関数は、購入された商品の商品IDをキー情報として購入イベントを記録します。購入イベントを、Shoplive視聴データと照合して、コンバージョンを計測しています。

    Shopliveに対してユーザー認証を行っているユーザーは、ユーザー認証により閲覧・購入のユーザーを認識します。ユーザー認証を行っていないユーザーに対しては、ローカルストレージに保存されているユーザー識別子を用いて、閲覧・購入のユーザーを認識します。

    コンバージョン設定オブジェクト

    フィールド名

    説明

    accessKey (必須)

    String

    Shopliveアカウントに掲載されているアクセスキー

    eventType (必須)

    String

    ‘purchase’ を設定してください。

    products (必須)

    Products

    以下の「商品オブジェクト」に沿って、設定してください。

    ユーザー認証

    userId

    ユーザー認証機能を使ってユーザーを特定し、閲覧・購入したユーザーを紐づけることができます。

    • ユーザーオブジェクトの基本構造

      フィールド名

      説明

      userId

      String

      ユーザー認証を使用するために、ユーザーIDが必要になります。
      (userIdを指定することは、コンバージョン計測機能にとっては必須ではありません。)

      userName

      String

      ユーザー名を指定。

    anonId

    これは、購入コンバージョンを追跡するために使用できる匿名IDです。別途管理するデバイスIDなどの識別値がある場合、この値をanonIdとして入力することで、ユーザー認証なしで視聴/購入データを関連付けることができます。ユーザーを管理する匿名IDなどを使用しない場合は、使用する必要はありません。

    • サンプルコード

      <script type="text/javascript" src="https://static.shoplive.cloud/shoplive.js"></script>
      <script>
        // Shopliveのinit()にanonIdとaccessKeyを指定 (anonIdを指定するinitは、購入ページだけでなく、プレイヤーページでも行う必要があります)
        cloud.shoplive.init({
          accessKey: 'YOUR_ACCESS_KEY',
          anonId: 'USER_ANON_ID'
        });
      </script>

    商品購入情報

    商品オブジェクト

    購入した商品の詳細について記載するためのオブジェクト。

    フィールド名

    説明

    sku | productId | customerProductId (必須)

    String

    3つの値のうち最低1つが、商品の特定のために必須です。

    purchaseUnitPrice

    Int

    購入価格を設定することができます。
    (未記入の場合はShopliveに登録された商品価格が集計されます。)

    purchaseQuantity

    Int

    商品の購入点数を設定。
    (未記入の場合は1とカウントされます)

    orderId

    String

    注文ID (任意)

    使用例

    <script type="text/javascript" src="https://static.shoplive.cloud/shoplive.js"></script>
    <script>
      cloud.shoplive.init({
        accessKey: 'YOUR_ACCESS_KEY'
      });
    
      // ログインユーザーのユーザー認証
      cloud.shoplive.setUserObject({
        userId: 'USER_ID'
      });
    
      // 製品オブジェクトを持つコンバージョン設定オブジェクト
      var conversionConfig = {
        accessKey: 'YOUR_ACCESS_KEY',
        eventType: 'purchase',
        products: [
          { sku: 'sku_id1', purchaseUnitPrice: 10000, purchaseQuantity: 1 },
          { sku: 'sku_id2', purchaseUnitPrice: 15000, purchaseQuantity: 1 }
        ]
      };
      
      cloud.shoplive.sendConversionEvent(conversionConfig);
    </script>