Subgraph / Analytics

AdPriva provides two ways to access campaign 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 campaign performance fully auditable from cryptographic proofs to payout summaries.

Subgraph (GraphQL)

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

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

Example Queries

1. Fetch All Proofs for a Campaign

{
  proofs(where: { campaignId: "summer-sale-2025" }) {
    id
    type
    valid
    timestamp
    publisher { id }
    anchorRef
  }
}

2. Get Daily Metrics

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

3. Campaign Settlement Overview

{
  campaign(id: "CMP_12345") {
    id
    advertiser { id }
    totalSpend
    validProofs
    invalidProofs
    settlements {
      id
      amount
      recipient
      timestamp
    }
  }
}

4. Snapshot Verification

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

5. Fraud Monitoring Example

{
  proofs(where: { campaignId: "summer-sale-2025", 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: Campaign Analytics

Request:

GET /analytics/campaigns/CMP_12345

Response:

{
  "campaign_id": "CMP_12345",
  "views": {
    "valid": 118000,
    "invalid": 2000
  },
  "clicks": {
    "valid": 3400,
    "invalid": 87
  },
  "conversions": {
    "valid": 245,
    "invalid": 12
  },
  "spend": 5600,
  "payouts": {
    "publishers": 4200,
    "users": 800,
    "adpriva_fee": 600
  }
}

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

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\[Ad Events: 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" %}