This reference preserves the raw direction from the Helix and Glean research packs plus the local repo scans of optimus and pinboard. It is not a teaching note. Use it as a backlog for future note expansion and Pinterest-specific deep dives.
Why This Exists
The first teaching pass should explain the system in a reader-friendly order:
- what an online advertising revenue system is,
- marketplace actors and control points,
- advertiser control-plane objects,
- one serving request, including retrieval, candidate control, ranking, auction, pricing, and render boundaries,
- the money and measurement loop: billing events, spend mapping, pacing, attribution, incrementality, and cost-control checks.
The research packs contain more than that path should carry. Some items are implementation-dependent, platform-specific, or require internal confirmation. Keep those here until they can be verified and placed in the correct note.
Research Inputs Received
- Helix public-source research pack on advertising revenue systems.
- Glean research pack on advertising systems and infrastructure/cost-control implications.
- Read-only repo scan of
/Users/eporcu/code/optimus. - Read-only repo scan of
/Users/eporcu/code/pinboard.
External Concepts To Expand Later
| Topic | Keep for |
|---|---|
OpenRTB (Open Real-Time Bidding), demand-side platform, supply-side platform, exchange, seatbid, bidfloor, nurl, burl | Future Offsite Ads and OpenRTB note. |
| Frequency capping and ad fatigue | Future Frequency Capping and Ad Fatigue note. |
| Ads logging, reporting, stream joins, watermarks, exactly-once semantics | Future Ads Logging Reporting and Streaming Pipelines note. |
| Cost per request, candidate logging, model inference, feature-store cost | Expand the cost-control sections in Ad Serving Request Lifecycle and Advertising Money Measurement and Control. |
| Brand lift, conversion lift, holdouts, geo experiments, ghost bids | Expand Advertising Money Measurement and Control after source verification. |
| First-price, generalized second price, Vickrey-Clarke-Groves, quality-adjusted auctions | Expand Ad Serving Request Lifecycle with stronger examples. |
| Daily/lifetime budgets, overdelivery rules, target-to-date curves | Expand Advertising Money Measurement and Control with source-specific caveats. |
| Viewable impression standards and billable event semantics | Expand Advertising Money Measurement and Control with Media Rating Council / Interactive Advertising Bureau sources. |
Pinterest-Specific Internal Concepts
These should not be explained from public adtech sources. They need code/docs evidence from internal repos and should live in Pinterest-specific notes.
| Concept | Where it appeared |
|---|---|
AdMixer | optimus/admixer/docs/, serving-path code. |
Muse | optimus/admixer/docs/retrieval/, pinboard Premiere playbooks. |
Scorpion | optimus/admixer prediction/scoring paths, pinboard ads ML references. |
WPO / Whole Page Optimization | optimus/admixer/docs/auction/graph.md, marketplace code. |
OABS / offsite ads bidding service | optimus/offsite-ads/docs/, Rust pipeline code. |
Apex | optimus/admixer/docs/execution_graph/, campaignmanagement docs. |
PpCandidatesTable / request-level data | optimus/admixer/docs/data_model/intro.md. |
| Realtime ads indexing | optimus/ads-realtime-indexing, ads-realtime-index-common. |
| Realtime spend mapping | optimus/ads-reporting-streaming-java. |
| Measurement Hub, PBL, PCL, brand lift serving | pinboard/agent-skills/measurement-hub, brand-lift-serving, related managers. |
| Premiere / Spotlight ads serving vocabulary | pinboard/docs/premiere*. |
Optimus Repo Evidence Map
| Area | Evidence paths |
|---|---|
| Control plane | campaignmanagement/docs/index.md, campaignmanagement/server/src/main/java/com/pinterest/campaignmanagement/service/. |
| Online serving | admixer/docs/index.md, admixer/docs/feature_expansion/intro.md, admixer/docs/retrieval/intro.md, admixer/docs/funnel/intro.md, admixer/docs/auction/graph.md. |
| Marketplace and auction | admixer/src/main/java/com/pinterest/admixer/marketplace/, admixer/docs/marketplace/utility_term.md. |
| Offsite real-time bidding | offsite-ads/docs/index.md, offsite-ads/offsite-ads-bidding-service-rust/src/pipeline/. |
| Realtime indexing | ads-realtime-indexing/docs/architecture/shopping-architecture.md, ads-realtime-index-common/.../enrichment/processors/. |
| Spend/reporting streams | ads-reporting-streaming-java/src/main/java/com/pinterest/ads/reporting/streaming/java/. |
Pinboard Repo Evidence Map
| Area | Evidence paths |
|---|---|
| Ads API object model | api/api_spec/components/schemas/, api/templates/v2/markdown/02_campaign_management.md, api_tests_v5/ads/. |
| Serving/debugging | docs/premiere_dev/docs/index.md, docs/premiere/docs/Playbook/. |
| Marketplace simulation | pinflow_workflows/ezflow_workflows/ads_marketplace/. |
| Ads retrieval workflows | pinflow_workflows/ezflow_workflows/ads_retrieval/. |
| Measurement and lift | reporter/m10n/measurement/, agent-skills/measurement-hub/, agent-skills/brand-lift-serving/. |
| Ads ML infrastructure | ads_ml_infra/, ml_resources/datasets/ads/, ml_platform/feature_registry/features/ads/. |
Claims To Verify Before Publishing Strongly
- Exact platform budget overdelivery rules for Google, Meta, Pinterest, and TikTok.
- Whether a given product bills on insertion, impression, viewable impression, click, engagement, or conversion.
- Exact OpenRTB
nurlversusburlbehavior for each exchange integration. - Pinterest public engineering claims about GPU ranking, candidate generation, and online metric movement.
- Any claim about “common” auction mechanisms by channel unless backed by primary docs or papers.
- Any latency number such as 50-200 ms end-to-end or 50-100 ms DSP decision budgets.
- Any lift-study eligibility threshold, budget threshold, or minimum conversion volume.
Future Note Backlog
Offsite Ads and OpenRTBFrequency Capping and Ad FatigueAds Logging Reporting and Streaming PipelinesPinterest Ads Revenue SystemsPinterest Internal Ads VocabularyPinterest Ads Serving DebuggingPinterest Realtime Spend and PacingPinterest Measurement and Lift Systems