How to grant access for a service account?
- Create new role for Yieldbird
- Go to Google Ad Manager > Access & authorization > Roles > New role
- Name: Yieldbird (you can name it differently, we just recommend this name for simplicity):
- Access level:
- All default permissions for Trafficker role Start with ‘Copy permissions from role: Trafficker’:
- Add additional permissions within ‘Trafficking and delivery’:
- Approve and reject orders and line items
- Edit ad units, placements and key-values
- Add additional permissions within ‘Manage people’:
- View pricing rules
- Modify pricing rules
- View inventory rules
- Modify inventory rules
Note that if you have GAM Small Business, some of this may not be available. In such case, you can skip the required permission.
Google Ad Manager documentation on user roles & permissions (link)
- Add service account user
- Go to Google Ad Manager > Global settings > Network settings > Add a service account user
- Email: ds-report-api@pythonapi-209309.iam.gserviceaccount.com
- Role: Yieldbird
- If you use TEAMS feature (available in GAM360 only), please enable ds-report-api@pythonapi-209309.iam.gserviceaccount.com to access “All entities”
More about teams:
Providing GAM access for Yieldbird when using GAM Teams
Purposes of requesting particular permissions
Purposes of requesting permissions additional to standard ‘Trafficker’ role:
- Approve and reject orders and line items - required for completing the process of creating delivery items in GAM (for Prebid Stack only, learn more)
- Edit ad units, placements and key-values - required for:
- Creating key values
- Creating a technical Ad Unit to pre-configure GAM Placements (Price Genius only)
- Automating management of Price Genius Unified Pricing Rules (UPRs) (Price Genius only)
- View & Modify Pricing Rules - required to manage Unified Pricing Rules (Price Genius only)
- View & Modify Inventory Rules - required to set up automated Unified Pricing Rules setup verification (Price Genius only)
Purposes of requesting permissions within ‘Trafficker’ role:
Ad Exclusion Rules - needed to verify Demand Providers not allowed on your inventory (Unfilled Recovery only)
Reporting - used for:
- Generating performance reports
- Managing Refresher targeting per Line Item priority or keyword (Refresher only)
- Verifying implementation correctness and troubleshooting
- Modeling parameters for Viewability Tools (Viewability Tools only)
- Modeling optimal pricing by Price Genius (Price Genius only)
Mark that GAM requires the following permissions in order to allow reporting:
- View my orders and line items,
- View creatives,
- View ad units, placements, and labels,
- View mobile apps,
- View companies and contacts.
Without the above permissions you will not be able to grant access to reporting.