Document Type: Registry
Status: Active
Version: v1.2
Authority: Affiliate Brain (Operational Infrastructure)
Applies To: Affiliate Brain ad-level metadata structure for paid creative intelligence, attribution, and outcome-quality tracking
Parent: Affiliate Performance Systems
Last Reviewed: 2026-03-15
Purpose
This page defines the structured metadata registry for all paid creatives used within the Affiliate Brain environment.
This registry exists to create a durable intelligence layer for ad-level performance analysis, attribution clarity, and controlled scaling discipline.
It enables:
• hook-level ROI analysis
• mechanism-level performance tracking
• persona-level profitability mapping
• historical attribution reference
• controlled scaling decisions
• outcome-quality validation through closed-loop discipline
No ad may deploy capital without a metadata record.
Scope
This registry applies to:
• paid creative records inside Affiliate Brain
• ad-level metadata structure
• attribution support for campaign intelligence
• closed-loop outcome-quality tracking where available
• capital-control validation linked to creative deployment
This document governs the required structure and role of the Affiliate Ad Metadata Registry as an internal intelligence system.
It does not govern:
• campaign reporting dashboards by itself
• public-facing performance reporting
• live campaign execution by itself
• capital approval by itself
• scaling approval by itself
• automation implementation by itself
Those remain governed by Affiliate Brain systems, Velocity Decision Engine, Finance Brain, SIT controls, and related protocols.
Definition / Rules
Architectural Role
This page defines the structural schema for ad-level intelligence.
It is infrastructure.
It is not:
• public-facing content
• a reporting dashboard
• a campaign log
It is the intelligence backbone for creative performance mapping and scaling safety.
Core Required Fields
Every ad record must contain the following field groups.
Identity
• ad_id (UUID or structured unique ID)
• platform (YouTube / Google / Meta / etc.)
• campaign_name
• adgroup_or_asset_name (if applicable)
• creative_format (Video / Image / Text)
Classification
• hook_type (Mechanism / Authority / Identity / Curiosity / etc.)
• mechanism_category
• angle_cluster
• persona_target
Offer + Phase
• offer_id
• phase (Phase 4 / Phase 5 / Phase 6)
• date_launched
• velocity_status
Attribution Keys
• utm_content_id
• utm_campaign_id (if used)
• landing_page_id (bridge / VSL page identifier if used)
Capital Control
• capital_allocated
• spend_cap_rule (manual descriptor)
Optional Performance Fields (Post-Launch)
These fields may populate after launch:
• ctr
• conversion_rate
• cost_per_click
• cost_per_conversion
• sessions
• leads_or_conversions_count
Closed-Loop Outcome Fields (Required When Available)
These fields connect ad performance to outcome quality.
• outcome_quality_status (PASS / FAIL / UNKNOWN)
• buyer_quality_flag (GOOD / MIXED / POOR / UNKNOWN)
• refund_signal (LOW / NORMAL / HIGH / UNKNOWN)
• chargeback_signal (LOW / NORMAL / HIGH / UNKNOWN)
• net_revenue_status (PASS / FAIL / UNKNOWN)
Optional when the network provides data:
• upsell_acceptance_rate
• retention_signal (PASS / FAIL / UNKNOWN)
• reversal_notes (free text summary)
Rule:
If closed-loop data is not available, status must remain UNKNOWN.
No false certainty is permitted.
Enforcement Rule
No capital allocation is permitted without a registry entry.
Velocity Decision Engine may reference this registry before scaling approval.
Finance Brain may require registry validation prior to budget increases.
Outcome quality may override front-end conversion success.
System Integration
This registry connects to:
• Two-Hurdle Diagnostic Framework
• Closed-Loop Feedback Layer (Affiliate)
• Velocity Decision Engine
• Finance Brain capital gates
• SIT anomaly detection (future)
Future Integration (Deferred)
Future implementation may include:
• Supabase table creation
• Creative Intelligence dashboard
• automated UTM generation registry
• refund intelligence ingestion
• portfolio governance scoring
Execution layer remains inactive.
Activation Status
Schema Defined.
Automation Deferred.
Final Rule
No paid creative should deploy capital without a structured metadata record.
If ad-level intelligence is not captured, attribution weakens, scaling risk rises, and closed-loop quality control becomes unreliable.
Affiliate Brain must maintain structured ad metadata before performance can be trusted operationally.
Drift Protection
The system must prevent:
• creatives launching without a metadata record
• attribution keys being omitted where required
• front-end conversion success being judged without outcome-quality context
• closed-loop fields being filled with assumed certainty
• registry records being treated as optional administration
• scaling decisions occurring without ad-level intelligence traceability
This registry must remain structured, mandatory, and decision-relevant.
Architectural Intent
Affiliate Ad Metadata Registry Blueprint exists to provide the Affiliate Brain with a structured intelligence backbone for tracking what each paid creative is, how it was classified, how it was launched, and what quality of outcome it produced.
Its role is to support better attribution, safer scaling, and more reliable closed-loop decision-making by ensuring that every ad has a traceable intelligence record rather than existing as isolated campaign activity.
Change Log
Version: v1.2
Date: 2026-03-15
Author: MWMS HeadOffice / Affiliate Brain
Change: Rebuilt page to align with MWMS document standards. Added standardised document header, converted Last Updated to Last Reviewed, introduced Purpose / Scope / Definition / Rules structure, normalised field-group sections, added Final Rule, Drift Protection, and Architectural Intent sections, and preserved the original registry purpose, required field schema, enforcement rule, system integrations, and deferred automation status.
Version: v1.1
Date: 2026-02-26
Author: Affiliate Brain / MWMS HeadOffice
Change: Active structural version of the Affiliate Ad Metadata Registry defining required ad-level metadata, attribution keys, closed-loop outcome fields, enforcement logic, and future integration directions.
END – AFFILIATE AD METADATA REGISTRY BLUEPRINT v1.2