広告 CLI コマンド

購入者：このプロジェクトが招待されたネットワークを一覧表示し、1つのネットワークの許可された在庫とスロットを検査。

ads networks list
ads networks show <seller-project-id>

screenrig ads networks list

販売者：このプロジェクトの独自ネットワークを検査または作成し、デフォルト料金を設定します。

ads network show
ads network create --name NAME
ads network rate --rate-mcr-per-15s MCR --expect-rev REVISION

screenrig ads network rate --rate-mcr-per-15s 1000 --expect-rev 3

--name は 120 文字以内です。--rate-mcr-per-15s は、再生が完了した 15 秒あたりの mcr を表す正の整数で、--expect-rev は ads network show で確認できるネットワークの revision です。実効レートが変わると、影響を受けるキャンペーンは、各購入者が新しい見積もりを承諾するまで一時停止されます。

販売者：所有するスクリーンを広告のオンまたはオフにし、招待された購入者に説明します。

ads inventory list
ads inventory update <screen-id> [--enabled | --disabled] [--site-name NAME]
    [--city CITY] [--region REGION] [--venue-type TYPE] [--audience-tags TOKENS]
    [--placement TEXT] [--public-description TEXT]
    [--rate-mcr-per-15s MCR | --clear-rate]
    [--impressions-per-hour N | --clear-impressions-per-hour] [--expect-rev REVISION]

screenrig ads inventory update scr_LOBBY --enabled --venue-type cafe

省略されたフラグは現在の値を保持します。新しい在庫行には--enabledまたは--disabledが必要です。--impressions-per-hourは、画面が 1 時間に届けるインプレッション数の推定値を記録します。再生が完了するたびに、この推定値に再生秒数を掛けて 3600 で割った値が、ads reports spend、ads reports delivery、ads direct reportのestimated_impressionsとして加算されます。

update には少なくとも 1 つのフラグが必要です。--audience-tags には、カンマ区切りで最大 20 個のタグを指定でき、各タグは英数字またはアンダースコアで 32 文字以内です。--clear-rate は画面をプロジェクトの既定レートに戻し、--clear-impressions-per-hour は推定値を削除します。--expect-rev は保存済み行のリビジョンを事前条件として置き換えます。まだ行がない画面では拒否されます。

販売者：再利用可能な広告スロットを定義します。スロットは、その広告スロットページがプレイリストに配置されるまで、画面上の何も変更しません。

ads slots list
ads slots create --name NAME --accepted-media image,video
    [--max-image-duration-ms MS] [--max-video-duration-ms MS]
    [--rate-mcr-per-15s MCR | --clear-rate] [--enabled | --disabled] [--vast-tag-url URL]
ads slots update <slot-id> --expect-rev REVISION [--name NAME]
    [--accepted-media image,video] [--max-image-duration-ms MS] [--max-video-duration-ms MS]
    [--rate-mcr-per-15s MCR | --clear-rate] [--enabled | --disabled]
    [--vast-tag-url URL | --clear-vast-tag-url]

screenrig ads slots create --name "Lobby break" --accepted-media image,video
screenrig ads slots create --name "Lobby video" --accepted-media video --vast-tag-url https://ads.example.com/vast.xml
screenrig ads slots update ads_LOBBY --clear-vast-tag-url --expect-rev 2

--disabled を指定しない限り、新しいスロットは有効になります。--accepted-media は image、video、またはその両方で、カンマ区切りです。省略した長さの上限は 30000 ms で、画像の上限は 5000〜30000 ms、動画の上限は 5000〜120000 ms です。--rate-mcr-per-15s は、このスロットに対して画面またはプロジェクトのレートを上書きする正の整数で、--clear-rate は上書きを削除します。update は省略したフィールドをすべて維持します。実効レートが変わると、影響を受けるキャンペーンは、各購入者が新しい見積もりを承諾するまで一時停止されます。--vast-tag-url は 2048 文字以内の HTTPS URL です。

