Google Ad Manager Reader
Note
This adapter is in preview and is available on Striim Developer only. See Striim Developer for more information.
Striim’s Google Ad Manager Reader extracts data from Google Ad Manager into other enterprise applications or data warehouses, allowing teams to combine ad performance data with other business-critical information (like sales data, user behavior data, etc.).
Feature summary
Feature | Supported? | Notes | |
---|---|---|---|
Objects | Standard objects | ✓ | |
Custom objects | ✓ | ||
Authentication | Basic authentication | Username and password | |
OAuth authentication | ✓ | Manual configuration based | |
Custom authentication methods | Not all methods may be supported | ||
Operations | Automated mode | ✓ | |
Initial load | ✓ | ||
Pull-based incremental load | ✓ | ||
Push-based incremental load | |||
Automated pipeline | |||
Governance | Connection profile | ||
Sherlock AI | |||
Sentinel AI | |||
Schema handling | Initial schema creation | ✓ | Works with supported targets |
Schema evolution | |||
Setup | Wizard template | ||
Flow Designer | ✓ | ||
Striim TQL | ✓ | ||
Runtime | Resilience/recovery | ✓ | |
Parallel execution | |||
Metrics | ✓ | Standard metrics |
Supported authentication method
The Google Ad Manager Reader supports OAuth authentication. Creating a connection requires creating a custom service in Google, obtaining OAuth credentials, obtaining an authorization code and exchanging it for an access token and a refresh token, and setting the connection properties in Striim.
To configure OAuth authentication for Google Ad Manager:
Go to the Google OAuth 2.0 Playground.
Click on the gear icon in the top right corner of the OAuth 2.0 Playground.
Check Use your own OAuth credentials and input your Client ID and Client Secret.
In the list of available APIs, find the Google Ad Manager API and select the scope you need (for example, https://www.googleapis.com/auth/dfp for Google Ad Manager). Click Authorize APIs.
A Google authentication page will open. Log in with your Google account and authorize the app to access your Ad Manager account.
After authorization, you will be redirected to the OAuth 2.0 Playground with an authorization code.
In the OAuth 2.0 Playground, click Exchange authorization code for tokens. You will receive an access token and a refresh token. The access token is valid for a limited period (usually 1 hour), while the refresh token can be used to get a new access token when it expires.
Store the access token and refresh token securely. You'll use the access token for API requests, and the refresh token will allow you to get new access tokens without re-authorizing the user.
Supported objects
The following are the supported objects for reading from Google Ad Manager:
Companies
Contacts
Creatives
CustomFields
CustomTargetingKeys
CustomTargetingValues
DeliveryReport
Inventories
InventoryReport
Labels
LineItemCreativeAssociations
LineItems
MobileApplications
Orders
Placements
ProposalLineItems
Proposals
Roles
SalesReport
Users
Google Ad Manager Reader properties
Property | Type | Default value | Notes |
---|---|---|---|
Access token | Password | The access token used for OAuth authentication. | |
Refresh token | Password | The OAuth refresh token for the corresponding OAuth access token. | |
Client ID | String | Client ID of the private app registered in Google. | |
Client secret | Password | Client secret of the private app registered in Google. | |
Connection pool size | Integer | 20 | Specifies the maximum number of active connections. |
Exclude tables | String | A list of tables excluded from read operations. Typically used to create a list of exceptions when the Tables property includes wildcards. Misconfiguration of the Tables and Exclude Tables properties can cause "Invalid table names" errors. | |
Incremental load marker | String | The incremental load marker is a unique incremental column in each object used for incremental load. When no marker is specified, tables are resynced at each polling interval. Specify the name of the column that contains the start position value. This column must meet the following criteria:
| |
Migrate schema | Boolean | False | Only available in Initial Load or Automated mode. Set to |
Mode | Select list:
| Automated | Automated mode applies incremental updates to objects that support incremental load and performs full resyncs for objects that do not support incremental load. |
Polling interval | Integer | 5m | Specifies an interval as an integer followed by a unit. Supported units are days ( |
Refresh token | Password | An OAuth 2.0 refresh token.Use the value generated while creating the token. | |
Start Position | String | %=-1 | Value of the incremental load marker that defines the initial reading position. |
Tables | String | A semicolon-delimited (;) list of objects to read from the source. Supports the | |
Thread pool count | Integer | 10 | The number of parallel running threads. The default value of zero specifies single-threaded operation. When the value of the thread pool counter is higher than the connection pool size, large data ingestion operations can cause the app to halt. Since best performance is achieved when using one thread for each table being synced, increasing the size of the connection pool to match the number of threads in use is a performance best practice. |