Gå til indholdet

Ordliste

Hvert begreb, to perspektiver. Den venstre kolonne er, hvordan en mediakøber tænker om det. Den højre kolonne er, hvordan en DevOps-ingeniør finder det i systemet.

Begreb Mediakøberdefinition DevOps / systemdefinition
Seat En køberkonto på Google Authorized Buyers. Du afgrænser din analyse og targeting per seat. buyer_account_id i Postgres. Gemt i seats-tabellen. Synkroniseret via GET /seats.
QPS Queries Per Second: den maksimale rate af budforespørgsler, du beder Google om at sende. Google begrænser den faktiske mængde baseret på dit kontoniveau. Konfigureret loft per pretargeting-konfiguration. Faktisk indgående rate overvåges via RTB-tragtmetrikker i rtb_daily.
Spild QPS forbrugt af budforespørgsler, din bidder afviser (forkerte geografier, forkerte formater, ingen matchende kreativ). Penge brugt på ingenting. (total_qps - bids_placed) / total_qps. Beregnet fra rtb_daily-aggregater. Synlig i tragt-API'et.
Pretargeting-konfiguration De regler, der styrer, hvilke budforespørgsler der når din bidder. Du får 10 per seat. Styrer geografier, formater, platforme, publishers. Muterbar entitet synkroniseret fra Google AB API. Gemt i pretargeting_configs. Administreret via /settings/pretargeting. Snapshots muliggør rollback.
Tragt Progressionen fra budforespørgsel til forbrug: QPS -> Bud -> Vindere -> Visninger -> Klik -> Forbrug. Hvert trin har frafald. Beregnet fra rtb_daily-metrikker. Serveret af GET /analytics/rtb-funnel. Frontend cacher i 30 minutter.
Kreativ Et annonceaktiv: billede, video, HTML eller native. Har et format, en størrelse, en destinations-URL og en performancehistorik. Række i creatives-tabellen. Thumbnails i blob storage. Synkroniseret fra Google AB API. Performance fra rtb_daily-joins.
Kampagne En logisk gruppering af kreativer. Bruges til at organisere analyse og rapportering. Række i ai_campaigns-tabellen. Many-to-many med kreativer. Understøtter AI-autoklyngning.
Konfigurationskort UI-panelet, der viser en pretargeting-konfigurations tilstand, maks. QPS, geografier, formater og platforme. PretargetingConfigCard React-komponent. Data fra GET /settings/pretargeting-configs.
Datafriskhed Et gitter, der viser, hvilke datoer der har importerede data ("importeret") vs. huller ("manglende") for hver rapporttype. GET /uploads/data-freshness. Bruger generate_series + EXISTS-queries mod rtb_daily, rtb_bidstream, rtb_quality, rtb_bid_filtering. 30s statement-timeout.
Import At få CSV-performancedata ind i Cat-Scan, enten via manuel upload eller Gmail-autoimport. CSV parset, valideret, deduplikeret (via row_hash unique constraint), indsat i måltabeller. Chunked upload for filer > 5MB.
Rollback Tilbageføring af en pretargeting-konfigurationsændring til dens tidligere tilstand. Forhåndsvis med dry-run, derefter bekræft. Snapshot-gendannelse: læser pretargeting_snapshots, anvender delta til Google AB API, registrerer nyt snapshot. POST /snapshots/rollback.
Optimizer / BYOM Automatiseret system, der scorer segmenter og foreslår konfigurationsændringer. Bruger din egen eksterne model. Score-endpoint kaldet via HTTP POST. Forslag gemt i optimizer_proposals. Livscyklus: score -> foreslå -> godkend -> anvend.
Workflow-preset Safe, balanced eller aggressive. Styrer, hvor dristige optimizerens forslag er. canary_profile-parameter til score-and-propose API. Påvirker konfidenstærskler og ændringsomfangsgrænser.
Effektiv CPM Hvad du faktisk betaler per tusind visninger, når spild og infrastrukturomkostninger medregnes. Beregnet i OptimizerEconomicsService. Kombinerer forbrugsdata fra rtb_daily med konfigurerede hostingomkostninger.
Konvertering En værdifuld brugerhandling (køb, tilmelding) sporet efter en visning. Fødes tilbage for at optimere targeting. Hændelse indlæst via pixel (GET /conversions/pixel) eller webhook (POST /conversions/webhook). Gemt i konverteringstabeller. HMAC-verificeret for webhooks.
Vindrate Vindere / Bud. Hvor konkurrencedygtige dine bud er i auktionen. auction_wins / bids_placed fra rtb_daily.
CTR Klik / Visninger. Hvor engagerende dine kreativer er. clicks / impressions fra rtb_daily.
Runtime health-gate (Ikke et køberbegreb) v1-runtime-health-strict.yml CI-workflow. Kører end-to-end-tjek: API health, data health, konverteringer, optimizer, QPS SLO. Returnerer PASS/FAIL/BLOCKED per tjek.
Contract check (Ikke et køberbegreb) scripts/contracts_check.py. Validerer datakontrakter (ufravigelige regler fra import til API-output). Køres efter deploy. Blokerer release ved fejl.
Cloud SQL Proxy (Ikke et køberbegreb) Sidecar-container, der giver autentificeret adgang til Cloud SQL Postgres. Skal være sund, før API-containeren starter.
X-Email header (Ikke et køberbegreb) HTTP-header sat af OAuth2 Proxy efter Google-autentificering. Betroet af API'et, når OAUTH2_PROXY_ENABLED=true. Fjernet af nginx for eksterne forespørgsler.