オーディオマーカー管理
オーディオマーカーを使用すると、通常の再生ではほとんどのリスナーが気づかない特別なmarkerをメディアに含められます。メディアが認識されると、SORIは通常の音声フィンガープリント結果と一緒にmarkerの追加contextを収集できます。代表的な用途は、activityが発生したmedia、channel、programのバージョンを識別し、レポートをより細かくグループ化することです。
INFO
SDKはデフォルトではオーディオマーカーを検出しません。サービスでオーディオマーカーを使用する場合にのみ、Android、iOS、Flutter統合でオーディオマーカー認識を有効にしてください。
オーディオマーカー一覧
オーディオマーカー一覧には、アカウントで作成されたmarkerが表示されます。各markerには名前、タグ、attributesがあります。名前、タグ、attribute key、attribute valueでmarkerを検索できます。
オーディオマーカーの作成
オーディオマーカーを作成するには、SORI Consoleでオーディオマーカーを開き、Create Audio Markerをクリックします。
以下の情報を入力します。
- Name: markerを識別しやすい名前です。
- Attributes: markerが収集されたときに付与するkey/value propertiesです。
- Tags: markerの検索と整理に使用するタグです。
Attributesはオーディオマーカーで最も重要な情報です。markerが素材と一緒に認識されると、SORIはmarker attributesをactivity propertiesとして保存します。これらのpropertiesはactivity history、webhooks、statistics、reportsで利用できます。
値を標準のstatisticsおよびreport dimensionとして表示したい場合は、次のattribute keyを使用してください。
| Attribute key | Report dimension |
|---|---|
media | Media |
channel | Channel |
program | Program |
その他のattribute keyもactivityに保存されますが、現在のstatisticsおよびreport画面の標準group optionとしては表示されません。
TIP
campaignとオーディオマーカーが同じproperty keyを定義している場合、収集されたactivityではオーディオマーカーの値が使用されます。
オーディオマーカー入りメディアの作成
オーディオマーカー詳細ページのMaterial Converterを使用すると、選択したオーディオマーカーを含むmediaを作成できます。
- オーディオマーカー詳細ページを開きます。
- Material Converterにaudioまたはvideo fileをアップロードします。
- Proceedをクリックします。
- conversion jobが完了するまで待ちます。
- 完了したファイルをダウンロードし、media workflowで使用します。
完了したconversion fileとアップロードしたsource fileは、完了から24時間後に自動的に削除されます。期限切れになる前に変換済みファイルをダウンロードしてください。
認識とレポート
SDK統合でオーディオマーカー認識を有効にすると、通常の素材認識結果と一緒にmarkerが収集されることがあります。SORI Consoleはactivityにmarker nameと設定されたattributesを記録します。
Statisticsとcampaign reportsでは、認識activityをMaterial、Media、Channel、Programでグループ化できます。オーディオマーカーに基づくgroupingを使用するには、marker入りメディアを公開する前にmarker attributesにmedia、channel、program keyを設定してください。
Reportとstatistics exportには選択したgroupingが含まれるため、CSVおよびXLSXダウンロードをdownstream analysisに利用できます。
マーカーの扱い
各オーディオマーカーの割り当てと埋め込み方法はSORI Consoleが管理します。ユーザーはmarker name、tags、attributesを設定し、変換済みメディアを自身のmedia workflowで使用するだけです。