コンバージョン計測

    コンバージョン計測


    記事の要約

    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 (任意)


    使用例

    SKU usage / Login user

    <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>