Account setup

Ads Data Hub account setup overview

To set up an Ads Data Hub account you need to:

  1. Determine the structure of your Ads Data Hub account.
  2. Configure your Google Cloud project(s):
    1. Designate an admin project.
    2. Enable the API on your admin project.
    3. Create a BigQuery dataset.
    4. Permission Ads Data Hub to write to your Google Cloud project.
  3. Provision user access.
  4. Link data to your Ads Data Hub account.

Create your Ads Data Hub account

You can reach out to your Google representative for help with getting access to Ads Data Hub. The Google representative checks and confirms whether you meet the standard criteria, and then initiates a contract agreement. After the contract is signed, you'll receive an email notification to go through the account setup wizard, and can then complete the account creation process.

Structure your Ads Data Hub account

Review the two types of account structures, below. Once you have determined the structure necessary for your organization's needs, communicate this to your Google representative. If you feel that neither accommodates your organization's needs, please consult with your Google representative.

Single-tier account

A single-tier account is an Ads Data Hub account with no sub-accounts. In this type of account structure, ads data is linked directly to your Ads Data Hub account and data access is solely determined by user access roles.

Dual-tier account

If you need your Ads Data Hub account to mimic a complex organizational structure, you may require a dual-tier account. In this type of account structure, your Ads Data Hub account (referred to as a parent account) contains multiple child accounts. Ads data is linked to the child accounts, and user access can be restricted by assigning users to specific child accounts. The parent-child account relationship is immutable, meaning child accounts cannot be moved to another parent account. Each account and child account will require a distinct Google Cloud instance.

The Google Cloud instance must be in the same region as your Ads Data Hub account. All child accounts inherit their region from the Ads Data Hub parent account.

This chart compares the two account structure types:

Single tier Dual tier
Typical use cases Advertisers Agencies
Advertisers with a complex org structure
Example diagram Single tier account structure diagram Dual tier account structure diagram
Data linking
Assumes that the Ads Data Hub account owner is also the ad platform account owner.
Google ad platform accounts are linked directly to your Ads Data Hub account.
Child accounts, representing particular advertisers, are created under your Ads Data Hub account.
Google ad platform accounts are associated to your Ads Data Hub child accounts via **ads data from IDs**. One ad platform ID can be associated to each ads data from ID.
User management
Simple user management.
Users are provisioned directly in your Ads Data Hub account. Users with access to this account could access all of the account's linked ads data.
Granular user management.
Users that are provisioned directly in your Ads Data Hub account could access all of the ads data linked to all of the child accounts.
Users that are provisioned in a given child account could access all of the ads data linked to that child account. They cannot access data from other child accounts.
Cloud requirements
Requires one administrative Cloud project for your Ads Data Hub account.
Requires one administrative Cloud project for your Ads Data Hub account, plus one for each child account.
Data can be imported from multiple cloud regions into the same Ads Data Hub account.
Data joining
Data from different ad platform accounts can be joined in the same query.

Configure your Google Cloud project(s)

Your Google Cloud project contains your Ads Data Hub results and any first-party data that you use to write first-party joins. Additionally, Google Cloud projects are the underlying foundation that billing and the usage of Google Cloud services are built upon.

Learn more about how Ads Data Hub works with BigQuery

Learn how to create a Google Cloud project

Designate an admin project

For administrative purposes, your Ads Data Hub account must be linked to a single, immutable Google Cloud project, known as the "admin project". However, your Ads Data Hub account can also be linked to any number of mutable Google Cloud projects for the purpose of controlling input and output datasets.

You won't be able to designate a different admin project after making your initial selection. Changing which project is your admin project can break your Ads Data Hub account. As such, it's critical that you designate a permanent Google Cloud project as your admin project when setting up your account. Disabling the Ads Data Hub API from your admin project, or deleting your admin project can cause data loss and create issues in accessing your Ads Data Hub account. Additionally, anticipate any upcoming changes in your organization (such as naming conventions) that may require changing your admin project.

You'll receive a notification with troubleshooting steps to resolve the issue if your account needs to be restored due to deletion of the admin project, or if the Ads Data Hub API needs to be re-enabled.

Sample Google Cloud project configurations

Most users can use a single project (the default setup) that handles all functionality. This includes input and output data. This is the recommended setup, as introducing more projects creates additional complexity and overhead. However, if the single project setup won't meet your needs, work with your Google representative to determine what structure will work best.

The default setup, a single project used for all functionality: Single project used for input and output datasets.

Separate input project, admin project for output: Separate projects. One is used for administration and input, the other is used for output.

Enable the API on your admin project

You'll need to enable the Ads Data Hub API on your admin project before creating an Ads Data Hub account.

The user enabling the API should have serviceusage.services.enable permission within the admin project. This could be someone outside of your organization.

Learn how to enable the Ads Data Hub API

Create a BigQuery dataset

BigQuery datasets are where Ads Data Hub results are written, and one of the places where you can further analyze your data.

