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

# Device

> Google Ads performance by device and ad network — the richest breakdown, and the only one with cross-device conversion value and ad-level granularity.

Google Ads performance by device and ad-network type — the broadest metric set, including cross-device conversion value.

## What this data model represents

**Grain:** one row per `date × ad_account × campaign × adset × ad × device × ad_network_type`.

**Metrics, grouped by category** — every number you can compute on this data model. Expand below for examples in each.

```mermaid theme={null}
flowchart LR
    R1["Spend & revenue"]:::cat --- S
    R2["Clicks & impressions"]:::cat --- S
    R3["Cost efficiency"]:::cat --- S

    S(["Metrics"]):::root

    S --- R4[Engagement]:::cat
    S --- R5[Conversion]:::cat
    S --- R6[Video]:::cat

    classDef root fill:#0f172a,color:#f8fafc,stroke:#0f172a,stroke-width:2px
    classDef cat fill:#2563eb,color:#fff,stroke:#1d4ed8,stroke-width:1.5px
```

<Accordion title="Show sample metrics in each category">
  ```mermaid theme={null}
  flowchart LR
    sr1[Ad Spend]:::leaf --- SR["Spend & revenue"]
    sr2[Conversion Value]:::leaf --- SR
    sr3[ROAS]:::leaf --- SR
    sr4[AOV]:::leaf --- SR

    ci1[Clicks]:::leaf --- CI["Clicks & impressions"]
    ci2[Impressions]:::leaf --- CI
    ci3[CTR]:::leaf --- CI

    ce1[CPC]:::leaf --- CE["Cost efficiency"]
    ce2[CPM]:::leaf --- CE
    ce3[CPA]:::leaf --- CE
    ce4[RPC]:::leaf --- CE

    SR:::cat --- S
    CI:::cat --- S
    CE:::cat --- S

    S(["Metrics"]):::root

    S --- En[Engagement]:::cat
    S --- Cv[Conversion]:::cat
    S --- Vd[Video]:::cat

    En --- en1[Engagements]:::leaf
    En --- en2[Interactions]:::leaf

    Cv --- cv1[Conversion Rate]:::leaf
    Cv --- cv2[Cross Device Conversions]:::leaf
    Cv --- cv3[Cross Device Conversion Value]:::leaf

    Vd --- v1[Video Views]:::leaf
    Vd --- v2[Video 100% Watched]:::leaf

    classDef root fill:#0f172a,color:#f8fafc,stroke:#0f172a,stroke-width:2px
    classDef cat fill:#2563eb,color:#fff,stroke:#1d4ed8,stroke-width:1.5px
    classDef leaf fill:#eff6ff,color:#1e3a8a,stroke:#bfdbfe,stroke-width:1px
  ```
</Accordion>

**Dimensions, grouped by category** — every way you can split, filter, or group those metrics. Expand below for examples in each.

```mermaid theme={null}
flowchart LR
    D1["Device & network"]:::cat --- M
    D2[Ad]:::cat --- M

    M(["Dimensions"]):::root

    M --- D3["Campaign hierarchy"]:::cat
    M --- D4[Time]:::cat
    M --- D5["Account & brand"]:::cat
    M --- D6["Creative & platform"]:::cat

    classDef root fill:#0f172a,color:#f8fafc,stroke:#0f172a,stroke-width:2px
    classDef cat fill:#9333ea,color:#fff,stroke:#7e22ce,stroke-width:1.5px
```

<Accordion title="Show sample dimensions in each category">
  ```mermaid theme={null}
  flowchart LR
    dn1[device]:::leaf --- DN["Device & network"]
    dn2[ad_network_type]:::leaf --- DN

    ad1[ad_id]:::leaf --- Ad
    ad2[ad_name]:::leaf --- Ad
    ad3[ad_status]:::leaf --- Ad

    DN:::cat --- M
    Ad:::cat --- M

    M(["Dimensions"]):::root

    M --- CH["Campaign hierarchy"]:::cat
    M --- Ti[Time]:::cat
    M --- AB["Account & brand"]:::cat
    M --- CP["Creative & platform"]:::cat

    CH --- ch1[campaign_id]:::leaf
    CH --- ch2[adset_id]:::leaf
    CH --- ch3[campaign_type]:::leaf

    Ti --- t1[date]:::leaf
    Ti --- t2[week_start_date]:::leaf

    AB --- ab1[ad_account_id]:::leaf
    AB --- ab2[brand]:::leaf

    CP --- cp1[ad_platform]:::leaf
    CP --- cp2[final_url]:::leaf

    classDef root fill:#0f172a,color:#f8fafc,stroke:#0f172a,stroke-width:2px
    classDef cat fill:#9333ea,color:#fff,stroke:#7e22ce,stroke-width:1.5px
    classDef leaf fill:#faf5ff,color:#581c87,stroke:#e9d5ff,stroke-width:1px
  ```
