リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
analytics.trackingServer |
はい | string | sessionStart |
Adobe Analytics サーバーの URL |
analytics.reportSuite |
はい | string | sessionStart |
Analytics レポートデータを識別する ID |
analytics.enableSSL |
いいえ | ブール型 | sessionStart |
SSL を有効にするかどうか(true または false) |
analytics.visitorId |
いいえ | string | sessionStart |
Adobe 訪問者 ID は、複数のアドビアプリケーションで使用できるカスタム ID です。ハートビート visitorId は Analytics VID. と同じです。 |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
visitor.marketingCloudOrgId |
はい | string | sessionStart |
Experience Cloud 組織 ID。Adobe Experience Cloud エコシステム内で組織を識別します。 |
visitor.marketingCloudUserId |
いいえ | string | sessionStart |
これは、Experience Cloud ユーザー ID(ECID)です。ほとんどのシナリオで、これがユーザーを識別するために使用する必要がある ID です。ハートビート marketingCloudUserId は、Adobe Analytics の MID と同じです。技術的には必須ではありませんが、このパラメーターは、Experience Cloud ファミリーのアプリにアクセスするために必要です。 |
visitor.aamLocationHint |
いいえ | 整数 | sessionStart |
Adobe Audience Manager Edge データを提供します。値が入力されていない場合、値は null です。 |
appInstallationId |
いいえ | string | sessionStart |
アプリとデバイスを一意に識別する appInstallationId |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.id |
はい | string | sessionStart |
コンテンツの一意の ID |
media.name |
いいえ | string | sessionStart |
人が判読可能なコンテンツの名前 |
media.length |
はい | number | sessionStart |
コンテンツの長さ(秒) |
media.contentType |
はい | string | sessionStart |
ストリームの形式(任意の文字列を指定できます。推奨される値は、「Live」、「VOD」または「Linear」です) |
media.playerName |
はい | string | sessionStart |
コンテンツのレンダリングをおこなうプレーヤーの名前 |
media.channel |
はい | string | sessionStart |
コンテンツの配布チャネル。モバイルアプリケーション名、Web サイト名またはプロパティ名を使用できます。 |
media.resume |
いいえ | ブール型 | sessionStart |
ユーザーが(新しいセッションを開始するに対して)以前のセッションを再開しているかどうかを示します |
media.sdkVersion |
いいえ | string | sessionStart |
プレーヤーで使用される SDK のバージョン |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.streamFormat |
いいえ | string | sessionStart |
ストリーミング形式(例:「HD」) |
media.show |
いいえ | string | sessionStart |
プログラム名またはシリーズ名 |
media.season |
いいえ | string | sessionStart |
番組またはシリーズが属するシーズン番号 |
media.episode |
いいえ | string | sessionStart |
エピソードの番号 |
media.assetId |
いいえ | string | sessionStart |
TV シリーズのエピソードの識別子、ムービーアセットの識別子、ライブイベントの識別子など、ビデオアセットのコンテンツの一意の ID。この ID は通常、EIDR、TMS/Gracenote、Rovi などのメタデータを扱う機関から取得します。その他の独自のシステムや社内システムから取得することもできます。 |
media.genre |
いいえ | string | sessionStart |
コンテンツプロデューサーによって定義されたコンテンツのタイプ |
media.firstAirDate |
いいえ | string | sessionStart |
コンテンツがテレビで最初に放送された日付 |
media.firstDigitalDate |
いいえ | string | sessionStart |
コンテンツが何らかのデジタルプラットフォームで最初に放送された日付 |
media.rating |
いいえ | string | sessionStart |
TV Parental Guidelines で定義されたレーティング |
media.originator |
いいえ | string | sessionStart |
コンテンツの作成者 |
media.network |
いいえ | string | sessionStart |
ネットワーク/チャネル名 |
media.showType |
いいえ | string | sessionStart |
コンテンツのタイプ(0 ~ 3 の整数)
|
media.adLoad |
いいえ | string | sessionStart |
読み込まれた広告のタイプ |
media.pass.mvpd |
いいえ | string | sessionStart |
アドビの認証によって提供される MVPD |
media.pass.auth |
いいえ | string | sessionStart |
ユーザーがアドビの認証によって認証されていることを示します(設定されている場合にのみ true になります)。 |
media.dayPart |
いいえ | string | sessionStart |
コンテンツが放送された時刻 |
media.feed |
いいえ | string | sessionStart |
フィードのタイプ(例:「West-HD」) |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.ad.podFriendlyName |
いいえ | string | adBreakStart |
広告ブレークのわかりやすい名前 |
media.ad.podIndex |
はい | 整数 | adBreakStart |
ビデオ内の広告ポッドのインデックス |
media.ad.podSecond |
はい | number | adBreakStart |
ポッドが開始された時間(秒) |
media.ad.podPosition |
はい | 整数 | adStart |
広告ブレーク内の広告のインデックス(1 から開始) |
media.ad.name |
いいえ | string | adStart |
広告のわかりやすい名前 |
media.ad.id |
はい | string | adStart |
広告の名前 |
media.ad.length |
はい | number | adStart |
ビデオ広告の長さ(秒) |
media.ad.playerName |
はい | string | adStart |
広告のレンダリングをおこなうプレーヤーの名前 |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.ad.advertiser |
いいえ | string | adStart |
広告で取り上げられている製品の会社またはブランド |
media.ad.campaignId |
いいえ | string | adStart |
広告キャンペーンの ID |
media.ad.creativeId |
いいえ | string | adStart |
広告クリエイティブの ID |
media.ad.siteId |
いいえ | string | adStart |
広告サイトの ID |
media.ad.creativeURL |
いいえ | string | adStart |
広告クリエイティブの URL |
media.ad.placementId |
いいえ | string | adStart |
広告のプレースメント ID |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.chapter.index |
はい | 整数 | chapterStart |
コンテンツ内のチャプターの位置を識別します。 |
media.chapter.offset |
はい | number | chapterStart |
再生においてチャプターが始まる時間(秒) |
media.chapter.length |
はい | number | chapterStart |
チャプターの長さ(秒) |
media.chapter.friendlyName |
いいえ | string | chapterStart |
チャプターのわかりやすい名前 |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
media.qoe.bitrate |
いいえ | 整数 | いずれか | 平均ビットレート(bps)。平均ビットレートは、再生セッション中に発生した再生時間に関連するすべてのビットレート値の加重平均として計算されます。 |
media.qoe.droppedFrames |
いいえ | 整数 | いずれか | ストリーム内のドロップフレームの数 |
media.qoe.framesPerSecond |
いいえ | 整数 | いずれか | 1 秒あたりのフレーム数 |
media.qoe.timeToStart |
いいえ | 整数 | いずれか | ユーザーが再生を押してからコンテンツが読み込まれて再生が開始されたときまでの時間(ミリ秒) |
リクエストキー | 必須 | リクエストタイプキー | 設定する場所 | 説明 |
---|---|---|---|---|
analytics.optOutServerSideForwarding |
いいえ | ブール型 | sessionStart |
エンドユーザーが Adobe Analytics およびその他の Experience Cloud ソリューション(例:Audience Manager)間でのデータの共有をオプトアウトした場合、true に設定します。 |
analytics.optOutShare |
いいえ | ブール型 | sessionStart |
エンドユーザーが(例えば、他の Adobe Analytics クライアントに対する)データのフェデレーションをオプトアウトした場合、true に設定します。 |
Experience Cloud ユーザー ID(MID
または MCID
とも呼ばれます)は、visitor.marketingCloudUserId キーを使用して params
マップに含めることで、sessionStart
呼び出しの際に渡します。これは、既に他の Experience Cloud 製品と統合していて、MCID を既に取得している場合に便利な機能です。
Media Analytics(MA)は、Experience Cloud ファミリーのアプリ(Adobe Analytics、Audience Manager、Target など)と統合されています。これらのアプリにアクセスするには、Experience Cloud ID が必要です。ECID は、ほとんどのシナリオでユーザーを識別するために使用する必要があるものです。
appInstallationId
値を渡さない場合 - MA バックエンドは MCID を生成しなくなり、その代わりに Adobe Analytics にその操作を任せます。 MCID を送信する(MCID を取得できる場合)か、(必須の appInstallationId
と共に)marketingCloudOrgId
を送信してメディアコレクション API が MCID を生成してすべての呼び出しで送信できるようにすることをお勧めします。
appInstallationId
値を渡す場合 - appInstallationId
および(必須の) marketingCloudOrgId
パラメーターの値を渡すと、MA バックエンドによって MCID を生成できます。自分で appInstallationId
を渡す場合は、クライアント側でその値を維持する必要があります。この値はデバイス上のアプリに対して一意である必要があり、アプリが再インストールされない限り永続的である必要があります。
appInstallationId
は、アプリとデバイスを一意に識別します。この値は各デバイスのアプリごとに一意である必要があります。つまり、異なるデバイスで同じアプリの同じバージョンを使用する 2 人のユーザーは、それぞれ異なる(一意の)appInstallationId
を送信する必要があります。
このパラメーターは、MCID が指定されていない場合に MCID の生成に必要であるだけでなく、(どの Media Analytics がフェデレーションルールの照合を実行するかに基づいて)Publisher ID の値としても使用されます。
analytics.aid:
このキーの値は、Analytics レガシーユーザー ID を表す文字列である必要があります。
visitor.customerIDs:
このキーの値は、次の形式のオブジェクトである必要があります。
"<<insert your ID name here>>": {
"id": " <<insert your id here>>",
"authState": <<insert one of 0, 1, 2>>
}
visitor.customerIDs
の値には、上記の形式のオブジェクトを任意の数だけ含めることができます。
このパラメーターは、Adobe Analytics が顧客データを Audience Manager に送信したときにどの Adobe Audience Manager(AAM)Edge がヒットするかを示します。値が入力されない場合、値は null になります。 これは、エンドユーザーが地理的に離れた場所(例えば、米国東部、米国西部、ヨーロッパ、アジア)でデバイスを使用する場合に特に重要です。そうでない場合、ユーザーデータは複数の AAM Edge に分散されます。
セッションが閉じられた後で(例えば、ユーザーが一旦ビデオから離れた後で戻ってきた結果)再開され、プレーヤーの再生ヘッドが停止された位置からビデオが再開されたことをアプリが検出した場合、sessionStart
呼び出しの params バケット内でブール型のオプションの media.resume パラメーターを送信できます。