TVOD 売上データセットは、プライム・ビデオのトランザクション・Video・オン・デマンド（TVOD）ビジネスのトランザクションレベルの売上データを提供します。 各レコードは、完了した取引 (購入またはレンタル) を表します。 データは Slate Datasets API を介して追加専用の変更履歴として配信されるため、ビジネスニーズに合わせたカスタム分析や指標の計算を非常に柔軟に行うことができます。
主なメリット
- より迅速な洞察 — 売上データは1日に複数回バッチ処理され、ほとんどの取引は完了後9時間以内に配信されます。
- コストと売上の分離 — セールスシグナルは 4 時間ごとに届きます。コスト情報 (net_cogs) は毎日更新されるため、収益シグナルをできるだけ早く得ることができます。
- 一貫性 — すべての地域で標準化されたフォーマットを 1 つのソースにまとめます。
- 取り込みの簡略化 — 簡単なアップサートパターンによる追加のみの変更ログモデルにより、手間をかけずに自動的に取り込むことができます。
- トランザクションレベルの細分性 — 個々の注文レベルのデータにアクセスして、カスタム分析、タイトルレベルのパフォーマンストラッキング、内部システム統合を強化します。
- 柔軟な統合 — TVOD の売上データを社内システム、データウェアハウス、BI ツールと統合します。
機能: |
スレートデータセット API |
アクセType |
プログラマティック (REST API) |
最適な用途 |
自動パイプライン、エンタープライズレポート、カスタム分析 |
認証 |
Amazon (LWA) セキュリティProfile でログイン |
データフォーマット |
CSV ファイル (gzip で圧縮) |
はじめに
前提条件
- アクティブ・プライム・Video TVOD パートナーシップ
- Amazon (LWA) セキュリティProfile によるログイン
- コンテンツアカウントマネージャ (CAM) に登録されているクライアント ID
- トークンをリクエストするための認証コード。
- すべての API リクエストに対応する有効な LWA 認証トークン。
認証設定データセットを取得するには、まず Datasets API スイートにオンボーディングする必要があります。 詳細については、こちらをご覧ください。
API エンドポイント
Discovery Endpoints
これらのエンドポイントを使用して、アカウント ID と契約 ID をプログラムで検索します。
エンドポイント |
返品 |
|---|---|
/v2/アカウントを取得 |
アクセスできるスレートアカウントのリスト |
/v2/アカウント/ {ACADIA_ID} を取得 |
利用可能なビジネスライン (チャネル、トランザクションなど) |
GET /v2/アカウント/ {ACADIA_ID} /トランザクション |
アカウントの TVOD 契約 ID のリスト |
/v2/accounts/ {ACADIA_ID} /transactions/ {CONTRACT_ID} /データセットを取得 |
契約で利用できるデータセット |
データセットファイルの取得このエンドポイントを使用して、コントラクトのトランザクションデータセットファイルへのリンクを取得します。curl -X GET \
-H "Authorization: Bearer Atza|auth_token" \
https://videocentral.amazon.com/api/v2/accounts/{ACADIA_ID}/transactions/{CONTRACT_ID}/\
datasets/transactions_event_log\
?startDateTime=YYYY-MM-DDThh:mm:ssZ\
&endDateTime=YYYY-MM-DDThh:mm:ssZ\
&offset=0&limit=1000
リクエストパラメーター
パラメーター |
Description |
|---|---|
ACADIA_ID |
あなたのスレートアカウント ID。 GET /v2/アカウントを使用して検索してください。 |
コントラクト ID |
あなたの TVOD コントラクト ID。 |
開始日/時刻 |
前回プルした時刻に設定します。 フォーマット:yyyy-mm-ddthh: MM: SSZ (UTC)。 |
終了日時 |
現在の時刻に設定します。 フォーマット:yyyy-mm-ddthh: MM: SSZ (UTC)。 |
限定 |
1 ページあたりのリンク数は最大 1000 です。 |
このエンドポイントは、トランザクションを直接返すのではなく、トランザクションログを含むダウンロード可能な CSV ファイル (gzip 圧縮) へのリンクを返します。
ページ分割すべて回答がページ分割されます。 次のクエリパラメータを使用して結果をナビゲートします。
パラメーター |
デフォルト |
Description |
|---|---|---|
限定 |
10 |
1 ページあたりに返されるドキュメントのNumber。 最大数は 1000 です。 |
オフセット |
0 |
スキップするページNumber。 |
ページ分割すべて回答には、以下のフィールドが含まれます。
フィールド |
Description |
|---|---|
合計 |
全ページのドキュメント総数。 |
次へ進みます |
次のページへの URL。 最後のページにある場合は NULL。 |
データモデル
キーコンセプト
コンセプト |
Description |
トランザクション |
完了した注文イベント (購入またはレンタル)。 各トランザクションは固有の order_item_id によって識別されます。 |
変更ログモデル |
データは追加専用です。 レコードの属性が変更された場合 (たとえば、コストの到着など)、order_item_id は同じ、last_update_time_utc は新しい last_update_time_utc で新しいレコードが公開されます。 |
主キー |
order_item_id は各トランザクションに固有の識別子です。 このフィールドは常に重複排除してください。 |
コストと売上 |
売上データは 4 時間ごとに届きます。 Costing (net_cogs) は毎日更新されるため、レコードは利用可能な場合はコストとともに更新されます。 |
データ鮮度
属性 |
ターゲット |
売上データ配信 |
4 時間ごと (一括処理) |
コスト計算 (net_cogs) 更新 |
24 時間ごと |
End ツーエンドのレイテンシー |
トランザクションからデータが使用可能になるまでに最大 9 時間 |
データ保持 |
最大 2 年間 |
データ精度
属性 |
詳細 |
真実の情報源 |
支払いと原価計算の最終的な情報源は、依然として収益と財務諸表です。 |
予想される差異 |
日時の微妙な違いや、財務/ロイヤリティレポートとの集計の違いにより、若干の差異が生じる場合があります。 |
適用範囲 |
トランザクショングレインで完了した注文をパフォーマンストラッキングします。 財務レポートやロイヤリティレポートに代わるものではありません。 |
このデータセットは、より迅速で継続的な業績追跡を目的として設計されています。 日時の微妙な違いや集計の違いにより、財務報告書 (例:Video ASIN 日次レベルの概要) と比べると若干の差異が予想されます。 これは予想される動作であり、データ品質の問題ではありません。
データ定義
コアフィールド次の表では
、transactions_event_log データセットで使用可能なすべてのフィールドについて説明しています。
[フィールドName] |
Type |
NULL 設定可能 |
Description |
例: |
|---|---|---|---|---|
オーダー_アイテム_ID |
ひも |
いいえ |
各トランザクションに固有の識別子。 重複排除用のプライマリキー。 |
ABC123XYZ |
トランザクション_日時_UTC |
タイムスタンプ |
いいえ |
UTC 単位のトランザクション時間。 |
2026-01-14T 00:04:41.575 |
トランザクション_日付_タイム_ローカル |
タイムスタンプ |
いいえ |
ローカルタイムゾーンのトランザクション時間。 |
2026-01-14T 01:04:41.575 |
pv_title_id |
ひも |
いいえ |
一意のタイトル識別子。 |
1234567 |
コンテンツタイプ |
ひも |
いいえ |
購入したコンテンツのType。 |
映画、TVエピソード、TVシーズン |
購入タイプ |
ひも |
いいえ |
購入またはレンタルの指標。 |
EST (購入)、VOD (レンタル) |
コンテンツ品質 |
ひも |
いいえ |
Video 品質レベル。 |
SD、高解像度、高解像度 |
地域 |
ひも |
いいえ |
地域コード。 |
US、GB、ドイツ、JP、AU |
デバイスクラス |
ひも |
はい |
デバイスカテゴリ。 |
Fire TV、モバイル、ウェブ |
タイトル名 |
ひも |
いいえ |
タイトル名。 |
ザ・グレート・アドベンチャー |
通貨 |
ひも |
いいえ |
ISO 4217 通貨コード。 |
USD、EUR、JPY |
ベンダー_SKU |
ひも |
はい |
パートナーが提供する SKU。 |
WB-MOV-001 |
net_cogs |
小数 |
はい |
商品の正味売上原価、税抜き。 毎日更新されます。 最初は NULL でもかまいません。 |
4.99 |
純収益 |
小数 |
いいえ |
純収益、税抜き。 |
14.99 |
create_time_utc |
タイムスタンプ |
いいえ |
作成時間を UTC で記録します。 |
2026-01-14T 01:39:06.619 |
最終更新時刻:UTC |
タイムスタンプ |
いいえ |
最終更新時刻を記録します。 重複排除ロジックに使用されます。 |
2026-01-14T 01:39:06.619 |
フィールドノート以下のフィールドには、パートナーが知っておくべき重要な行動特性があります。
フィールド: |
計算/論理 |
注記 |
|---|---|---|
net_cogs |
毎日リフレッシュ |
最初は NULL または 0 と表示される場合があり、コスト計算が行われると 24 時間以内に更新されます。 |
last_update_time_UTC |
最新のタイムスタンプが優先されます |
同じ order_item_id に複数のレコードが存在する場合は、last_update_time_utc が最新のレコードのみを保持してください。 |
地域 |
1 つのデータセット (すべてのテリトリー用) |
テリトリーごとのファイルはありません。必要に応じてテリトリーコードでフィルタリングできます。 |
購入タイプ |
列挙値が修正されました。 |
EST = 電子セルスルー (永久購入)。 VOD = 期間限定レンタル。 |
重複排除
概要このデータセットは changelog モデルを使用しています。 レコードが更新されると (たとえば、原価計算が到着すると)、同じ order_item_id と新しい last_update_time_utc を使用して新しいバージョンが公開されます。 正確なデータを維持するために、レコードを宛先に書き込む前に必ず重複排除ロジックを適用してください。
重複排除クエリ次の SQL
パターンを使用して、各トランザクションの最新バージョンのみを重複排除して保持します。-- Deduplicate to latest version of each transaction
SELECT *
FROM (
SELECT *,
ROW_NUMBER() OVER (
PARTITION BY order_item_id
ORDER BY last_update_time_utc DESC
) AS rn
FROM your_transactions_table
) t
WHERE rn = 1;
Upsert Pattern
このパターンを使用して、すべてのトランザクションの最新の状態をローカルテーブルに保持します。MERGE INTO your_table AS target
USING s3_staging_table AS source
ON target.order_item_id = source.order_item_id
WHEN MATCHED AND source.last_update_time_utc > target.last_update_time_utc THEN
UPDATE SET
transaction_datetime_utc = source.transaction_datetime_utc,
net_cogs = source.net_cogs,
net_revenue = source.net_revenue,
last_update_time_utc = source.last_update_time_utc
-- ... all other columns
WHEN NOT MATCHED THEN
INSERT (order_item_id, transaction_datetime_utc, ..., last_update_time_utc)
VALUES (source.order_item_id, source.transaction_datetime_utc, ..., source.last_update_time_utc);
ETL パイプライン
概要この 4
つのステップに従って、TVOD 売上データ用の信頼性の高い自動取り込みパイプラインを構築してください。
パイプラインステップ
- 初期データプル — API エンドポイントを使用して、希望の時間範囲内に契約のすべてのファイルをプルします。 返されたファイルをすべてDownload します。 各ファイルには CSV 形式 (gzip 圧縮) のトランザクションレコードが含まれています。
- 重複排除 — 複数日のデータを処理しているときに、同じ order_item_id に複数のレコードが存在する場合、セクション 6.2 の重複排除クエリを使用して最新の last_update_time_utc レコードのみを保持します。
- ターゲットにアップサート — order_item_id をキーとして使用して、重複排除されたレコードをデスティネーションテーブルにマージします。 セクション 6.3 のアップサートパターンを参照してください。
- インクリメンタル処理 — 継続的なデータロードでは、StartDateTime を前回プルした時刻に、EndDateTime を現在の時刻に設定します。 返されたすべてのファイルを処理し、宛先にアップサートします。
インクリメンタル実行には以下のパラメーターを設定します。startDateTime = {last_successful_pull_timestamp}
endDateTime = {current_utc_timestamp}
推奨摂取間隔
推奨事項 |
詳細 |
推奨ケイデンス |
4 ～ 6 時間おきに、できるだけ最新の情報を入手してください。 |
インクリメンタル処理戦略 |
StartDateTime には最後に取得したタイムスタンプを設定し、EndDateTime には現在の時刻を設定します。 返されたすべてのファイルを処理します。 |
日次/週次消費者 |
日次または週次で取得する場合は、レコードの欠落を防ぐため、全期間にわたってすべてのファイルを処理するようにしてください。 |
推奨開始時間 |
日常業務の場合は、UTC のAM 1 時に開始して、前日の完了を記録します。 |
サンプルクエリ
これらの SQL パターンを使用して、一般的な分析ユースケースに取り掛かってください。 [開始日]、[終了日]、[X] を希望の値に置き換えてください。
一定期間の収益別上位 X タイトル SELECT
title_name,
COUNT(DISTINCT order_item_id) AS total_orders,
SUM(net_revenue) AS total_revenue
FROM your_table
WHERE transaction_datetime_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY title_name
ORDER BY total_revenue DESC
LIMIT [X];
購入Type 別の総収入 SELECT
purchase_type,
SUM(net_revenue) AS total_revenue
FROM your_table
WHERE transaction_datetime_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY purchase_type
ORDER BY purchase_type;
日次売上概要 SELECT
DATE(transaction_datetime_utc) AS transaction_date,
COUNT(DISTINCT order_item_id) AS total_orders,
SUM(net_revenue) AS total_revenue,
SUM(net_cogs) AS total_cogs
FROM your_table
WHERE transaction_datetime_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY DATE(transaction_datetime_utc)
ORDER BY transaction_date DESC;
地域別の収益 SELECT
territory,
COUNT(DISTINCT order_item_id) AS total_orders,
SUM(net_revenue) AS total_revenue
FROM your_table
WHERE transaction_datetime_utc BETWEEN '[START_DATE]' AND '[END_DATE]'
GROUP BY territory
ORDER BY total_revenue DESC;
品質基準
データ品質目標
品質ディメンション |
ターゲット |
測定 |
完全性 |
トランザクションの 99% 以上をキャプチャ |
財務報告との比較 |
適時性 |
エンドツーエンドのレイテンシは最大 9 時間 |
トランザクションからデータが利用可能になるまでの時間 |
一貫性 |
単一標準フォーマット |
1 つのデータセットすべてテリトリー |
既知の制限事項
制限事項 |
Description |
インパクト |
原価計算の遅延 |
net_cogs はリアルタイムではなく毎日更新されます。 |
レコードは最初は NULL または 0 コストと表示されることがあり、24 時間以内に更新されます。 |
データ保持 |
最大 2 年間の履歴データ。 |
タイムスタンプが 2 年以上前のリクエストは結果を返しません。 |
トークンの有効期限 |
LWA アクセストークンは 1 時間後に期限切れになります。 |
アクセスが中断されないようにするには、更新トークンのロジックを実装する必要があります。 |
ファイルベースの配信 |
API は直接データ行ではなく、ファイルへのリンクを返します。 |
処理前にパイプラインにダウンロードステップが必要です。 |
財務差異 |
財務/ロイヤリティレポートと若干の差異。 |
予想される動作は日付と時刻の微妙な違いによるもので、データ品質の問題ではない。 |
