Kollusサービスで提供しているCallbackは、Platform CallbackとPlayer Callbackで分けていおり、ユーザーのコンテンツ利用情報を確認したい際にはPlayer Callbackが必要です。
Playerから取得された内容を指定したURLに転送する機能をLMS Callbackといいます。Playerは情報を一方転送するだけでレスポンスの受け取ることは出来ません。
この機能を使用する場合にはKollus Live管理画面から関連情報を設定する必要があります。LMS Callback URLの設定が終わりましたらVideo gatewayから再生関連情報が指定したURLに自動で転送されます。
再生情報を受け取る流れを説明します。
Kollusから転送する再生関連情報は顧客の意見を反映して提供項目を決めています。
● 視聴開始時間
● 視聴時間 (累計)
● 実際視聴時間
● ユーザー情報
● コンテンツ情報
● デバイス情報
● 転送周期
user_info
content_info
uservalues : ユーザー定義の追加条件、全ての条件の合計用量を1KB未満にしてください。
Player別の対応オプションを確認してください。{MAC}, {IP}は個人情報になるため必要な場合別途ご相談ください。
Option | FlashPlayer | KollusPlayer(PC) | KollusPlayer(Moblie) |
---|---|---|---|
{CLIENT_USER_ID} | O | O | O |
{START_AT} | O | O | O |
{RUN_TIME} | O | O | O |
{MEDIA_CONTENT_KEY} | O | O | O |
{HOST_NAME} | O | O | O |
{PLAYER_ID} | X | O | O |
{PLAY_STATUS} | X | O | O |
{DEVICE} | X | O | O |
{SHOW_TIME} | X | O | O |
{JSON_DATA} | O | O | O |
Callback設定はチャンネル編集ページから行えます。Callbackが必要なチャンネル別に全て設定してください。
30:http://domain.com/check.asp?id={CLIENT_USER_ID}&start={START_AT}&lms={JSON_DATA} &uservalue0={USERVALUE0} |
● URL: http://lms.servicedomain.com/lms/register ● Method: POST ● Params: ● ID={CLIENT_USER_ID} ● LRN={USERVALUE0} ● LHF={USERVALUE1} ● LCD={USERVALUE2} ● TM={START_AT} ● RT={RUN_TIME} ● http://lms.servicedomain.com/lms/register?ID=pobi&LRN=123456789ABCDEF&LHF=1&LCD=L123&UCD=U123&TM=123456789&RT=123456789 |
LMS callbackデータの変更・偽造防止のためPOSTで転送される全ての情報に対してHashを生成し、転送されたHash値と一致することを確認してください。
※ Hash 生成方式に漏洩の可能性があるFlash Player, HTML5 Playerは対象外
Hash生成規則は以下の通りになります。
hash_1 = md5 ( post-data ) hash_2 = md5 ( hash_1 + service_account ) ← + 文字含む hash_2値をpost dataのhashパラメータ値で転送します。 |
転送されるPostデータのサンプル
ID=pobi&MAC=123456789ABCDEF&LRN=123456789ABCDEF&LHF=1&IP=192.16 8.0.118&LCD=L123&UCD=U123&TM=123456789&PT=123456789&ET=123456789 &SKIP=0&B1=1&B2=1&B3=1&B4=1&B5=1&B6=1&B7=1&B8=1&B9=1&B10=1&T1= 123456789&T2=123456789&T3=123456789&T4=123456789&T5=123456789&T6=1 23456789&T7=123456789&T8=123456789&T9=123456789&T10=123456789&hash =7dec341ff384574f24c6c441b46bc9b1 |