視聴アクティビティ

​

送信する内容

​

イベントタイプの詳細

​

送信するタイミング

• 再生状態（開始、停止、一時停止、終了）が変更されたとき。
• 新しい再生位置にシークしたとき。
• 再生状態にかかわらず、プレーヤーの実行中は60秒間に1回。

​

送信方法

// ユーザーがライブコンテンツの視聴を開始したときに生成される再生イベントの例

const playbackEvent: IPlaybackEvent = new PlaybackEventBuilder()
   .playbackPositionMs(0)
   .playbackState(PlaybackState.PLAYING)
   .durationMs(2000)
   .eventTimestamp(new Date())
   .contentId(
   new ContentIdBuilder()
      .id('content_CDF_ID')
      .idNamespace(ContentIdNamespaces.NAMESPACE_CDF_ID)
      .build(),
   )
   .channelDescriptor(new ChannelDescriptorBuilder()
      .majorNumber(0)
      .minorNumber(1)
      .identifier('channelID')
      .build(),
   )
   .profileId(
   new ProfileIdBuilder()
      .id('myProfileId')
      .idNamespace(ProfileIdNamespaces.NAMESPACE_APP_INTERNAL)
      .build(),
   )
   .buildActiveEvent();

// イベントを送信します
ContentPersonalizationServer.reportNewPlaybackEvent(playbackEvent);

// Example content interaction event

auto contentInteractionBuilder = serverComponent->makeContentInteractionBuilder()
    ->interactionTimestamp(Utils::getRealTimeInstant("2023-12-16T12:00:00Z"))
    ->contentInteractionType(IContentInteractionTypeEnum::INGRESS);

// Add sample content identifier
auto contentId = serverComponent->makeContentIdBuilder()
    ->id("content_CDF_ID")
    ->idNamespace(IContentIdBuilder::NAMESPACE_CDF_ID)
    ->build();
contentInteractionBuilder->contentId(contentId);

// Add sample profile identifier
auto profileId = serverComponent->makeProfileIdBuilder()
    ->id("myProfileId")
    ->idNamespace(IProfileIdBuilder::NAMESPACE_APP_INTERNAL)
    ->build();
contentInteractionBuilder->profileId(profileId);

auto contentInteraction = contentInteractionBuilder->build();

// Report new content interaction
contentPersonalizationServer->reportNewContentInteraction(contentInteraction);

​

ユーザーエクスペリエンスの検証

​

デバイスのセットアップ

1. Fire TVデバイスをセットアップして登録します。
2. アプリのコンテンツは、Fire TVと統合されているカタログである必要があります。
3. Vegaコンテンツパーソナライゼーション対応アプリをデバイスにインストールし、アプリを起動します。
4. このアカウントで、続きを観る機能に同意する必要があります。これを行うには、次の手順に従ってください。
   1. [設定] > [環境設定] > [プライバシー設定] > [アプリからの共有を管理] に移動して [アプリの視聴状況とコンテンツ情報の共有] を [オン] にします
   2. [設定] > [環境設定] > [プライバシー設定] > [アプリからの共有を管理] に移動して [デバイス間での同期] を [オン] にします

​

[続きを観る] 行でのコンテンツ更新の確認

1. アプリで、ビデオを開いて再生します。動画の2%以上を視聴またはスクロールします。
2. 停止または戻るボタンをクリックして、ビデオの再生を停止します。
3. ログをチェックして、再生イベントが正常に報告されたことを確認します。正常に報告されると、次のログ行が表示されます。
   INFO com.amazon.com_amazon_tv_developer_dataservice.vega.vega_alberto_service:VegaAlbertoBinderService PlaybackEventsVegaMessage → message.sent_timestamp: <your_time_stamp>, page_index : 0, total_page_count: 1, content_id id : <your_content_id>, content_id namespace : cdf_id, event_timestamp_ms: <your_time_stamp>, playback_state :0, duration_ms : <your_content_duration>, credits_position_ms :<your_content_credit_position>
   
4. リモコンを使用して、アプリを終了するかまたはホームボタンをクリックして、ホーム画面に戻ります。
5. 更新された [続きを観る] 行が表示されます。視聴していたビデオが表示されるはずです。表示されれば、正しく動作しています。
6. [続きを観る] 行が更新されない場合は、[ホーム] タブから別の任意のタブに移動し、[ホーム] タブに戻ります。
7. 次の操作により、[続きを観る] 行からタイルを削除することもできます。
   1. タイルにカーソルを合わせ、リモコンのメニューボタンをクリックし、[「続きを観る」から削除] を選択します。この方法によって、同じコンテンツでテストできます。

​

[続きを観る] 行からのコンテンツ削除の確認

1. アプリを開いて、[視聴を続ける] 行に既にコンテンツが表示されているビデオの視聴を開始します。
2. ビデオの最後までシークするか、リモコンの進む（»）スクロールボタンを繰り返しクリックして、ビデオの最後まで移動します。
3. ログをチェックして、再生停止イベントが正常に報告されたことを確認します。正常に報告された場合、ログは次のようになります。
   INFO com.amazon.com_amazon_tv_developer_dataservice.vega.vega_alberto_service:VegaAlbertoBinderService PlaybackEventsVegaMessage → message.sent_timestamp:  <your_time_stamp> , page_index : 0, total_page_count: 1, content_id id : <your_content_id>, content_id namespace : cdf_id, event_timestamp_ms: <your_time_stamp>, playback_state :2, duration_ms : <your_content_duration>, credits_position_ms : <your_content_credit_position>
   
4. [ホーム] タブに戻ります。
5. [続きを観る] 行にコンテンツが表示されなくなるはずです。
6. [続きを観る] 行が更新されない場合は、[ホーム] タブから別の任意のタブに移動し、[ホーム] タブに戻ってUIを更新します。

​

検証シナリオ

​

トラブルシューティング

​

AmazonコンテンツIDが正しくない

​

再生イベントの報告が正しくない

​

複数のアプリ内プロフィールのコンテンツが [続きを観る] 行に表示されている