Publicité : commandes CLI

Acheteur : lister les réseaux dans lesquels ce projet a été invité, et inspecter l’inventaire et les emplacements autorisés d’un réseau.

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

screenrig ads networks list

Vendeur : inspecter ou créer le réseau propre à ce projet et définir son tarif par défaut.

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 compte au plus 120 caractères. --rate-mcr-per-15s est un nombre entier positif de mcr par tranche de 15 secondes de lecture terminée, et --expect-rev est la revision du réseau tirée de ads network show. Un changement du tarif effectif met en pause les campagnes touchées jusqu’à ce que chaque acheteur accepte un nouveau devis.

Vendeur : inclure ou exclure un écran détenu de la publicité et le décrire aux acheteurs invités.

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

Les indicateurs omis gardent leurs valeurs actuelles. Une nouvelle ligne d’inventaire nécessite --enabled ou --disabled. --impressions-per-hour enregistre votre estimation des impressions que l’écran diffuse en une heure : chaque diffusion terminée compte alors cette estimation multipliée par les secondes diffusées et divisée par 3600 comme estimated_impressions dans ads reports spend, ads reports delivery et ads direct report.

update exige au moins un indicateur. --audience-tags accepte jusqu’à 20 étiquettes séparées par des virgules, chacune d’au plus 32 lettres, chiffres ou traits de soulignement. --clear-rate remet l’écran au tarif par défaut du projet et --clear-impressions-per-hour supprime l’estimation. --expect-rev remplace la révision enregistrée de la ligne comme condition préalable et est refusé pour un écran qui n’a pas encore de ligne.

Vendeur : définir des emplacements publicitaires réutilisables. Un emplacement ne change rien sur l’écran tant que sa page d’emplacement publicitaire n’est pas placée dans une liste de lecture.

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

Un nouvel emplacement est activé sauf si --disabled est indiqué. --accepted-media vaut image, video ou les deux, séparés par une virgule. Les limites de durée omises valent 30000 ms ; une limite d’image va de 5000 à 30000 ms et une limite de vidéo de 5000 à 120000 ms. --rate-mcr-per-15s est un entier positif qui remplace le tarif de l’écran ou du projet pour cet emplacement, et --clear-rate supprime cette substitution. update conserve chaque champ omis, et un changement du tarif effectif met en pause les campagnes touchées jusqu’à ce que chaque acheteur accepte un nouveau devis. --vast-tag-url est une URL HTTPS d’au plus 2048 caractères.

--vast-tag-url définit la balise publicitaire VAST 2-4 propre au vendeur, essayée lorsqu’aucune campagne invitée ne remplit l’emplacement sur vos propres écrans ; l’emplacement doit accepter la vidéo. L’URL est HTTPS sur le port 443 ou 8443 vers un hôte public. Le backend la récupère, suit jusqu’à cinq Wrappers, ingère le MP4 ou WebM progressif choisi dans les médias du projet, et déclenche Impression, creativeView et start sur un début accepté, complete sur une fin acceptée, et Error sur échec ; il n’y a pas de traceurs de quartiles. Les macros [CACHEBUSTING], [TIMESTAMP], [SCREENRIG_SCREEN_ID], [SCREENRIG_SLOT_ID] et [SCREENRIG_PAGE_ID] sont développées, et les acheteurs ne voient jamais la balise. Sur update, --vast-tag-url remplace la balise et --clear-vast-tag-url la supprime ; les deux ne se combinent pas, et omettre les deux conserve la balise stockée. ads slots list affiche vast_tag_url au vendeur propriétaire. Un emplacement que rien ne peut remplir sur un écran (aucune balise VAST et, sur un écran inscrit à la publicité, aucune campagne directe non terminée et aucune campagne invitée active, en attente ou en pause qui le nomme) est exclu du manifeste de cet écran, et screen show le liste dans ad_quiet_slots, de sorte que le Player cesse de le demander. Une campagne, une balise ou une inscription qui pourrait le remplir le rétablit.

Utilisez les commandes partagées invitations ci-dessus :

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

Une invitation d’acheteur publicitaire passe par courriel, jamais par lien, et exige au moins un --screen-id ou un --slot-id (séparés par des virgules). --policy vaut trusted (par défaut) ou review_required.

