> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spendowl.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Measure True ROAS for Apple Search Ads

# Welcome to SpendOwl

SpendOwl connects your Apple Search Ads spend to actual revenue. Get campaign, ad group, and keyword-level ROAS in your dashboard.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running in 2 minutes
  </Card>

  <Card title="SDK Guide" icon="book" href="/sdk/configuration">
    Learn how to use the SDK
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/spendowl">
    Explore the full API
  </Card>

  <Card title="Examples" icon="laptop-code" href="/examples/swiftui">
    See complete code examples
  </Card>
</CardGroup>

## Why SpendOwl?

<AccordionGroup>
  <Accordion title="Attribution Tracking" icon="bullseye">
    Capture campaign, ad group, keyword, and placement data from Apple Search Ads. Know exactly which ads drive your installs.
  </Accordion>

  <Accordion title="Revenue Tracking" icon="dollar-sign">
    Automatic StoreKit 2 purchase observation. Track subscriptions and in-app purchases without extra code.
  </Accordion>

  <Accordion title="Backend-Driven Architecture" icon="server">
    Attribution tokens are processed on SpendOwl servers. When Apple changes their APIs, your app keeps working—no SDK update required.
  </Accordion>

  <Accordion title="Works with RevenueCat/Adapty" icon="plug">
    SpendOwl observes transactions passively. It works alongside other subscription SDKs without conflicts.
  </Accordion>

  <Accordion title="Privacy-First" icon="shield-check">
    No IDFA required. Includes a privacy manifest for App Store compliance.
  </Accordion>
</AccordionGroup>

## How It Works

```mermaid theme={null}
sequenceDiagram
    participant App
    participant SpendOwl SDK
    participant SpendOwl API
    participant Apple

    App->>SpendOwl SDK: configure(apiKey:)
    SpendOwl SDK->>Apple: Get attribution token
    SpendOwl SDK->>SpendOwl API: Send token
    SpendOwl API->>Apple: Resolve attribution
    SpendOwl API-->>SpendOwl SDK: Campaign data
    SpendOwl SDK-->>App: AttributionResult
```

1. **Configure** the SDK with your API key
2. **Attribution** is automatically fetched from Apple
3. **Purchases** are observed via StoreKit 2
4. **ROAS** is calculated server-side and shown in your dashboard

## Requirements

| Requirement | Minimum Version |
| ----------- | --------------- |
| iOS         | 15.0            |
| macOS       | 12.0            |
| Xcode       | 15.0            |
| Swift       | 5.9             |

## Next Steps

<CardGroup cols={2}>
  <Card title="Install the SDK" icon="download" href="/installation">
    Add SpendOwl to your project via SPM
  </Card>

  <Card title="Get Your API Key" icon="key" href="https://spendowl.io/dashboard">
    Sign up and create your first app
  </Card>
</CardGroup>