--vast-tag-url は販売者自身の VAST 2〜4 広告タグを設定します。招待されたキャンペーンが自身のスクリーンの枠を埋めない場合に試行されます。この枠は動画を受け入れる必要があります。URL はポート 443 または 8443 の HTTPS で公開ホストに接続します。バックエンドが取得し、最大 5 件の Wrapper をたどり、選択されたプログレッシブ MP4 または WebM をプロジェクトのメディアに取り込みます。Impression、creativeView、start は受理された開始時に、complete は受理された完了時に、Error は失敗時に発火します。クォータイルトラッカーはありません。[CACHEBUSTING]、[TIMESTAMP]、[SCREENRIG_SCREEN_ID]、[SCREENRIG_SLOT_ID]、[SCREENRIG_PAGE_ID] のマクロが展開され、購入者にはタグは表示されません。update では --vast-tag-url がタグを置き換え、--clear-vast-tag-url でタグを削除します。両方は併用できず、どちらも省略すると保存済みタグが維持されます。ads slots list は vast_tag_url を所有する販売者に表示します。スクリーンで何も埋められないスロット（VAST タグがなく、広告にオプトインしたスクリーンでは、終了していない直接キャンペーンも、そのスロットを指定する有効・保留中・一時停止中の招待キャンペーンもない場合）は、そのスクリーンのマニフェストから外れ、screen show が ad_quiet_slots にそれを一覧表示するため、Player は問い合わせをやめます。埋められるキャンペーン、タグ、オプトインがあれば、スロットは戻ります。

上記の共有invitationsコマンドを使用してください。

screenrig invitations create --kind ad-buyer --email owner@bakery.example --screen-id scr_LOBBY --policy review_required
screenrig invitations list --kind ad-buyer
screenrig invitations revoke ID

広告購入者の招待はメールのみでリンクでは送れず、--screen-id または --slot-id を少なくとも 1 つ（カンマ区切り）指定する必要があります。--policy は trusted（既定）または review_required です。

招待された人がダッシュボードで承諾します。サインインした人は購入プロジェクトを選択し、新しいpasskey証明で確認します。ログインしていない人は承諾時にアカウントと広告主専用プロジェクトを作成します。

販売者：承認された購入者のレビュー方針と在庫範囲を変更または取り消します。

ads memberships list
ads memberships update <membership-id> --expect-rev REVISION
    [--policy trusted|review_required] [--screen-id IDS] [--slot-id IDS]
ads memberships revoke <membership-id>

screenrig ads memberships list

update は、省略したフラグについて保存済みのポリシーと範囲を維持します。trusted は購入者のクリエイティブを審査なしで再生し、review_required は各クリエイティブバージョンを販売者の判断まで保留します。--screen-id と --slot-id はカンマ区切りの ID を受け取り、リスト全体を置き換えます。空の値は何も許可しません。

取り消しは新しい広告再生を停止し、財務履歴を保持します。

購入者：準備完了の所有メディアを承認済みコピーの不変クリエイティブにバインド。

ads creatives list
ads creatives create --media-id ID --copy TEXT
ads creatives show <creative-id>

screenrig ads creatives create --media-id med_123 --copy "Fresh bread daily"

クリエイティブの紐付けは課金されず、メディアも再アップロードされません。承認済みのクリエイティブはその場で変更されません。元のメディアを編集して新しいクリエイティブを紐付けてください。--copy は 500 文字以内です。show は、各販売者ネットワークによるクリエイティブの審査結果（pending、approved、rejected、changes_requested）を販売者の理由とともに一覧表示します。

購入者：キャンペーンを作成し、価格を設定し、見積もりを承諾して有効化。

ads campaigns list
ads campaigns show <campaign-id>
ads campaigns create <file>
ads campaigns update <campaign-id> <file> --expect-rev REVISION
ads campaigns preview <campaign-id> [--expect-rev REVISION]
ads campaigns activate <campaign-id> --quote-id ID --expect-rev REVISION
ads campaigns pause <campaign-id> --expect-rev REVISION
ads campaigns resume <campaign-id> --expect-rev REVISION
ads campaigns accept-rates <campaign-id> --quote-id ID --expect-rev REVISION

screenrig ads campaigns preview cmp_123

