This module interprets explicitly selected captured bidding parameters for Google, Microsoft and Meta. Owner scope, account currency, numeric origin, event denominator, strategy declaration, documentation applicability, eligibility and delivery retain independent standing. Maximum auction bid, average cost constraint, minimum return floor, average return target, hard spend ceiling and best-effort minimum spend have different meanings.

This is the unofficial 0.1.0 module specification. Source review and executable correctness are separate standings. Full generation, runtime and publication verification are pending configured GitHub CI; this draft supplies no release, native write or client-adoption qualification.

Scope and intended use

This module interprets explicitly selected captured bidding parameters for Google, Microsoft and Meta. Owner scope, account currency, numeric origin, event denominator, strategy declaration, documentation applicability, eligibility and delivery retain independent standing. Maximum auction bid, average cost constraint, minimum return floor, average return target, hard spend ceiling and best-effort minimum spend have different meanings.

Agents can inspect the selected retained evidence, ask for missing scope or review, and keep unresolved answers visible. A successful inspection remains separate from permission to act on a live account.

Competency questions

  1. Which native owner supplies this captured strategy or parameter?
  2. Which currency, monetary encoding and event denominator qualify its interpretation?
  3. Can two selected parameters be compared under one identical constraint role?

Namespace

https://ontology.inferal.com/modules/ads-bidding-context/

The prefix bc names the existing vocabulary. Term identity and the original RDF types remain stable. Shared advertising and commerce concepts supply scope; captured provider terms retain their provider-specific meaning.

Conceptual model

SelectionContext identifies the captured owner, parameter, operation and interpretation basis. SourceCapture retains matching owner, account and provider bindings. BiddingAssessment keeps raw evidence when a qualification fails. Meta campaign and ad-set strategy ownership remains distinct. Conflicting retained Meta unit clauses remain visible even when a retained-overview interpretation is selected; this choice does not authenticate current native unit meaning.

Independent evidence axes
EvidenceWhat the consumer can conclude
Retained sourceThe selected bytes and represented claims remain inspectable.
Scoped interpretationThe named contract supplies a result with its own qualification and coverage.
Current action authorityLive permission, native applicability and client adoption require separately qualified evidence.

Operation, parameter kind and interpretation basis are closed versioned inputs. A present capture must have exactly one matching capturedOwner, capturedAccount, capturedProvider and capturedAccountKey. Present conflicting native account identifiers cannot be overridden by a declaration. Missing or distinct timestamp terms leave timing unqualified. A supplied ambiguous portfolio reference cannot fall back to a favorable direct campaign target.

RDF permits incomplete descriptions. A conforming execution profile must enforce its declared closed-world input and output constraints. Unknown or conflicting business evidence must keep its explicit standing and cannot be converted into a favorable value.

Validation and interpretation

Money needs qualified source currency, and comparisons also need the same captured constraint role and event unit. A Google portfolio effective currency remains distinct from manager-account currency. Native doubles preserve ratio meaning with unqualified original exact numeric origin; Google CPA micros follow their separate currency-scoped interpretation. Negative values, NaN, infinity and unsupported numeric bounds retain raw evidence with unqualified meaning. An unsupported optimization goal stays Unknown. Captured parameter admission supplies no current eligibility, mutation authority, auction participation or target attainment.

Validation establishes conformance to a selected profile. Retained scope, reported evidence and operational success keep their separate meanings. Runtime and generation evidence for this source repair remain pending GitHub CI.

Worked example and boundary

The example selects a captured Meta ad-set bid and a retained overview interpretation with explicit owner, currency and event context. The two documentation clauses remain available; the interpretation neither resolves their conflict nor grants a native mutation permission.

Inspect the declared roles and independent standings before using this evidence. Omitted source data or an unresolved qualification must remain visible. This example does not attest a live provider request or complete merchant history.

Term reference

Classes, properties and existing controlled evidence values retain their authored labels and definitions. Listing a controlled value here does not change its RDF type or grant execution authority.

