Subgraph / Analytics

AdPriva provides two ways to access proof and engagement data:

• Subgraph (GraphQL) → raw, verifiable proof data for maximum transparency and custom queries.
• Analytics API (REST) → aggregated insights for fast reporting and business intelligence.

Together, they make engagement data fully auditable, from raw cryptographic proofs to aggregated summaries.

Subgraph (GraphQL)

AdPriva events are indexed into a Subgraph, making proofs, engagement events and snapshots queryable with standard GraphQL.

• Endpoint → https://subgraph.adpriva.com/graphql
• Data Types → Proofs (Consent Receipts, Bounded-Use Proofs, Engagement Proofs), engagement events, snapshots
• Use Cases → build custom dashboards, monitor fraud, run compliance checks

Example Queries

1. Fetch All Proofs for a Site

{
  proofs(where: { siteId: "acme-blog" }) {
    id
    type
    valid
    timestamp
    publisher { id }
    anchorRef
  }
}

2. Get Daily Metrics

{
  dailyMetrics(where: { date: "2025-09-24" }) {
    date
    views
    clicks
    conversions
  }
}

3. Snapshot Verification

{
  snapshots(where: { date: "2025-09-24" }) {
    date
    merkleRoot
    anchorTx
    explorerUrl
  }
}

4. Fraud Monitoring Example

{
  proofs(where: { siteId: "acme-blog", valid: false }) {
    id
    type
    timestamp
    publisher { id }
  }
}

Analytics API (REST)

The Analytics API delivers pre-aggregated insights, optimized for fast dashboards and BI tools.

• Base URL → https://api.adpriva.com/v1/analytics
• Authentication → Authorization: Bearer YOUR_API_KEY

Example: Site Analytics

Request:

GET /analytics/sites/SITE_12345

Response:

{
  "site_id": "SITE_12345",
  "views": {
    "valid": 118000,
    "invalid": 2000
  },
  "clicks": {
    "valid": 3400,
    "invalid": 87
  },
  "conversions": {
    "valid": 245,
    "invalid": 12
  }
}

Why Subgraph & Analytics Matter

• Transparency → Subgraph exposes raw proof data, verifiable in the Explorer.
• Efficiency → Analytics API gives quick summaries without heavy queries.
• Flexibility → Developers can build dashboards or plug into BI systems.
• Auditability → Regulators, auditors and enterprise compliance teams can independently verify engagement data.

With Subgraph + Analytics, AdPriva isn’t just proof-backed, it’s data-accessible, ensuring trust, scalability and transparency for every stakeholder.

{% @mermaid/diagram content="flowchart TD
A\[Events: page views, clicks, conversions]
B\[Proof Engine: cryptographic proofs]
C\[AdPriva Explorer: public verification]
D\[Subgraph: GraphQL raw data]
E\[Analytics API: REST aggregated insights]
F\[Dashboards and BI Tools]
G\[Auditors and Regulators]

A --> B
B --> C
B --> D
B --> E
D --> F
E --> F
D --> G
C --> G" %}