サポートされる製品
サポートされる製品
必須スコープ
必須スコープ
media_bridge.write
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
VIDEO
, AUDIO
, DOCUMENT
, OTHER
, IMAGE
Response
successful operation
メディアを消費した、HubSpotのシステム内のコンタクトのID。これは、HubSpotのユーザートークン(utk)でコンタクトを取得するAPIを使用して取得できます。APIはユーザートークンの提供もサポートしており、コンタクトIDへの自動変換を処理します。
VIDEO
, AUDIO
, DOCUMENT
, OTHER
, IMAGE
イベントが発生した時間のタイムスタンプ(エポックからの経過ミリ秒数)。
HubSpotアカウントのID。
1234567
ユーザーがメディアを消費したパーセンテージ。プロバイダーは、メディアの同じ部分が繰り返し消費された場合をどのように扱うかに応じて、異なる方法でこの値を計算できます。したがって、APIはイベントの注意持続時間の情報に対して、totalPercentWatchedの検証を試みません。このプロパティーがない場合、HubSpotは、注意持続時間マップから(値が1以上のスパンの数)/(スパンの合計数)を計算してこの値を求めます。
メディアのスパンと、ユーザーが各スパンを消費した回数に関する最もきめ細かい情報を提供する未加工データです。例えば、10秒の動画で、各秒がスパンである場合、訪問者が動画の最初の5秒を視聴した後、動画を再生しなおして再び最初の2秒を視聴した場合、結果として生成されるrawDataStringは、"0=2;1=2;2=1;3=1;4=1;5=0;6=0;7=0;8=0;9=0;"になります。
HubSpotでホスティングされている場合のページのID。HubSpotページに必須です。
ページの名前。ページがHubSpotでホスティングされていない場合必須です。
ユーザーがメディアを消費した秒数。メディアブリッジはこれをtotalPercentPlayed
*mediaDuration
として計算します。プロバイダーが別の計算方法を希望する場合は、イベントの作成時に事前計算済みの値を提供できます。
イベントが発生したページのURL。ページがHubSpotでホスティングされていない場合必須です。