Create and use a custom bidding script

Create your script

Note: If you have partner-level access, you can create the script at either the partner or advertiser level, allowing the algorithm to be shared with multiple advertisers. If you only have advertiser access, you can only create scripts at the advertiser level. The corresponding algorithm will only be associated with the algorithm it's created in. 
  1. Navigate to your Partner or Advertiser and then Custom Bidding in the left menu.
  2. Click New algorithm to create a new algorithm for your script.
  3. Enter the name of your algorithm and select an advertiser you want to apply it to.
    1. Then click Create.
  4. Click the algorithm you just created in the table. For example, "My custom bidding algorithm"
  5. Click New script.
  6. Write your script. Learn more about sample custom bidding scripts
    1. Click Check syntax to review syntax issues with your script.

Test your script

  1. Select the advertiser to use the script for.
    1. The advertiser must meet custom bidding data requirements
  2. Choose how impressions are sampled: 
    1. All impressions: Recommended to understand overall expected distribution of impression values.
    2. Only impressions with clicks: Useful if clicks are central to the script.
    3. Only impressions with conversions: Useful if conversions central to the script. This sample includes all conversion events in your advertiser and will be based off the default attribution model.
  3. Review results for a sample of 10,000 impressions, including the:
    1. Number of impressions in the sample.
    2. Percentage of execution errors.
    3. Percentage impressions scored.
    4. Percentage of positive impressions scored.

Finalize your script

  1. Click Create to finish your script.
  2. Your saved script will need to process (up to 20 minutes) before it is available. Once processed, it will appear in the list of scripts.

Get started with a campaign

Your algorithm takes 1-3 days to train after you have saved a script that meets the data requirements. Once your model is ready, you will see Yes next to Is the model ready? in the model's Summary tab.
  1. (Recommended) Set up an A/B experiment. Your custom bidding algorithm can be the experiment that you test against a control. If your custom bidding model isn't ready yet, you can use a placeholder bid strategy and come back later to update.
  2. In the Insertion Order Details tab for each of your custom bidding test insertion orders, you can select: Optimization and then Automate bid & budget at insertion order level and thenCustom bidding and then​​  [your custom bidding algorithm]  
    1. The system will automatically adjust the insertion order's bids for the highest impression value (determined by your algorithm). Spending your full budget will be prioritized.
  3. Alternatively, In the Line Item Details tab for each of your custom bidding test line items, you can select: Bid strategy  and then Automated Bidding and then Custom bidding and then​​ [your custom bidding algorithm]
    1. The system can automatically adjust your line item's bids for: 
      1. The highest impression value (determined by your algorithm). Spending your full budget will be prioritized.
      2. A target value or cost that you set.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center