La personne invitée accepte dans le tableau de bord. Une personne connectée sélectionne son projet d’achat et confirme avec une preuve de passkey récente. Une personne sans compte en crée un ainsi qu’un projet réservé aux annonceurs lors de l’acceptation.

Vendeur : modifier ou révoquer la politique d’avis et la portée d’inventaire d’un acheteur admis.

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 conserve la politique et la portée enregistrées pour les indicateurs omis. trusted diffuse les créations de l’acheteur sans examen ; review_required retient chaque version de création pour votre décision. --screen-id et --slot-id prennent des identifiants séparés par des virgules et remplacent toute la liste ; une valeur vide n’autorise rien.

La révocation arrête les nouvelles diffusions publicitaires et conserve l’historique financier.

Acheteur : lier les médias possédés prêts à une création immuable avec copie approuvée.

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"

Lier une création ne coûte rien et ne téléverse pas à nouveau le média. Une création approuvée ne change jamais sur place : modifiez le média source et liez une nouvelle création. --copy compte au plus 500 caractères. show liste l’examen de la création par chaque réseau vendeur (pending, approved, rejected ou changes_requested) avec le motif du vendeur.

Acheteur : rédiger une campagne, la tarifer et l’activer en acceptant le devis.

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

Un brouillon ne réserve rien. preview renvoie un devis limité dans le temps et ne dépense rien ; activate exige ce devis exact. Après un changement de tarif vendeur, seule accept-rates avec un devis frais reprend la campagne.

<file> est un fichier JSON, ou - pour l’entrée standard, et update remplace un brouillon par le document entier. Le brouillon nomme name, daily_cap_mcr, lifetime_cap_mcr (au moins le plafond quotidien), flight_start et flight_end (RFC 3339) et networks, une entrée par réseau vendeur auquel le projet a adhéré, chacune avec seller_project_id, screen_ids, slot_ids, creative_ids et, au besoin, venue_types, cities, tags, dayparts et network_cap_mcr. Les champs monétaires sont des chaînes mcr décimales, jamais des nombres. image_duration_ms (de 5000 à 30000, dix secondes par défaut) fixe la durée d’affichage d’une image, et max_play_price_mcr plafonne le prix d’une diffusion ; omettez-le pour n’avoir aucun plafond.

Un brouillon de campagne accepte un category facultatif tiré de la liste des catégories d’annonceurs. Deux annonces d’une même catégorie ne jouent jamais dans la même pause publicitaire sur un écran.

preview lit la révision actuelle de la campagne, sauf si --expect-rev en désigne une. pause arrête les nouvelles réservations ; les diffusions déjà commencées se terminent et sont réglées à leur prix réservé. resume relance une campagne mise en pause manuellement et ne peut pas lever une pause due à un changement de prix.

Vendeur : réservez vos propres ententes pour des annonceurs extérieurs à screenRIG sur vos propres écrans.

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

Un brouillon indique name, advertiser, un category facultatif, flight_start et flight_end, media_ids (de 1 à 20 de vos propres images ou vidéos prêtes), un goal_plays facultatif, un price facultatif (model cpm par mille diffusions ou flat, avec un amount et un currency ISO 4217), un image_duration_ms facultatif (de 5000 à 30000, dix secondes par défaut) et le ciblage : screen_ids, slot_ids, venue_types, cities, tags et dayparts (comme {"days": ["mon"], "start": "11:00", "end": "14:00"}), où une liste vide désigne chaque écran ou emplacement inscrit. Une campagne directe remplit une pause publicitaire avant les acheteurs invités. Un objectif est réparti uniformément sur la période de diffusion et joue en premier tant qu’il est en retard; une campagne sans objectif prend chaque emplacement admissible pendant sa période de diffusion. Aucun argent ne passe par screenRIG : vous facturez l’annonceur, et le prix sert à valoriser le rapport.

