iOS用のNPAWによるQoSソリューションを使用する

NICE PEOPLE AT WORK (NPAW) YOUBORAプラットフォームによるOoyala QoSソリューションをモバイルで実装することで、Ooyala's iOSプレイヤーでプレイヤーイベントのアナリティクスを提供します。

OoyalaによるYOUBORA QoSソリューションを有効化する前に、以下を持っている必要があります:
  • NPAWとの顧客関係とYOUBORAのアカウント。Ooyalaの連絡先までご連絡いただき、NPAWアカウントID(NPAWアカウントの識別子)とユーザーID(デバイスのユーザーの識別子)を設定してください。
  • Ooyala Backlotアカウント。
  • iOS開発の経験。
注: VoDがiOSにネイティブで対応するようになりました。
少数のコードスニペットを追加してNPAW's YOUBORAを既存のOoyalaPlayerアプリケーションに統合する必要があります。
  1. Ooyala Core SDKOoyala-NPAW Integrationをダウンロードしてください。
  2. NPAW YOUBORAクラスを初期化します。Ooyalaプレイヤーを作成した後、しかしsetEmbedCodeの前に、次を呼び出します:
    //Where self.npawSystemIdはアカウントIDで、self.npawUserIdはユーザー、そして"player"は例示したOOOoyalaPlayerです self.youbora = [[Youbora alloc] initWithSystemId:self.npawSystemId userID:self.npawUserId playerInstance:player options:nil];

    NPAWアカウントIDとNPAWユーザーIDを引き出す必要がある場合は、Ooyalaの連絡先までご連絡ください。NPAWユーザーIDはユーザーアカウント(システムレベルアカウント内)の参考資料です。これにより、Ooyalaはどの明示的なNPAWユーザーアカウントを使用するかわかります。ユーザーIDはYOUBORAダッシュボードの設定 > ユーザータブ内で利用できます。

  3. onStop およびonRestartYOUBORAを停止して再起動します。適切なアナリティクスを維持するには、YOUBORAはアクティビティのStopおよびRestartで明示的な呼び出しをする必要があります。
  4. (任意)アプリケーションに設定され、NPAWによって取り込まれるように大量のカスタムメタデータを提供することができます。これらすべての情報は、デフォルトで設定された情報を補足またはオーバーライドします。
    - (NSDictionary*)generateNpawCustomMetadata { NSDictionary *optionsCustomData = @{ @"customData": @{@"filename": @"Example Custom File Name", @"content_metadata": @{@"title": @"Custom Overridden Title", @"genre": @"Custom Genre"}, @"device": @{@"manufacturer": @"Custom Device Manufacturer"}} }; return optionsCustomData; } ... // Get the custom metadata NSDictionary *customMetadata = [self generateNpawCustomMetadata]; // initialize youbora plugin with custom metadata self.youbora = [[Youbora alloc] initWithSystemId:self.npawSystemId userID:self.npawUserId playerInstance:player options:customMetadata];
                     

    YouboraMetadata

    環境に関するメタデータを受け付けるクラス。これはYoubora.updateYouboraMetadata(metadata);を使用してYOUBORAに追加されます。

    このクラスは以下の方法(これらに限定されません)を持っています。詳しい説明および例を含めた、使用可能なキーの全リストについては、https://youbora.zendesk.com/hc/en-usYOUBORA文書をご覧ください。

    方法 オールフィル 説明
    YouboraMetadata.setParam1 いいえ  
    YouboraMetadata.setParam2 いいえ  
    YouboraMetadata.setCdn いいえ

    YOUBORAアナリティクスが行うCDN自動探知をオーバーライドできます。これはオプションの方法です。

    CDN探知は、YOUBORAがプレイヤーから受信するリソース/ビデオURLに基づいて行われます。しかし、YOUBORA自動システムが間違った(または不明な)CDNを返す可能性があるAPI URLを埋め込むこともできます。YOUBORA Smartswitchを使う場合、またはどのCDNがコンテンツを送信しているか分かっている場合、自動の値をオーバーライドすることができます。

    YouboraMetadata.setIp いいえ

    アナリティクスが行うIP自動探知をオーバーライドできます。これはオプションの方法です。

    IPはエンドユーザーからのリクエストIPから届いています。プラグインとスマートスイッチ機能用のアナリティクスサーバーとの間にミドルウェアを使用している場合、YOUBORAはユーザーのIPではなくミドルウェアIPを取得します。

    YouboraMetadata.setIsp いいえ

    アナリティクスが行うISP自動探知をオーバーライドできます。これはオプションの方法です。

    YouboraMetadata.setTransaction いいえ YOUBORAアナリティクス内にあるトランザクションコード値を設定します。トランザクションコードは、アナリティクスツール内のビューを特定し、検索を行うために使用できる特定コードです。このコードで任意の値を設定できます(purchaseCode, sessionCode,など)。
    YouboraMetadata.setResource いいえ YOUBORAシステムに送信されたビデオURLメタデータをオーバーライドします。これは、たとえプレイヤーが別のURLを再生しても、(再生されるビデオとしてではなく)CDN探知のメタデータとして新しいものを設定できます。

    プロパティーマップ

    現在の再生に関する情報を含むプロパティのHashMap。メタデータがYouboraMetadataオブジェクトであるmetadata.setProperties()を使用してYOUBORAに追加されました。HashMapは次のキー(これらに限定されません)を受け付けます。詳しい説明および例を含めた、使用可能なキーの全リストについては、YOUBORA文書(https://youbora.zendesk.com/hc/en-us/articles/200380711-HTML5-Video-Player)の11ページをご覧ください。
    キー オールフィル 説明
    filename いいえ 現在のメディアコンテンツのファイル名
    content_id いいえ デフォルトのOoyala Embed Code/Content IDになります。
    transaction_type いいえ Rent:レンタル用メディア。

    Subscription:購読の一部として取得されたメディア。

    EST (Electronic Sell Through):購入されたメディア。

    Free:金銭的取引がないメディア。

    quality いいえ HDまたはSD。
    content_type いいえ トレイラー、エピソード、映画
    content_metadata はい コンテンツに関連する他の多くのメタデータエントリーのHashMap
    device はい コンテンツに関連する他の多くのメタデータエントリーのHashMap
    <任意の文字> いいえ 任意の文字列。NPAWへ送信される。

    MetadataMap

    コンテンツに関する情報のHashMapproperties.put("content_metadata", metadataMap);を使用してプロパティHashMapに追加されました。HashMapは次のキー(これらに限定されません)を受け付けます。詳しい説明および例を含めた、使用可能なキーの全リストについては、YOUBORA文書(https://youbora.zendesk.com/hc/en-us/articles/200380711-HTML5-Video-Player)の11ページをご覧ください。
    キー オールフィル
    title はい
    genre いいえ
    language いいえ
    year いいえ
    cast いいえ
    director いいえ
    owner いいえ
    duration はい
    parental いいえ
    price いいえ
    rating いいえ
    audioType いいえ
    audioChannels いいえ

    デバイスメタデータマップ

    デバイスに関する情報のHashMapHashMapは次のキー(これらに限定されません)を受け付けます。詳しい説明および例を含めた、使用可能なキーの全リストについては、YOUBORA文書(https://youbora.zendesk.com/hc/en-us/articles/200380711-HTML5-Video-Player)の11ページをご覧ください。

    キー オールフィル
    manufacturer いいえ
    type いいえ
    year いいえ
    firmware いいえ
正しくOoyalaYouboraを設定すると、ネットワークトレースでhttp://test-nqs.nice264.comに送信されているNPAWリクエストを表示できるようになります。またNICE_PEOPLE_OOYALA and NICE_PEOPLE_BASEでタグ付けされたLogcatでログを表示できます。

この記事はお役にたちましたか?