GAM connection
Last edited: 2024/11.07
Yieldbird Platform requires API connection with your Google Ad Manager account to properly service all modules. The connection is using a dedicated GAM user: service account that you must setup during the implementation process.
The connection is established automatically when Yieldbird is creating a workspace and adding your GAM network code to it.
Connection status
Connection status can be checked in Global setup > GAM connection. However, if the connection is not working properly you will also see an alert icon next to the name of your workspace and GAM id:
The status of GAM connection is updated automatically every day around midnight CEST.
If you can see that the GAM connection rendered an error, check the error reason provided in the Error box; these are the error reasons provided directly by GAM API, to decipher them please refer to GAM API documentation (link).
The most common reason for a GAM connection malfunction is insufficient permissions granted to Yieldbird’s service account when providing access to your GAM (error reason: PERMISSION_DENIED). In such cases, please make sure that all the required permissions are granted in your GAM.
For other reasons please refer to GAM API documentation on API errors, and if you are not sure what to do, please reach out to your Customer Success Manager directly.
Key values
This panel allows you to manage which key values are automatically created and, if necessary, updated in the connected GAM account.
Each key value can have one of the following statuses:
- Active: The key value has been properly added to GAM and has all necessary values.
- Requires attention: There was a problem when trying to add the key value or update its values.
- Inactive: The key value is not added to GAM and its values are not being updated.
To change the status of the key values go to actions and choose the action you want:
- Activate (available only when status is Inactive)
- Creates the key value in GAM and assigns values.
- Adds the key value to the key value check queue.
- Update values (available when status is Active OR Requires attention)
- Updates the assigned values for the key value.
- Deactivate (available when status is Active OR Requires attention, not available for key value yb_platform)
- Removes the key value from GAM.
- Removes the key value from the key value check queue.
- is created in GAM
- has all the values assigned
Main purposes for GAM API connection
The purposes of using the GAM API depend on the modules you are using:
General:
- reporting for settlements
- creating key values
Prebid Stack:
- reporting
- creating key values / advertiser/ orders / line items / creatives (learn more)
Price Genius:
- reporting & AI data modelling
- automatic price updates
Refresher:
- reporting
- targeting line item names or types
Viewability Tools
- reporting & AI data modelling
Unfilled Recovery
- not used