<file> est un fichier JSON, ou - pour l’entrée standard. category, ici et dans un brouillon de campagne, vaut l’une des valeurs 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 ou utilities. update remplace chaque champ modifiable, alors envoyez le document entier. pause empêche une campagne de prendre des emplacements publicitaires et resume la rétablit ; une campagne avec objectif qui a pris du retard pendant la pause joue en premier jusqu’à ce qu’elle rattrape son retard. end est définitif : une campagne terminée ne joue plus, ne peut pas être reprise et conserve son rapport.

availability lit une requête avec le même ciblage et la même période de diffusion et estime les diffusions que vous pouvez encore réserver : les occurrences récentes d’emplacements publicitaires des écrans ciblés, moins les diffusions dont vos autres objectifs directs ont encore besoin. Elle répond avec estimated_plays, booked_plays et available_plays, et exclude_campaign_id exclut de booked_plays la campagne que vous modifiez. Un objectif supérieur à l’estimation renvoie goal_overbooked, sauf si le brouillon définit "overbook": true.

report liste les diffusions par rapport à l’objectif, le rythme, la valeur, les diffusions qui n’ont pas joué, et des lignes par jour UTC, écran, emplacement et média. --from et --to acceptent un instant RFC 3339, now ou un âge comme 7d, 12h ou 30m, et couvrent par défaut la période de diffusion. --format csv, xlsx ou pdf écrit les lignes dans --output (par défaut ./direct-report-CAMPAIGN_ID.FORMAT) et répond avec son chemin, ses octets et son SHA-256 ; avec --format csv, --output - écrit plutôt le CSV sur la sortie standard. Les colonnes du CSV sont day, screen_id, slot_id, media_id, plays, played_ms et estimated_impressions. Un rapport JSON ou CSV compte au plus 5000 lignes et porte l’avertissement direct_report_truncated lorsqu’il y en a d’autres : restreignez --from et --to pour obtenir le reste.

La création, le remplacement et la reprise d’une campagne directe, availability et report exigent un forfait qui inclut les campagnes directes ; les autres forfaits sont refusés avec feature_not_in_plan. screenrig project capabilities liste les fonctionnalités du forfait.

Vendeur : approuver, rejeter ou demander des modifications aux versions exactes des créations soumises par les acheteurs sur 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 envoie votre note à l’acheteur. Pour soumettre la révision, associez les médias révisés à une nouvelle création publicitaire, ajoutez-la à une nouvelle campagne, puis exécutez preview et activate avec le nouveau devis. La campagne de remplacement a son propre budget et son propre historique d’examen. Mettez la campagne d’origine en pause avant d’activer sa remplaçante pour éviter que leurs diffusions se chevauchent. Les décisions concernant les créations publicitaires se prennent dans la page Examens du tableau de bord, aux côtés des modifications de listes de lecture et d’écrans.

list affiche les versions de création en attente de votre décision et show une soumission avec sa création exacte. --reason et --note sont obligatoires et comptent au plus 500 caractères ; l’acheteur les lit sur la création (ads creatives show). Décider exige l’accès Gérer.

Lire les dépenses en tant qu’acheteur ou les livraisons en tant que vendeur.

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

Les rapports de livraison indiquent le brut, les frais de service et le net pour la période. Un rapport d’acheteur ne montre jamais les autres revenus d’un vendeur. fill montre, sur un maximum de 35 jours, combien d’occurrences d’emplacements publicitaires vos écrans ont demandées, combien ont été remplies par des campagnes directes, des acheteurs invités et votre balise VAST, et pourquoi les autres sont restées vides : no_demand, ineligible, separated ou capped.

--format csv, xlsx ou pdf écrit le rapport dans un fichier --output (par défaut ./ad-spend.FORMAT, ./ad-delivery.FORMAT ou ./ad-fill.FORMAT) et répond avec son chemin, ses octets et son SHA-256 ; json est la valeur par défaut et affiche l’enveloppe. delivery exige --from et --to sous forme d’instants RFC 3339 et liste une ligne par occurrence terminée, au plus 5000, avec truncated défini lorsqu’il y en a d’autres ; les totaux couvrent chaque règlement. fill accepte un instant RFC 3339, now ou un âge comme 7d, 12h ou 30m : --from vaut par défaut 7 jours avant --to, --to vaut maintenant, avec au plus 35 jours d’écart, élargis à des heures UTC entières.