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

# How to connect

> How to connect the Google Ad Manager data source to Adriel: authorize a Google account, select a network and saved report, and cache the report rows for dashboards.

Google Ad Manager (GAM) is Google's ad-serving and revenue-management platform for publishers. The connector pulls one pre-configured saved report at a time from the Google Ad Manager REST API, polls until the asynchronous report run completes, then caches the resulting rows for dashboard queries.

## Before you connect

The following are required:

* Access to a Google account with permission to view the target Google Ad Manager network and its saved reports.
* At least one saved report configured inside Google Ad Manager that should flow into dashboards. Metrics and breakdowns are determined entirely by the saved report definition — the connector does not impose its own schema.

## Connect Google Ad Manager

<Steps>
  <Step title="Authorize a Google account">
    On the **Data Sources** page, search for **Google Ad Manager** and select it. Click **Sign in with Google** in the pop-up and sign in with the Google account that has access to the target GAM network. Tick every consent checkbox on the Google permissions screen and click **Continue** to authorize the connector. Skipping a checkbox prevents networks and reports from loading.
  </Step>

  <Step title="Select the network and report">
    On the data source settings, fill in the two required fields. For **Network**, select the GAM network whose report should be connected. For **Report**, select one saved report from the chosen network.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The connector triggers an initial report run; depending on report size, completion can take from a few seconds up to roughly twenty minutes, and the first sync may complete within one business day.
  </Step>
</Steps>

## What gets imported

The rows returned by the saved GAM report — at the exact metric and breakdown granularity defined inside GAM — are cached as the data source. Schema changes inside the report, such as added or removed fields, are reflected on the following sync without any reconfiguration. Each report becomes its own data source, so multiple reports require multiple data source connections.

For the complete metric and breakdown model and refresh cadence, see the [Google Ad Manager data reference](/data-sources/g-n/google-ad-manager/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Report failed error during sync">
    The GAM report run completed with an error from Google's side — usually because the report definition references invalid fields, exceeds row limits, or the network changed permissions. Open the report inside Google Ad Manager and verify that it runs successfully there before reconnecting.
  </Accordion>

  <Accordion title="Rate-limit error: you have exceeded your rate limit">
    GAM returned HTTP 429. The sync fails immediately with no automatic retry; the next scheduled sync will retry on its own.
  </Accordion>

  <Accordion title="Report disappeared from the dropdown after working previously">
    The report may have been deleted, or its permissions may have changed in GAM. Verify the report still exists and that the authorized Google account still has access. Reconnect once the report is restored.
  </Accordion>

  <Accordion title="invalid_grant OAuth error">
    The refresh token was revoked — usually because the Google account password changed or access was revoked. The data source is automatically disconnected. Reconnect via **Connections** → **Google Ad Manager** → **Reconnect**.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Google Ad Manager data reference" href="/data-sources/g-n/google-ad-manager/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for Google Ad Manager.
  </Card>

  <Card title="Google Ad Manager FAQs" href="/data-sources/g-n/google-ad-manager/faqs">
    Common questions and expected behaviors for the Google Ad Manager data source.
  </Card>

  <Card title="How to connect Google Ads" href="/data-sources/g-n/google-ads/how-to-connect">
    Connect Google Ads campaign performance data.
  </Card>

  <Card title="How to connect Google Campaign Manager 360" href="/data-sources/g-n/google-campaign-manager-360/how-to-connect">
    Connect Campaign Manager 360 reporting data.
  </Card>
</CardGroup>