This module evaluates selected advertising figures and declared purchase classifications. It retains exact ratio operands, operation, report scope, selected handles, purchase subtotal and count, coverage, and source/context/interpretation digests. Every admitted shared fact has CallerDeclaredSharedFacts standing. A supplied Qualified or Reviewed label does not authenticate a native fact.
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 evaluates selected advertising figures and declared purchase classifications. It retains exact ratio operands, operation, report scope, selected handles, purchase subtotal and count, coverage, and source/context/interpretation digests. Every admitted shared fact has CallerDeclaredSharedFacts standing. A supplied Qualified or Reviewed label does not authenticate a native fact.
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
What is the reported credited-value to same-scope spend ratio?
Which selected purchase links contribute to the known charged-order subtotal?
Which missing or unsupported evidence prevents an acquisition or profit conclusion?
The prefix aoc 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 chooses reporting figures and a purchase-classification snapshot. OutcomeAssessment preserves unknown selections alongside known subsets. DeclaredPurchaseBinding scopes event keys by provider, merchant, policy and token. Reported credited value over same-row spend is source arithmetic; linked charged-order return and new-purchase cost keep their separate merchant policy and classification basis. One named scoped order is deduplicated within one declared snapshot.
Independent evidence axes
Evidence
What the consumer can conclude
Retained source
The selected bytes and represented claims remain inspectable.
Scoped interpretation
The named contract supplies a result with its own qualification and coverage.
Current action authority
Live permission, native applicability and client adoption require separately qualified evidence.
Raw source/context roles require a declared absolute RDF origin and complete retained byte custody. evidenceSourceDigest must equal the complete raw source SHA256. Every spend-pairing scope scalar must agree; equal date and currency are insufficient. HistoricalSelectedCapture permits explicit historical selection, while CurrentDeclaredSeries requires a latest retained declaration. A newer partial or missing capture cannot disappear behind a favorable earlier figure.
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
Version 1 does not pool standard/all, channel/omni, lookback, aggregate/breakdown, reach or capture revisions. Comparisons keep AttributionEquivalenceUnassessed. CAC reports UnsupportedAcquisitionEvidence and net/profit operations report UnsupportedMonetaryBasis. Unknown links or charges cannot make a known subset a full denominator. Exact decimal/integer support is bounded to 128 digits and scale 64, with timestamp precision 6; binary float, negative-money and rate-kind bases stay unsupported for these operations. Exact operands do not promise an exact nonterminating quotient.
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 declaration selects retained figures and purchase bindings for one outcome operation. It illustrates the evidence roles supplied by a caller; a merchant policy label and join declaration do not establish acquired-by-this-ad causality or native attribution equivalence.
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.
aoc:AggregateCredits — AggregateCredits
AggregateCredits denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
AttributionEquivalenceUnassessed denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
CallerDeclaredSharedFacts denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
ClassificationQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
ClassificationUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CompareCredits — CompareCredits
CompareCredits denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CompleteDelivery — CompleteDelivery
CompleteDelivery denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CompleteSelectedScope — CompleteSelectedScope
CompleteSelectedScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CurrencyMismatch — CurrencyMismatch
CurrencyMismatch denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CurrentDeclaredSeries — CurrentDeclaredSeries
CurrentDeclaredSeries denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DeclaredLinkedChargedOrderReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DeclaredLinkedChargedReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DeclaredLinkedNewPurchaseCost denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DeclaredLinkedNewPurchaseCostBasis denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DeclaredRetainedObservationScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DenominatorQualified — DenominatorQualified
DenominatorQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DenominatorUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
DistinctReachNotAdditive denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:EmptyDelivery — EmptyDelivery
EmptyDelivery denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:EvidenceTerm — Outcome evidence term
A named operation or diagnostic standing. These concepts are not acquisition or attribution attestations.
ExactRetainedNativeRowScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:FieldsQualified — FieldsQualified
FieldsQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:FieldsUnqualified — FieldsUnqualified
FieldsUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
FigureFieldsUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
HistoricalSelectedCapture denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:InspectFigures — InspectFigures
InspectFigures denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:Known — Known
Known denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:KnownSubsetCoverage — KnownSubsetCoverage
KnownSubsetCoverage denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:LinksQualified — LinksQualified
LinksQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:LinksUnqualified — LinksUnqualified
LinksUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
MixedPurchaseClassificationBasis denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:MoneyBasisQualified — MoneyBasisQualified
MoneyBasisQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:MoneyBasisUnqualified — MoneyBasisUnqualified
MoneyBasisUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:NetRevenueReturn — NetRevenueReturn
NetRevenueReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:NewCustomerCAC — NewCustomerCAC
NewCustomerCAC denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
NewPurchaseDenominatorUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
NonAdditiveSelectedScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:NotRequested — NotRequested
NotRequested denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
OperationQualification denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:OutcomeAssessment — OutcomeAssessment
One assessment for each selected context, including empty and unsupported selections.
aoc:PartialDelivery — PartialDelivery
PartialDelivery denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ProfitReturn — ProfitReturn
ProfitReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ProviderCreditedROAS — ProviderCreditedROAS
ProviderCreditedROAS denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
PurchaseIdentityUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
PurchaseLinkUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
PurchaseSnapshotUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
ReportingWindowUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:RevisionQualified — RevisionQualified
RevisionQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:RevisionUnqualified — RevisionUnqualified
RevisionUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ScopedOutcomeEvidence — ScopedOutcomeEvidence
Neutral evidence domain for source bindings, selections and generated assessments.
ScopedProviderCreditArithmetic denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ScopedProviderFigure — ScopedProviderFigure
ScopedProviderFigure denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:SelectedFigureMissing — SelectedFigureMissing
SelectedFigureMissing denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
SelectedScopeIncomplete denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:SelectionContext — SelectionContext
Caller declaration of one operation, complete selected scope and retained snapshot/revision policy.
SingleSelectedCreditScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
SourceSnapshotUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:SpendScopeUnqualified — SpendScopeUnqualified
SpendScopeUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:Unknown — Unknown
Unknown denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:UnknownSelectedScope — UnknownSelectedScope
UnknownSelectedScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
UnsupportedAcquisitionEvidence denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:UnsupportedMetricKind — UnsupportedMetricKind
UnsupportedMetricKind denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
UnsupportedMonetaryBasis denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:WindowQualified — WindowQualified
WindowQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:WindowUnqualified — WindowUnqualified
WindowUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ZeroDenominator — ZeroDenominator
ZeroDenominator denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ZeroSpendDenominator — ZeroSpendDenominator
ZeroSpendDenominator denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:asOf — asOf
The selected purchase snapshot instant, compared with timezone-qualified temporal evidence.