</Accordion>

**Source:** Google Ads API, daily refresh.

<Tip>
  This is the **only** Google Ads data model that exposes `Cross Device Conversion Value`. It's also one of two models with ad-level granularity — the other is [Conversion Action](/data-models/google-ads/conversion-action). Use Device when the question crosses device boundaries; use Conversion Action when you need funnel stages.
</Tip>

## Slice by

Unique to this data model:

| Dimension                         | Type   | Values                                                                                                    |
| --------------------------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| `device`                          | String | `Mobile`, `Desktop`, `Tablet`                                                                             |
| `ad_network_type`                 | String | `Search`, `Mixed`, `YouTube`, `Other`                                                                     |
| `ad_id` / `ad_name` / `ad_status` | String | Individual ad identity — also available on [Conversion Action](/data-models/google-ads/conversion-action) |

Plus the standard campaign hierarchy, time, and account dimensions — documented once on the [Google Ads Overview](/data-models/google-ads/overview).

## Use it to answer

* How does ROAS split across Mobile / Desktop / Tablet — where should budget shift?
* Which network (Search, Display, YouTube, partners) carries the actual conversions?
* How much revenue is being **cross-device-attributed** — am I under-crediting mobile?
* Which individual ad creative wins on each device?

## Available metrics

Everything you can compute on this data model. Need a metric not listed? See the [Google Ads metric availability matrix](/data-models/google-ads/overview#metric-availability-matrix).

| Metric                        | Formula                                                 |
| ----------------------------- | ------------------------------------------------------- |
| **Spend & revenue**           |                                                         |
| Ad Spend                      | Sum of daily spend                                      |
| Conversion Value              | Sum of reported revenue                                 |
| ROAS                          | Conversion Value ÷ Ad Spend                             |
| Conversions                   | Sum of attributed conversion events                     |
| AOV                           | Conversion Value ÷ Conversions                          |
| **Clicks & impressions**      |                                                         |
| Clicks                        | Sum of clicks                                           |
| Impressions                   | Sum of impressions                                      |
| CTR                           | Clicks ÷ Impressions × 100                              |
| **Cost efficiency**           |                                                         |
| CPC                           | Ad Spend ÷ Clicks                                       |
| CPM                           | Ad Spend ÷ Impressions × 1,000                          |
| CPA                           | Ad Spend ÷ Conversions                                  |
| RPC                           | Conversion Value ÷ Clicks                               |
| **Engagement**                |                                                         |
| Engagements                   | Sum                                                     |
| Interactions                  | Sum                                                     |
| CPE                           | Ad Spend ÷ Engagements                                  |
| CPI                           | Ad Spend ÷ Interactions                                 |
| **Conversion**                |                                                         |
| Conversion Rate               | Conversions ÷ Clicks × 100                              |
| View Through Conversions      | Sum of conversions from impressions without clicks      |
| Cross Device Conversions      | Sum of conversions on a different device from the click |
| Cross Device Conversion Value | Sum of revenue from cross-device conversions            |
| **Video**                     |                                                         |
| Video Views                   | Sum                                                     |
| Video 25% Watched             | Sum                                                     |
| Video 50% Watched             | Sum                                                     |
| Video 75% Watched             | Sum                                                     |
| Video 100% Watched            | Sum                                                     |

<Accordion title="Raw fields (for custom calculations)">
  `ad_spend` · `conversion_value` · `conversions` · `clicks` · `impressions` · `engagements` · `interactions` · `view_through_conversions` · `cross_device_conversions` · `cross_device_conversion_value` · `video_views` · `video_25_watched` · `video_50_watched` · `video_75_watched` · `video_100_watched`
</Accordion>
