リクエストパラメーター

Analytics データ

リクエストキー 必須 リクエストタイプキー 設定する場所 説明
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 の整数)
  • 0 - エピソードそのもの
  • 1 - プレビュー
  • 2 - クリップ
  • 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 いいえ 整数 いずれか ユーザーが再生を押してからコンテンツが読み込まれて再生が開始されたときまでの時間(ミリ秒)

カリフォルニア州消費者プライバシー法(CCPA)のパラメーター

リクエストキー 必須 リクエストタイプキー 設定する場所 説明
analytics.optOutServerSideForwarding いいえ ブール型 sessionStart エンドユーザーが Adobe Analytics およびその他の Experience Cloud ソリューション(例:Audience Manager)間でのデータの共有をオプトアウトした場合、true に設定します。
analytics.optOutShare いいえ ブール型 sessionStart エンドユーザーが(例えば、他の Adobe Analytics クライアントに対する)データのフェデレーションをオプトアウトした場合、true に設定します。

追加の詳細情報

visitor.marketingCloudUserId

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

  • appInstallationId 値を渡さない場合 - MA バックエンドは MCID を生成しなくなり、その代わりに Adobe Analytics にその操作を任せます​ MCID を送信する(MCID を取得できる場合)か、(必須の appInstallationId と共に)marketingCloudOrgId を送信してメディアコレクション API が MCID を生成してすべての呼び出しで送信できるようにすることをお勧めします。

  • appInstallationId 値を渡す場合 - appInstallationId および​​必須の​ marketingCloudOrgId パラメーターの値を渡すと、MA バックエンドによって MCID を生成できます。自分で appInstallationId を渡す場合は、クライアント側でその値を維持する必要があります。この値はデバイス上のアプリに対して一意である必要があり、アプリが再インストールされない限り永続的である必要があります。

メモ

appInstallationId は、アプリ​とデバイス​を一意に識別します。この値は各デバイスのアプリごとに一意である必要があります。つまり、異なるデバイスで同じアプリの同じバージョンを使用する 2 人のユーザーは、それぞれ異なる(一意の)appInstallationId を送信する必要があります。

visitor.marketingCloudOrgId

このパラメーターは、MCID が指定されていない場合に MCID の生成に必要であるだけでなく、(どの Media Analytics がフェデレーションルールの照合を実行するかに基づいて)Publisher ID の値としても使用されます。

Analytics レガシーユーザー ID(aid)および宣言済みユーザー ID(customerIDs)

  • 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 の値には、上記の形式のオブジェクトを任意の数だけ含めることができます。

visitor.aamLocationHint

このパラメーターは、Adobe Analytics が顧客データを Audience Manager に送信したときにどの Adobe Audience Manager(AAM)Edge がヒットするかを示します。値が入力されない場合、値は null になります。 これは、エンドユーザーが地理的に離れた場所(例えば、米国東部、米国西部、ヨーロッパ、アジア)でデバイスを使用する場合に特に重要です。そうでない場合、ユーザーデータは複数の AAM Edge に分散されます。

media.resume

セッションが閉じられた後で(例えば、ユーザーが一旦ビデオから離れた後で戻ってきた結果)再開され、プレーヤーの再生ヘッドが停止された位置からビデオが再開されたことをアプリが検出した場合、sessionStart 呼び出しの params バケット内でブール型のオプションの media.resume パラメーターを送信できます。

このページ