bc:AppInstall — App Install
Scoped app install; not a native currentness, permission or outcome assertion.
bc:ApplicableOwnerInheritanceSnapshot — Applicable Owner Inheritance Snapshot
Scoped applicable owner inheritance snapshot; not a native currentness, permission or outcome assertion.
bc:AssessCurrentEligibility — Assess Current Eligibility
Scoped assess current eligibility; not a native currentness, permission or outcome assertion.
bc:AssessDeliveryOutcome — Assess Delivery Outcome
Scoped assess delivery outcome; not a native currentness, permission or outcome assertion.
bc:AverageAcquisitionCostTarget — Average Acquisition Cost Target
Scoped average acquisition cost target; not a native currentness, permission or outcome assertion.
bc:AverageCostConstraint — Average Cost Constraint
Scoped average cost constraint; not a native currentness, permission or outcome assertion.
bc:AverageReturnTarget — Average Return Target
Scoped average return target; not a native currentness, permission or outcome assertion.
bc:BestEffortSpendFloor — Best Effort Spend Floor
Scoped best effort spend floor; not a native currentness, permission or outcome assertion.
bc:BidAmount — Bid Amount
Scoped bid amount; not a native currentness, permission or outcome assertion.
bc:BiddingAssessment — Bidding Assessment
Scoped parameter meaning with independent qualification axes.
bc:CallerDeclaredNativeFacts — Caller Declared Native Facts
Scoped caller declared native facts; not a native currentness, permission or outcome assertion.
bc:CaptureAfterAsOf — Capture After As Of
Scoped capture after as of; not a native currentness, permission or outcome assertion.
bc:CaptureUnqualified — Capture Unqualified
Scoped capture unqualified; not a native currentness, permission or outcome assertion.
bc:CapturedComparisonUnqualified — Captured Comparison Unqualified
Scoped captured comparison unqualified; not a native currentness, permission or outcome assertion.
bc:CapturedDeclarationOnly — Captured Declaration Only
Scoped captured declaration only; not a native currentness, permission or outcome assertion.
bc:CapturedParameterComparison — Captured Parameter Comparison
Scoped captured parameter comparison; not a native currentness, permission or outcome assertion.
bc:CapturedParameterMeaning — Captured Parameter Meaning
Scoped captured parameter meaning; not a native currentness, permission or outcome assertion.
bc:CompareCapturedParameters — Compare Captured Parameters
Scoped compare captured parameters; not a native currentness, permission or outcome assertion.
bc:ComparisonScopeUnqualified — Comparison Scope Unqualified
Scoped comparison scope unqualified; not a native currentness, permission or outcome assertion.
bc:ConflictingRetainedDocumentation — Conflicting Retained Documentation
Scoped conflicting retained documentation; not a native currentness, permission or outcome assertion.
bc:ConstraintMeaningUnqualified — Constraint Meaning Unqualified
Scoped constraint meaning unqualified; not a native currentness, permission or outcome assertion.
bc:ConstraintQualified — Constraint Qualified
Scoped constraint qualified; not a native currentness, permission or outcome assertion.
bc:ConstraintRoleMismatch — Constraint role mismatch
Captured values describe different constraints; no comparative ordering is qualified.
bc:ConstraintUnqualified — Constraint Unqualified
Scoped constraint unqualified; not a native currentness, permission or outcome assertion.
bc:CurrencyMismatch — Currency Mismatch
Scoped currency mismatch; not a native currentness, permission or outcome assertion.
bc:CurrencyScopeUnqualified — Currency scope unqualified
Expected parameter currency contradicts independently retained source currency.
bc:CurrentDocumentationApplicabilityUnassessed — Current Documentation Applicability Unassessed
Scoped current documentation applicability unassessed; not a native currentness, permission or outcome assertion.
bc:Daily — Daily
Scoped daily; not a native currentness, permission or outcome assertion.
bc:DeclaredChangeAuthorized — Declared change authorized
Caller assertion only; this service does not establish native authorization.
bc:DeclaredComparableCapturedParameters — Declared Comparable Captured Parameters
Scoped declared comparable captured parameters; not a native currentness, permission or outcome assertion.
bc:DeclaredOverviewUnit — Declared Overview Unit
Scoped declared overview unit; not a native currentness, permission or outcome assertion.
bc:DeclaredOwnerScope — Declared Owner Scope
Scoped declared owner scope; not a native currentness, permission or outcome assertion.
bc:DeliveryUnassessed — Delivery Unassessed
Scoped delivery unassessed; not a native currentness, permission or outcome assertion.
bc:DocumentationApplicabilityUnassessed — Documentation Applicability Unassessed
Scoped documentation applicability unassessed; not a native currentness, permission or outcome assertion.
bc:DocumentationEvidence — Documentation Evidence
Exact retained documentation clauses including conflicting interpretations.
bc:EligibilityUnassessed — Eligibility Unassessed
Scoped eligibility unassessed; not a native currentness, permission or outcome assertion.
bc:Equal — Equal
Selected captured parameter amount equals the peer amount under the same qualified constraint, currency and event unit.
bc:EventDenominatorMismatch — Event Denominator Mismatch
Scoped event denominator mismatch; not a native currentness, permission or outcome assertion.
bc:EventDenominatorUnqualified — Event Denominator Unqualified
Scoped event denominator unqualified; not a native currentness, permission or outcome assertion.
bc:EventUnitUnqualified — Event Unit Unqualified
Scoped event unit unqualified; not a native currentness, permission or outcome assertion.
bc:EvidenceTerm — Evidence Term
Bounded operation, constraint or qualification term.
bc:ExactSuppliedDecimal — Exact supplied decimal
Explicit exact origin, never inferred from native floating point casting.
bc:ExactSuppliedInteger — Exact Supplied Integer
Scoped exact supplied integer; not a native currentness, permission or outcome assertion.
bc:GoogleMicrosEncoding — GoogleMicrosEncoding
Retained exact encoding or strategy-currency evidence; current applicability remains unassessed.
bc:GooglePortfolioDeclaredCurrency — GooglePortfolioDeclaredCurrency
Retained exact contiguous clause; current applicability remains unassessed.
bc:GooglePortfolioEffectiveCurrency — GooglePortfolioEffectiveCurrency
Retained exact contiguous clause; current applicability remains unassessed.
bc:GoogleTargetCpa — GoogleTargetCpa
Retained applicable clause; current applicability remains unassessed.
bc:GoogleTargetRoas — GoogleTargetRoas
Retained applicable clause; current applicability remains unassessed.
bc:Greater — Greater
Selected captured parameter amount is greater than the peer amount under the same qualified constraint, currency and event unit.
bc:HardSpendCeiling — Hard Spend Ceiling
Scoped hard spend ceiling; not a native currentness, permission or outcome assertion.
bc:Impression — Impression
Scoped impression; not a native currentness, permission or outcome assertion.
bc:InspectCapturedParameter — Inspect Captured Parameter
Scoped inspect captured parameter; not a native currentness, permission or outcome assertion.
bc:Known — Known
Scoped known; not a native currentness, permission or outcome assertion.
bc:Less — Less
Scoped less; not a native currentness, permission or outcome assertion.
bc:Lifetime — Lifetime
Scoped lifetime; not a native currentness, permission or outcome assertion.
bc:MaximumBid — Maximum Bid
Scoped maximum bid; not a native currentness, permission or outcome assertion.
bc:MetaCostCapMeaning — MetaCostCapMeaning
Retained exact contiguous clause; current applicability remains unassessed.
bc:MetaMinimumSpend — MetaMinimumSpend
Retained applicable clause; current applicability remains unassessed.
bc:MetaRoasScale — MetaRoasScale
Retained applicable clause; current applicability remains unassessed.
bc:MetaSpendCap — MetaSpendCap
Retained applicable clause; current applicability remains unassessed.
bc:MicrosoftTargetCpa — MicrosoftTargetCpa
Retained applicable clause; current applicability remains unassessed.
bc:MicrosoftTargetRoas — MicrosoftTargetRoas
Retained applicable clause; current applicability remains unassessed.
bc:MinimumReturnRatio — Minimum Return Ratio
Scoped minimum return ratio; not a native currentness, permission or outcome assertion.
bc:MinimumSpendTarget — Minimum Spend Target
Scoped minimum spend target; not a native currentness, permission or outcome assertion.
bc:MonetaryEncodingUnqualified — Monetary Encoding Unqualified
Scoped monetary encoding unqualified; not a native currentness, permission or outcome assertion.
bc:NativeCurrentMeaning — Native Current Meaning
Scoped native current meaning; not a native currentness, permission or outcome assertion.
bc:NativeFloatOriginUnqualified — Native Float Origin Unqualified
Scoped native float origin unqualified; not a native currentness, permission or outcome assertion.
bc:NotRequested — Not Requested
Scoped not requested; not a native currentness, permission or outcome assertion.
bc:NumericOriginUnqualified — Numeric Origin Unqualified
Scoped numeric origin unqualified; not a native currentness, permission or outcome assertion.
bc:OperationQualification — Operation Qualification
Scoped operation qualification; not a native currentness, permission or outcome assertion.
bc:OverviewAppInstallExample — OverviewAppInstallExample
Retained applicable clause; current applicability remains unassessed.
bc:OverviewBidDefinition — OverviewBidDefinition
Retained applicable clause; current applicability remains unassessed.
bc:OverviewReachExample — OverviewReachExample
Retained applicable clause; current applicability remains unassessed.
bc:OverviewUnitDefinition — OverviewUnitDefinition
Retained applicable clause; current applicability remains unassessed.
bc:OwnerScopeUnqualified — Owner Scope Unqualified
Scoped owner scope unqualified; not a native currentness, permission or outcome assertion.
bc:ParameterValueUnqualified — Parameter Value Unqualified
Scoped parameter value unqualified; not a native currentness, permission or outcome assertion.
bc:Reach — Reach
Scoped reach; not a native currentness, permission or outcome assertion.
bc:ReferenceBidAmount — ReferenceBidAmount
Retained applicable clause; current applicability remains unassessed.
bc:RetainedBiddingOverview — Retained Bidding Overview
Scoped retained bidding overview; not a native currentness, permission or outcome assertion.
bc:RetainedCurrencyEncoding — Retained Currency Encoding
Scoped retained currency encoding; not a native currentness, permission or outcome assertion.
bc:RetainedDocumentationConsistent — Retained Documentation Consistent
Scoped retained documentation consistent; not a native currentness, permission or outcome assertion.
bc:ReviewProposedChange — Review Proposed Change
Scoped review proposed change; not a native currentness, permission or outcome assertion.
bc:RoasFloor — Roas Floor
Scoped roas floor; not a native currentness, permission or outcome assertion.
bc:ScopedBiddingEvidence — Scoped Bidding Evidence
Neutral evidence domain; no child owner is inferred as a campaign.
bc:SelectedOwnerMissing — Selected Owner Missing
Scoped selected owner missing; not a native currentness, permission or outcome assertion.
bc:SelectionContext — Selection Context
Explicit selection of captured parameters and interpretation; no permission.
bc:SourceCapture — Source Capture
Caller-declared native owner capture; not authenticated native origin.
bc:SpendCap — Spend Cap
Scoped spend cap; not a native currentness, permission or outcome assertion.
bc:StrategyDeclaration — Strategy Declaration
Scoped strategy declaration; not a native currentness, permission or outcome assertion.
bc:StrategyInheritanceUnqualified — Strategy Inheritance Unqualified
Scoped strategy inheritance unqualified; not a native currentness, permission or outcome assertion.
bc:StrategyReported — Strategy Reported
Scoped strategy reported; not a native currentness, permission or outcome assertion.
bc:StrategyUnqualified — Strategy Unqualified
Scoped strategy unqualified; not a native currentness, permission or outcome assertion.
bc:StrategyUnreported — Strategy Unreported
Scoped strategy unreported; not a native currentness, permission or outcome assertion.
bc:TargetCpa — Target Cpa
Scoped target cpa; not a native currentness, permission or outcome assertion.
bc:TargetRoas — Target Roas
Scoped target roas; not a native currentness, permission or outcome assertion.
bc:Unknown — Unknown
Scoped unknown; not a native currentness, permission or outcome assertion.
bc:UnsupportedParameterOwner — UnsupportedParameterOwner
A supplied native owner class cannot own the selected parameter in this retained profile.
bc:WriteAuthorityUnassessed — Write Authority Unassessed
Scoped write authority unassessed; not a native currentness, permission or outcome assertion.
bc:account — account
Explicit account of retained scoped evidence.
bc:accountKey — account Key
Explicit account key of retained scoped evidence.
bc:amountValue — amount Value
Explicit amount value of retained scoped evidence.
bc:asOf — as Of
Explicit as of of retained scoped evidence.
bc:billingEvent — billing Event
Explicit billing event of retained scoped evidence.
bc:capture — capture
Explicit capture of retained scoped evidence.
bc:captureApplicabilityStanding — capture Applicability Standing
Explicit capture applicability standing of retained scoped evidence.
bc:capturedAccount — captured Account
Explicit captured account of retained scoped evidence.
bc:capturedAccountKey — captured Account Key
Explicit captured account key of retained scoped evidence.
bc:capturedAt — captured At
Explicit captured at of retained scoped evidence.
bc:capturedOwner — captured Owner
Explicit captured owner of retained scoped evidence.
bc:capturedProvider — captured Provider
Explicit captured provider of retained scoped evidence.
bc:clauseDigest — clause Digest
Explicit clause digest of retained scoped evidence.
bc:clauseText — clause Text
Explicit clause text of retained scoped evidence.
bc:comparisonResult — comparison Result
Explicit comparison result of retained scoped evidence.
bc:comparisonStanding — comparison Standing
Explicit comparison standing of retained scoped evidence.
bc:constraintRole — constraint Role
Explicit constraint role of retained scoped evidence.
bc:constraintStanding — constraint Standing
Explicit constraint standing of retained scoped evidence.
bc:context — context
Explicit context of retained scoped evidence.
bc:contextDigest — context Digest
Explicit context digest of retained scoped evidence.
bc:currency — currency
Currency of the selected parameter. In a selection this is an optional consistency constraint; independently retained source currency supplies the operand unit.
bc:defaultBiddingService — default Bidding Service
Explicit default bidding service of retained scoped evidence.
bc:deliveryStanding — delivery Standing
Explicit delivery standing of retained scoped evidence.
bc:documentationApplicabilityStanding — documentation Applicability Standing
Explicit documentation applicability standing of retained scoped evidence.
bc:documentationConsistencyStanding — documentation Consistency Standing
Explicit documentation consistency standing of retained scoped evidence.
bc:documentationEvidence — documentation Evidence
Explicit documentation evidence of retained scoped evidence.
bc:documentationPath — documentation Path
Explicit documentation path of retained scoped evidence.
bc:documentationSourceDigest — documentation Source Digest
Explicit documentation source digest of retained scoped evidence.
bc:eligibilityStanding — eligibility Standing
Explicit eligibility standing of retained scoped evidence.
bc:eventDenominator — event Denominator
Explicit event denominator of retained scoped evidence.
bc:eventKind — event Kind
Explicit event kind of retained scoped evidence.
bc:eventUnitStanding — event Unit Standing
Explicit event unit standing of retained scoped evidence.
bc:evidenceNeeded — evidence Needed
Explicit evidence needed of retained scoped evidence.
bc:interpretationBasis — interpretation Basis
Explicit interpretation basis of retained scoped evidence.
bc:interpretationDigest — interpretation Digest
Explicit interpretation digest of retained scoped evidence.
bc:monetaryEncodingStanding — monetary Encoding Standing
Explicit monetary encoding standing of retained scoped evidence.
bc:nativeStrategy — native Strategy
Explicit native strategy of retained scoped evidence.
bc:nativeValue — native Value
Explicit native value of retained scoped evidence.
bc:numericOriginStanding — numeric Origin Standing
Explicit numeric origin standing of retained scoped evidence.
bc:operation — operation
Explicit operation of retained scoped evidence.
bc:optimizationGoal — optimization Goal
Explicit optimization goal of retained scoped evidence.
bc:owner — owner
Explicit owner of retained scoped evidence.
bc:ownerScopeStanding — owner Scope Standing
Explicit owner scope standing of retained scoped evidence.
bc:parameterKind — parameter Kind
Explicit parameter kind of retained scoped evidence.
bc:peerAccount — peer Account
Explicit peer account of retained scoped evidence.
bc:peerAccountKey — peer Account Key
Explicit peer account key of retained scoped evidence.
bc:peerAmountValue — peer Amount Value
Explicit peer amount value of retained scoped evidence.
bc:peerCapture — peer Capture
Explicit peer capture of retained scoped evidence.
bc:peerConstraintRole — Peer constraint role
Retained selected peer constraint meaning.
bc:peerCurrency — peer Currency
Explicit peer currency of retained scoped evidence.
bc:peerOwner — peer Owner
Explicit peer owner of retained scoped evidence.
bc:period — period
Explicit period of retained scoped evidence.
bc:provider — provider
Explicit provider of retained scoped evidence.
bc:queryPath — query Path
Explicit query path of retained scoped evidence.
bc:ratioDenominator — ratio Denominator
Explicit ratio denominator of retained scoped evidence.
bc:ratioNumerator — ratio Numerator
Explicit ratio numerator of retained scoped evidence.
bc:reader — reader
Explicit reader of retained scoped evidence.
bc:readerName — reader Name
Explicit reader name of retained scoped evidence.
bc:reason — reason
Explicit reason of retained scoped evidence.
bc:sourceDigest — source Digest
Explicit source digest of retained scoped evidence.
bc:sourceStanding — source Standing
Explicit source standing of retained scoped evidence.
bc:status — status
Explicit status of retained scoped evidence.
bc:strategyStanding — strategy Standing
Explicit strategy standing of retained scoped evidence.
bc:writeAuthorityStanding — write Authority Standing
Explicit write authority standing of retained scoped evidence.