This Python-based line item generator for Prebid.js, OpenWrap, and Google Ad Manager, automates setup for new header bidding partners.

Note: Doubleclick for Publishers (DFP) is now called, Google Ad Manager (GAM). If this repository refers to DFP, consider it equal to, GAM.

When your ad ops team sets up Prebid/OpenWrap, they often must create hundreds of line items in GAM. Using this tool, your team can now define the settings for:

• Advertiser.
• Placements or ad units.
• Prebid/OpenWrap.

The Line Item Tool then uses those definitions to:

• Create an order with one line item per price level.
• Attach creatives.
• Set placement and/or ad units.
• Set Prebid/OpenWrap key-value targeting.

Note: While this tool covers typical use cases, it may not fit your needs. Review the Limitations before you begin.

You'll need the following to use the Line Item Tool:

• Python version >= 3.6 and a basic knowledge of Python.
• Access to create a service account in the Google Developers Console.
• Admin access to your Google Ad Manager account.

The Line Item Tool requires valid GAM credentials to access your  account. The steps below summarize the steps from the GAM docs and the Google Ads Python libary auth guide.

1. If you haven't done so already, sign up for a GAM account.
2. Create Google developer credentials:
   • Go to the Google Developers Console Credentials page.
   • On the Credentials page, select Create credentials, then select Service account key.
   • Select New service account, then select JSON key type. You can leave the role blank.
   • Use Create to download a file containing a .json private key.
3. Turn on API access to GAM:
   • Sign into your GAM account—you must have admin rights.
   • In the Admin section, select Global settings.
   • Turn on API access if it isn't already enabled.
   • Press the Add a service account user button.
     • Use the service account email for the Google developer credentials you created in step 2.
     • Set the role to, Administrator.
     • Select Save.

• Python version 3.6 or higher.
• Python command line package installer, pip.

1. Clone this repository.
2. Install Python dependencies by running:

   pip install -r requirements.txt

3. Rename key:
   • Rename the Google credentials key you downloaded in step 2 above ([something].json), to key.json.
   • Now move it to the root of this repository.
4. Make a copy of googleads.example.yaml and rename it, googleads.yaml.
5. In googleads.yaml, set these required fields:
   • application_name - the Google project you named while creating GAM credentials above. It should appear in the top-left of the credentials page.
   • network_code - your GAM network number. For example, in https://admanager.google.com/12398712#delivery, the network code is 12398712.

To test your set up, from the top-level directory run:

python -m dfp.get_orders

If successful, it returns all the orders in your GAM account.

Refer this link for Adpod setup

1. Change the following mandatory settings in settings.py:

2. Then, from the root of the repository, run:

   python -m tasks.add_new_openwrap_partner

3. Review your order, line items, and creatives for correctness.
4. Finally, approve the order in GAM.
5. To run the unit test, run:

   python -m unittest -v tests.test_add_new_openwrap_partner

Note: GAM may warn, "Needs creatives," on the order for ~15 minutes after order creation. This warning is usually incorrect and disappears on its own.

1. Change the following mandatory settings in settings.py:

2. Next, from the root of the repository, run:

   python -m tasks.add_new_prebid_partner

3. Finally, review your order, line items, and creatives to make sure they are correct. Then, approve the order in GAM.

Note: GAM may warn, "Needs creatives" on the order for ~15 minutes after order creation. The warning is usually incorrect and disappears on its own.

In most cases, you won't need to change these settings.

• Line Item Tool does not change existing orders or line items, it only creates them. If you need to make a change to an order, it's easiest to archive the existing order and recreate it. But you can add new line items in the existing order using the setting DFP_USE_EXISTING_ORDER_IF_EXISTS. See Extra Settings above.