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

  1. What is the reported credited-value to same-scope spend ratio?
  2. Which selected purchase links contribute to the known charged-order subtotal?
  3. Which missing or unsupported evidence prevents an acquisition or profit conclusion?

Namespace

https://ontology.inferal.com/modules/ads-commerce-outcome-evidence/

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
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.

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.
aoc:AttributionEquivalenceUnassessed — AttributionEquivalenceUnassessed
AttributionEquivalenceUnassessed denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:CallerDeclaredSharedFacts — CallerDeclaredSharedFacts
CallerDeclaredSharedFacts denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ClassificationQualified — ClassificationQualified
ClassificationQualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ClassificationUnqualified — ClassificationUnqualified
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.
aoc:DeclaredLinkedChargedOrderReturn — DeclaredLinkedChargedOrderReturn
DeclaredLinkedChargedOrderReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DeclaredLinkedChargedReturn — DeclaredLinkedChargedReturn
DeclaredLinkedChargedReturn denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DeclaredLinkedNewPurchaseCost — DeclaredLinkedNewPurchaseCost
DeclaredLinkedNewPurchaseCost denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DeclaredLinkedNewPurchaseCostBasis — DeclaredLinkedNewPurchaseCostBasis
DeclaredLinkedNewPurchaseCostBasis denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DeclaredPurchaseBinding — DeclaredPurchaseBinding
Caller-declared event/aggregate candidate to scoped named purchase binding; this is not independently verified acquisition.
aoc:DeclaredRetainedObservationScope — DeclaredRetainedObservationScope
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.
aoc:DenominatorUnqualified — DenominatorUnqualified
DenominatorUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:DistinctReachNotAdditive — DistinctReachNotAdditive
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.
aoc:ExactRetainedNativeRowScope — ExactRetainedNativeRowScope
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.
aoc:FigureFieldsUnqualified — FigureFieldsUnqualified
FigureFieldsUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:HistoricalSelectedCapture — HistoricalSelectedCapture
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.
aoc:MixedPurchaseClassificationBasis — MixedPurchaseClassificationBasis
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.
aoc:NewPurchaseDenominatorUnqualified — NewPurchaseDenominatorUnqualified
NewPurchaseDenominatorUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:NonAdditiveSelectedScope — NonAdditiveSelectedScope
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.
aoc:OperationQualification — OperationQualification
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.
aoc:PurchaseIdentityUnqualified — PurchaseIdentityUnqualified
PurchaseIdentityUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:PurchaseLinkUnqualified — PurchaseLinkUnqualified
PurchaseLinkUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:PurchaseSnapshotUnqualified — PurchaseSnapshotUnqualified
PurchaseSnapshotUnqualified denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:ReportingWindowUnqualified — ReportingWindowUnqualified
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.
aoc:ScopedProviderCreditArithmetic — ScopedProviderCreditArithmetic
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.
aoc:SelectedScopeIncomplete — SelectedScopeIncomplete
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.
aoc:SingleSelectedCreditScope — SingleSelectedCreditScope
SingleSelectedCreditScope denotes the bounded operation or evidence standing defined by the versioned outcome service. It grants no native truth or mutation permission.
aoc:SourceSnapshotUnqualified — SourceSnapshotUnqualified
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.
aoc:UnsupportedAcquisitionEvidence — UnsupportedAcquisitionEvidence
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.
aoc:UnsupportedMonetaryBasis — UnsupportedMonetaryBasis
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.
aoc:attributionApplicabilityStanding — attributionApplicabilityStanding
The independently retained attributionApplicability qualification for this selection. Overall success or another failure does not erase this axis.
aoc:attributionStanding — attributionStanding
AttributionEquivalenceUnassessed because no independent applicable equivalence route is admitted.
aoc:bindingSnapshot — bindingSnapshot
A caller-declared binding scope token. Context evidenceSourceDigest independently binds the actual raw source bytes.
aoc:capturedAt — capturedAt
Caller-declared retained delivery instant used to reject ties and newer conflicting/empty/partial captures.
aoc:classification — classification
The exact selected purchase classification named by a declared binding.
aoc:classificationBasis — classificationBasis
The retained purchase evidence basis of a homogeneous known subset; mixed bases stay unbound.
aoc:completeScope — completeScope
Caller declaration that selected scope is complete; it is not native completeness attestation.
aoc:context — context
The caller selection retained for this assessment.
aoc:contextDigest — contextDigest
SHA256 of retained caller context bytes.
aoc:coverageStanding — coverageStanding
CompleteSelectedScope, KnownSubsetCoverage or UnknownSelectedScope for this exact selection.
aoc:currency — currency
Exact source currency of qualified operands; no currency conversion is inferred.
aoc:defaultOutcomeService — defaultOutcomeService
The versioned outcome service explicitly registered for this shared ontology.
aoc:deliveryStanding — deliveryStanding
Caller-declared complete, partial or empty retained capture; it does not attest extraction completeness.
aoc:denominator — denominator
Exact positive qualified arithmetic operand; unqualified or zero denominators produce no ratio.
aoc:denominatorStanding — denominatorStanding
The independently retained denominator qualification for this selection. Overall success or another failure does not erase this axis.
aoc:eventKey — eventKey
Declared source event identity; provider credit identity remains distinct from merchant purchase identity.
aoc:evidenceSourceDigest — evidenceSourceDigest
The caller-declared SHA256 of the complete raw shared source. Drift fails snapshot qualification.
aoc:figure — figure
The exact selected figure named by a declared purchase binding.
aoc:figureFieldsStanding — figureFieldsStanding
The independently retained figureFields qualification for this selection. Overall success or another failure does not erase this axis.
aoc:interpretationDigest — interpretationDigest
SHA256 of retained interpretation byte/mode closure excluding catalogue.
aoc:knownChargedCurrency — knownChargedCurrency
The source currency of knownChargedSubtotal, independently retained when ratio currency is unavailable. Mixed currencies never become one subtotal.
aoc:knownChargedSubtotal — knownChargedSubtotal
Known eligible charged-order subtotal, labelled as complete or a subset and never net revenue or profit.
aoc:knownPurchaseCount — knownPurchaseCount
Number of distinct qualified scoped purchases in the known linked subset; not an acquired customer count.
aoc:merchant — merchant
The exact merchant scope of declared purchase bindings and classifications.
aoc:monetaryBasisStanding — monetaryBasisStanding
The independently retained monetaryBasis qualification for this selection. Overall success or another failure does not erase this axis.
aoc:numerator — numerator
Exact qualified arithmetic operand under this named operation and complete selected scope.
aoc:operation — operation
The selected business operation, with its own numerator and authority boundary.
aoc:order — order
The merchant-scoped named order bound by the source assertion.
aoc:policy — policy
The selected purchase policy; policy equality does not prove connector implementation.
aoc:purchaseClassificationStanding — purchaseClassificationStanding
The independently retained purchaseClassification qualification for this selection. Overall success or another failure does not erase this axis.
aoc:purchaseContext — purchaseContext
The selected PC classification context within one source/context/interpretation/as-of snapshot.
aoc:purchaseContextDigest — purchaseContextDigest
The exact declared PC context snapshot digest selected by the context.
aoc:purchaseInterpretationDigest — purchaseInterpretationDigest
The exact declared PC interpretation snapshot digest selected by the context.
aoc:purchaseKey — purchaseKey
Declared merchant-scoped purchase key; spelling alone never establishes linkage.
aoc:purchaseLinkStanding — purchaseLinkStanding
The independently retained purchaseLink qualification for this selection. Overall success or another failure does not erase this axis.
aoc:purchaseSourceDigest — purchaseSourceDigest
The exact declared PC source snapshot digest selected by the context.
aoc:queryPath — queryPath
The module-local SPARQL or pipeline path retained by the service.
aoc:reader — reader
A registered semantic reader belonging to the versioned service.
aoc:readerName — readerName
The registered semantic reader name used by the public bundle.
aoc:reason — reason
The concrete qualification or refusal reason, retained with every selected assessment.
aoc:reportingWindowStanding — reportingWindowStanding
The independently retained reportingWindow qualification for this selection. Overall success or another failure does not erase this axis.
aoc:retainedRevisionStanding — retainedRevisionStanding
The independently retained retainedRevision qualification for this selection. Overall success or another failure does not erase this axis.
aoc:revisionPolicy — revisionPolicy
HistoricalSelectedCapture or CurrentDeclaredSeries explicitly selects the permitted freshness standing.
aoc:scopeStanding — scopeStanding
ExactRetainedNativeRowScope or DeclaredRetainedObservationScope; source arithmetic never establishes native or cross-row equivalence.
aoc:selectedBinding — selectedBinding
A selected source assertion linking an event/candidate and purchase; it does not prove acquisition.
aoc:selectedBindingCount — selectedBindingCount
The number of explicitly selected binding handles, including unresolved selections.
aoc:selectedFigure — selectedFigure
A selected named ARC candidate, including missing or unresolved handles.
aoc:selectedFigureCount — selectedFigureCount
The number of explicitly selected figure handles, including unresolved selections.
aoc:selectedPurchase — selectedPurchase
A selected named PC classification; selected missing classifications remain in coverage.
aoc:selectedPurchaseCount — selectedPurchaseCount
The number of explicitly selected purchase handles, including unresolved selections.
aoc:seriesKey — seriesKey
Caller-declared retained report series identity; it is not independently verified native revision scope.
aoc:sourceDigest — sourceDigest
SHA256 of retained raw outcome source bytes; a hash is custody, not authority.
aoc:sourceStanding — sourceStanding
CallerDeclaredSharedFacts; supplied reviewed labels never elevate native authority.
aoc:status — status
Known or Unknown for the selected operation, independent of source and attribution authority standing.