リクエストパラメーター request-parameters
Analytics データ
analytics.trackingServer
sessionStart
analytics.reportSuite
sessionStart
analytics.enableSSL
sessionStart
analytics.visitorId
sessionStart
visitorId
は Analytics VID.
と同じです。訪問者データ
visitor.marketingCloudOrgId
sessionStart
visitor.marketingCloudUserId
sessionStart
marketingCloudUserId
は、Adobe Analytics の MID
と同じです。技術的には必須ではありませんが、このパラメーターは、Experience Cloud ファミリーのアプリにアクセスするために必要です。visitor.aamLocationHint
sessionStart
appInstallationId
sessionStart
コンテンツデータ
media.id
sessionStart
media.name
sessionStart
media.length
sessionStart
media.contentType
sessionStart
media.playerName
sessionStart
media.channel
sessionStart
media.resume
sessionStart
media.sdkVersion
sessionStart
コンテンツ標準メタデータ
media.streamFormat
sessionStart
media.show
sessionStart
media.season
sessionStart
media.episode
sessionStart
media.assetId
sessionStart
media.genre
sessionStart
media.firstAirDate
sessionStart
media.firstDigitalDate
sessionStart
media.rating
sessionStart
media.originator
sessionStart
media.network
sessionStart
media.showType
sessionStart
コンテンツのタイプ(0 ~ 3 の整数)
- 0 - エピソードそのもの
- 1 - プレビュー
- 2 - クリップ
- 3 - その他
media.adLoad
sessionStart
media.pass.mvpd
sessionStart
media.pass.auth
sessionStart
media.dayPart
sessionStart
media.feed
sessionStart
広告データ
media.ad.podFriendlyName
adBreakStart
media.ad.podIndex
adBreakStart
media.ad.podSecond
adBreakStart
media.ad.podPosition
adStart
media.ad.name
adStart
media.ad.id
adStart
media.ad.length
adStart
media.ad.playerName
adStart
広告標準メタデータ
media.ad.advertiser
adStart
media.ad.campaignId
adStart
media.ad.creativeId
adStart
media.ad.siteId
adStart
media.ad.creativeURL
adStart
media.ad.placementId
adStart
チャプターデータ
media.chapter.index
chapterStart
media.chapter.offset
chapterStart
media.chapter.length
chapterStart
media.chapter.friendlyName
chapterStart
品質データ
media.qoe.bitrate
media.qoe.droppedFrames
media.qoe.framesPerSecond
media.qoe.timeToStart
カリフォルニア州消費者プライバシー法(CCPA)のパラメーター ccpa-params
analytics.optOutServerSideForwarding
sessionStart
analytics.optOutShare
sessionStart
追加の詳細情報 additional-details
visitor.marketingCloudUserId
Experience Cloud ユーザー ID(MID
または MCID
とも呼ばれます)は、visitor.marketingCloudUserId キーを使用して params
マップに含めることで、sessionStart
呼び出しの際に渡します。これは、既に他の Experience Cloud 製品と統合していて、MCID を既に取得している場合に便利な機能です。
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:
このキーの値は、次の形式のオブジェクトである必要があります。
code language-js "<<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 パラメーターを送信できます。