Type Alias ReportingRevision

Type Declaration

• reporting_revision_id: string

  Portable AdCP identity for this immutable report publication. Distinct from package delivery_revision_id and provider-native versions.

• revision_content_sha256: string

  SHA-256 of the immutable RFC 8785 JCS binding object containing reporting_revision_id, row_count, control_totals, and reporting_rows. Reliable Reporting 1.0 Core revisions include it and exact reads return the identical value.

• report_definition_id: string

  Identity or canonical fingerprint of immutable metric, grain, attribution, breakdown, action-definition, profile, and calendar/timezone semantics.

• report_definition_uri: string

• report_definition_sha256: string

• reporting_profile: string

• schema_version: string

• schema_uri: string

  Machine-readable schema on the authenticated seller/provider or AdCP-registry origin.

• schema_sha256: string

  Digest of the exact schema bytes used to validate this immutable revision.

• schema_dialect: "https://json-schema.org/draft/2020-12/schema"

  Closed SDK-bundled dialect; the metaschema is never network-fetched.

• schema_ref_policy: "local_fragment_only"

  The fetched schema is self-contained and every $ref is a local # fragment.

• account_id: string

• media_buy_ids: ReportingMediaBuyID[]

  Exact frozen media-buy denominator inherited from the obligation, including buys with zero rows. An empty array proves a zero-buy period rather than an unknown denominator.

• coverage: ReportingCoverage

• period: { start: string; end: string; source_timezone: string }

  Half-open reporting interval with its source calendar boundary.

• finality: ReportingFinality

• Optionalfinality_basis?: "source_final" | "contractual_cutoff" | "stabilized"

  Why an official revision is considered final: an authoritative source signal, a versioned contractual cutoff, or a versioned stabilization rule.

• Optionalfinality_policy_id?: string

  Immutable policy/version reference that defines the selected finality basis. It MUST be bound by report_definition_id.

• Optionalfinalized_at?: string

  When the producer applied the declared finality basis to this official revision.

• observed_at: string

  When the seller obtained or committed this source observation.

• data_through: string | null

  Latest event time conservatively included, or null when precision is unknown.

• data_through_precision: "exact" | "lower_bound" | "unknown"

• Optionalsupersedes_reporting_revision_id?: string

  Immediately superseded snapshot revision of the same logical slice. An official revision is terminal and MUST NOT be named here; later corrections use reporting-adjustment records.

• row_count: number

  Logical row count, including zero for a successfully evaluated empty report.

• control_totals: ReportingControlTotal[]

  Profile-defined totals computed from the canonical logical revision. Names MUST be unique.

• Optionalcanonical_content_digest?: ReportingCanonicalContentDigest

• created_at: string