ドラフトは何も予約しません。preview は時間制限付き見積もりを返し、何も消費しません。activate はその正確な見積もりを要求します。販売者レート変更後は、新しい見積もりでのみ accept-rates がキャンペーンを再開します。

<file> は JSON ファイルです。標準入力には - を使います。update はドラフトを文書全体で置き換えます。ドラフトには name、daily_cap_mcr、lifetime_cap_mcr（少なくとも 1 日の上限額）、flight_start と flight_end（RFC 3339）、そして、プロジェクトが参加した販売者ネットワークごとに 1 件のエントリを持つ networks を指定します。各エントリには seller_project_id、screen_ids、slot_ids、creative_ids、および必要に応じて venue_types、cities、tags、dayparts、network_cap_mcr を指定します。金額フィールドは 10 進の mcr 文字列で、数値ではありません。image_duration_ms（5000〜30000、省略時は 10 秒）は画像の表示時間を設定し、max_play_price_mcr は 1 回の再生の価格に上限を設けます。上限が不要なら省略します。

キャンペーンの下書きには、広告主カテゴリ一覧からオプションの category を指定できます。同じカテゴリの広告 2 本が、1 つの画面の同じ広告ブレイクで再生されることはありません。

preview は、--expect-rev でリビジョンを指定しない限りキャンペーンの現在のリビジョンを読み取ります。pause は新しい予約を停止します。すでに開始された再生は完了し、予約済みの価格で精算されます。resume は手動で一時停止したキャンペーンを再開しますが、価格変更による一時停止は解除できません。

販売者：screenRIG 外の広告主との自社の取引を、自社の画面で予約します。

ads direct list
ads direct show <campaign-id>
ads direct create <file>
ads direct update <campaign-id> <file> --expect-rev REVISION
ads direct pause <campaign-id> --expect-rev REVISION
ads direct resume <campaign-id> --expect-rev REVISION
ads direct end <campaign-id> --expect-rev REVISION
ads direct availability <file>
ads direct report <campaign-id> [--from TIME] [--to TIME]
    [--format json|csv|xlsx|pdf] [--output FILE|-]

screenrig ads direct create campaign.json

下書きには name、advertiser、オプションの category、flight_start と flight_end、media_ids（自社の準備済み画像または動画を 1〜20 件）、オプションの goal_plays、オプションの price（1,000 回再生あたりの model cpm または flat で、amount と ISO 4217 の currency を含む）、オプションの image_duration_ms（5000〜30000、省略時は 10 秒）、およびターゲティング（screen_ids、slot_ids、venue_types、cities、tags、dayparts（例: {"days": ["mon"], "start": "11:00", "end": "14:00"}））を指定します。空のリストはオプトインしたすべての画面または広告枠を意味します。直接キャンペーンは、招待された購入者より先に広告ブレイクを埋めます。目標は配信期間全体に均等に配分され、遅れている間は優先して再生されます。目標のないキャンペーンは、配信期間中の対象となるすべての広告枠を使用します。screenRIGを通じてお金は動きません。広告主への請求はお客様が行い、価格はレポートの金額算出に使われます。

<file> は JSON ファイルです。標準入力には - を使います。category は、ここでもキャンペーンの下書きでも、alcohol、apparel、automotive、beauty、cannabis、consumer_electronics、education、entertainment、financial_services、food_and_beverage、gambling、government、grocery、health_and_pharma、home_and_garden、insurance、jobs、legal、media、political、quick_service_restaurants、real_estate、restaurants、retail、sports_and_fitness、technology、telecom、tobacco_and_vaping、travel、utilities のいずれかです。update は書き込み可能なすべてのフィールドを置き換えるため、文書全体を送ってください。pause はキャンペーンによる広告枠の使用を止め、resume はそれを再開します。目標付きのキャンペーンが一時停止中にペースから遅れた場合、追いつくまで優先して再生されます。end は取り消せません。終了したキャンペーンはそれ以上再生されず、再開もできず、レポートは残ります。

