Transactions

Transactions represent purchase or activity events associated with members. Ingesting transaction data enables spend-based targeting, behavioural analytics, and attribution.

Ingesting Transactions

Send transaction events via the ingest endpoint. Each transaction is associated with a member by reference.
{
  "member_base_id": "base_abc123",
  "transactions": [
    {
      "ref": "user_001",
      "transaction_id": "txn_98765",
      "amount": 49.99,
      "currency": "USD",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ]
}

Use Cases

  • Spend-based targeting: Show offers to members who have spent above a threshold
  • Recency targeting: Target members based on how recently they made a purchase
  • Attribution: Measure which ad impressions led to conversions
  • Loyalty programs: Track qualifying purchases for points or tier progression

Idempotency

Transactions are deduplicated by transaction_id. Sending the same transaction multiple times will not create duplicate records, making it safe to retry failed requests.