During account creation, a default dataset is entered into your Ads Data Hub account settings. This dataset is where results are written if you don't specify a dataset during query execution.

The dataset ID consists of your default output project name and dataset name, i.e.: projectName.datasetName.

Learn how to create datasets in BigQuery

Permission the Ads Data Hub account

In order for Ads Data Hub to write results to your Google Cloud project, you need to provide the Ads Data Hub service with "Data Editor" (roles/bigquery.dataEditor) access within your Google Cloud project. This can be done at either the project or dataset level; just make sure that Ads Data Hub has access to the datasets that you want it to write to.

You'll need to add the service account credentials via the Identity and Access Management (IAM) page. You can find service account credentials under Settings > "Details" > "Service account" in your Ads Data Hub account.

Provision user access

Users will need access to both Ads Data Hub and BigQuery. Within Ads Data Hub they'll write and run queries, and within BigQuery they'll work with the results obtained from Ads Data Hub.

Learn more about role-based access in Ads Data Hub Learn more access control in BigQuery

In order to have ads data available for querying in Ads Data Hub you'll need to link from the account associated with the Google ad product used by your team.

Learn more about linking accounts in Ads Data Hub

Account setup wizard

The account setup wizard walks you through the main tasks to complete your account setup. A link to the wizard can be found in your welcome email. The following sections guide you through each step in the wizard.

Add user

To get help from someone else in your organization to complete the process, you can add users at any stage in the process and send them an email with a help request by clicking the Add user icon. When you add a user, you're prompted to input their email address and a note. The user is automatically added as a Superuser to your Ads Data Hub account. Learn more about user roles.

This person must be someone from your organization who can access your Ads Data Hub account once completed. When you click Save, the user receives an email with the note and a link to join this setup process.

Notes:

  • Email addresses must be associated with a valid Google account to be added to an Ads Data Hub account.
  • Users added at this stage are Superusers. Learn more about user roles.
  • Users can be removed once the wizard is complete.

Launch the account setup wizard

This setup process takes you through the three main steps to complete your account:

  • Naming your Ads Data Hub account
  • Designating a Google Cloud project
  • Designating a default BigQuery dataset, where your results get written

You can add a user to assist with completing the wizard or use the Help icon to learn more about the following topics and contact support:

Name your Ads Data Hub account

Assign a name to your Ads Data Hub account. All accounts have a unique 9-digit ID, but this name can help identify the account. The name should be unique and descriptive so new users can identify the account.

For help with this step, or if you encounter an error, visit Account setup overview or add a user to assist.

Designate your admin project

For administrative purposes, your Ads Data Hub account must be linked to a single, unchangeable Google Cloud project, known as the "admin project".

Notes:

  • Contact your Google representative if you require assistance with linking your Google Cloud project.
  • You can't designate a different admin project or update your Cloud region after submitting this initial selection. Because of this, it is critical that you designate a permanent Google Cloud project as your admin project. Learn more.
  • Due to BigQuery data export requirements, you must use a data source that is in the same region as your Ads Data Hub account. Selecting this Google Cloud region indicates that your ads data comes from the same region. Learn more.
  • Choose an available project. This project must be permanent, as it can't be changed once this step is complete. Note that you must have Editor permission on the selected Google Cloud project.
  • Any changes to your Google Cloud project are reflected in your Google Cloud project account.
  • By clicking Next you are agreeing to enable the Ads Data Hub API. You can't change these settings once you proceed to the next step.

For help with this step, or if you encounter an error, add a user to assist or visit the following articles:

Choose a default BigQuery dataset

BigQuery datasets are where Ads Data Hub results are written, and one of the places where you can further analyze your data. In this step you must:

Designate your output dataset: You must have sufficient edit permissions to successfully select an output dataset or you can add a user who is a BigQuery admin user to assist.

Designate your support dataset (optional): To enable advanced troubleshooting from the Ads Data Hub support team, you can set up a support dataset. Learn more.

Notes:

  • To enable Ads Data Hub support team to troubleshoot your query, you'll need to write the output of your query to a new troubleshooting dataset and grant the support team BigQuery Data Viewer (roles/bigquery.dataViewer) access to the dataset. This allows the team to view output of your query, without granting access to any other data in your Google Cloud project. You can revoke access anytime. Learn more.
  • Any changes to your BigQuery project during this step are reflected in your BigQuery project.

For help with this step, or if you encounter an error, add a user to assist or visit the following articles:

Optional: Enable user-provided data matching

In order for user-provided data matching (UPDM) to read and match your first-party data and write results to your Google Cloud project, you need to provide the Ads Data Hub service accounts access to your Google Cloud project. For help with this step, or if you encounter an error, visit the following articles:

After setup is complete

Once you complete the wizard you will receive a message to say that your setup is complete. You must allow one to three days for the full setup to be complete. You will then receive a follow up message letting you know when your account is available. If your setup is pending for more than five business days, or you get a message alerting you to issues with setting up your account, you can contact support. Once setup is complete you can proceed to link accounts to Ads Data Hub .