availability は同じターゲティングと配信期間のクエリを読み取り、まだ予約できる再生数を見積もります。対象画面の最近の広告枠の発生数から、他の直接目標がまだ必要とする再生数を差し引いた値です。応答は estimated_plays、booked_plays、available_plays で、exclude_campaign_id を指定すると編集中のキャンペーンが booked_plays から除外されます。見積もりを超える目標は、下書きが "overbook": true を設定しない限り goal_overbooked を返します。

report は、目標に対する再生数、ペース、金額、再生されなかった再生数、および UTC の日・画面・広告枠・メディアごとの行を一覧表示します。--from と --to は RFC 3339 の日時、now、または 7d、12h、30m のような経過期間を受け付け、既定では配信期間全体になります。--format csv、xlsx、pdf を指定すると行を --output（既定は ./direct-report-CAMPAIGN_ID.FORMAT）に書き出し、そのパス、バイト数、SHA-256 を返します。--format csv のとき --output - を指定すると、代わりに CSV を標準出力に書き出します。CSV の列は day、screen_id、slot_id、media_id、plays、played_ms、estimated_impressions です。JSON または CSV のレポートは最大 5000 行まで掲載され、それ以上ある場合は警告 direct_report_truncated が付きます。残りは --from と --to を絞り込んで取得します。

直接キャンペーンの作成、置き換え、再開、そして availability と report には、直接キャンペーンを含むプランが必要です。それ以外のプランは feature_not_in_planで拒否されます。screenrig project capabilities はプランの機能を一覧表示します。

販売者：review_required で購入者から提出された正確なクリエイティブバージョンを承認、拒否、または変更を要求します。

ads reviews list
ads reviews show <review-id>
ads reviews approve <review-id>
ads reviews reject <review-id> --reason TEXT
ads reviews request-changes <review-id> --note TEXT

screenrig ads reviews request-changes arv_123 --note "Use the new logo"

request-changes は購入者にメモを送信します。修正版を提出するには、修正したメディアを新しいクリエイティブとして紐付け、新しいキャンペーンに追加してから、新しい見積もりで preview と activate を実行します。代わりのキャンペーンには独自の予算と審査履歴があります。配信が重複しないように、代わりのキャンペーンを有効化する前に元のキャンペーンを一時停止してください。広告クリエイティブの審査は、プレイリストやスクリーンの変更と同じく、ダッシュボードの「審査」ページで行います。

list は販売者の判断を待っているクリエイティブバージョンを、show は 1 件の提出とその正確なクリエイティブを表示します。--reason と --note は必須で 500 文字以内です。購入者はクリエイティブ上で内容を読めます（ads creatives show）。判断には管理アクセスが必要です。

購入者としての支出または販売者としての配信を読み取ります。

ads reports spend --campaign-id ID [--format json|csv|xlsx|pdf] [--output FILE]
ads reports delivery --from TIMESTAMP --to TIMESTAMP
    [--format json|csv|xlsx|pdf] [--output FILE]
ads reports fill [--from TIME] [--to TIME] [--format json|csv|xlsx|pdf] [--output FILE]

screenrig ads reports delivery --from 2026-09-01T00:00:00Z --to 2026-10-01T00:00:00Z

期間の総配信数、手数料、純額を報告します。購入者のレポートは販売者の他の収入を表示しません。fill は最大 35 日間について、画面が要求した広告枠の発生数、そのうち直接キャンペーン、招待された購入者、VAST タグが埋めた数、および残りが空のままだった理由（no_demand、ineligible、separated、capped）を示します。

--format csv、xlsx、pdf を指定すると、レポートをファイルとして --output（既定は ./ad-spend.FORMAT、./ad-delivery.FORMAT、./ad-fill.FORMAT）に書き出し、そのパス、バイト数、SHA-256 を返します。json が既定で、エンベロープを出力します。delivery には --from と --to を RFC 3339 の日時で指定する必要があり、完了した発生ごとに 1 行を最大 5000 行まで一覧表示し、それ以上ある場合は truncated が設定されます。合計はすべての精算を対象とします。fill は RFC 3339 の日時、now、または 7d、12h、30m のような経過期間を受け付けます。--from の既定は --to の 7 日前、--to の既定は現在で、間隔は最大 35 日で、UTC の時間単位に広げられます。