How to Create and Manage Projects
This guide explains how to create and manage projects within BiddingStack. Use this process to ensure your projects are properly configured, deployed, and ready for placement and bidding integrations.
1. Log in to BiddingStack
Access your BiddingStack account. Ensure you have the necessary permissions to create and manage projects.
2. Navigate to Projects
-
Click “Projects” in the left-hand sidebar.
-
Select “All Projects” to view the list of all existing projects.
-
Click “New Project” in the top-right corner to create a new project.
3. Fill in Project Details
Basic
General project information such as project name, environment, and domain.
| Field | Purpose | Options / Configuration |
|---|---|---|
| Name | Project name for identification and management. | Enter a clear project name. |
| Environment | Defines the environment for the project. | Prod (production use) or Test (for testing and debugging). |
| Enable SPA Support | Enables support for Single Page Applications (SPA) to reload ads on route changes. | Enable if your site uses SPA frameworks. |
| Wait Element Ready | Waits until page elements are fully loaded before initializing ad tags to avoid loading sequence issues. | CSS selector (or multiple selectors separated by commas) that tells the system which page elements to wait for before initializing ads. |
| Enable Amazon Publisher Services | Activates Amazon Publisher Services (APS / TAM) for header bidding. | Enable if you integrate with Amazon APS for bidding. |
| Enable Prebid | Enables Prebid.js client-side header bidding functionality. | Enable if using Prebid.js on your site. |
| Enable Prebid Server | Enables server-side header bidding through Prebid Server. | Enable if adopting a server-side bidding setup. |
| Enable CMP | Enables Consent Management Platform (CMP) to manage GDPR / CCPA compliance and user consent. | Enable if you need to collect user consent for privacy compliance. |
| Load Pubperf | Loads Pubperf analytics script for ad performance monitoring. | Enable if using Pubperf for monitoring. |
| Pubperf ID | Sets your Pubperf account ID to link performance data. | Enter your unique Pubperf ID provided by Pubperf. |
| Website Domain | Defines the full domain of your website. | Enter the domain only without http/https. |
| Type | Selects the project type to load the correct integration configuration. | Web, Mobile, AMP (Google AMP pages), or CTV (Connected TV apps). |
Categories
Select a top-level category and applicable subcategories to define your website’s content type for accurate ad targeting, compliance, and performance reporting.
Bidders
Select demand partners (SSPs/Exchanges) to control which bidders compete for your inventory, helping to optimize revenue and ensure integration accuracy.
Settings
Configure integration options.
| Field | Purpose | Options / Configuration |
|---|---|---|
| Note | Internal note or label to identify the site | Simple text to distinguish different site setups. |
| Currency | Sets the reporting and billing currency for the site. | Select based on your business region from the dropdown list. |
| Additional CSS | Custom CSS code to apply site-specific styles or overrides. | Add custom CSS |
| Additional JavaScript | Custom JavaScript code to run on the site for added functionality or tracking. | Insert custom JS. |
| Only Refresh In View | When enabled, ads refresh only if they are currently visible in the user’s viewport. | Toggle ON to activate, OFF to refresh regardless of viewability. |
| Refresh Rate (ms) | Interval in milliseconds for ad refreshes when enabled. | Define refresh interval. |
| Label of The placeholder | Text label shown in the placeholder area before ads load or if empty. | Set placeholder label. |
| Color of The placeholder | Background color of the placeholder area, often for visual consistency. | Defines background color of the placeholder. |
Advanced Settings
| Field | Purpose | Options / Configuration |
|---|---|---|
| Enable Ad free | Enable an ad-free experience for specific users or subscriptions, disabling ad delivery. | Toggle ON to activate ad-free mode for configured user groups. |
| Enable Floor Price Automation | Automatically adjusts floor prices based on performance data to maximise revenue while maintaining fill rates. | Toggle ON to enable automated floor pricing optimisation. |
| Enable Floor Price A/B Testing (Enable 50% Traffic) | Conduct A/B tests on floor pricing strategies by splitting 50% of traffic for testing. | Toggle ON to run floor price experiments. |
| Bid Timeout (ms) | Sets the maximum time allowed for bidders to respond. | Example: 1200 (timeout in milliseconds, e.g. 1200 ms = 1.2s) |
| Enable Keep Away Rule | Prevent ads from appearing too close together to improve UX and comply with platform policies. | Toggle ON to activate spacing rules between ads. |
| Enable Viewability KVP | Adds key-value pairs for ad viewability targeting and reporting. | Toggle ON to enable. |
| Enable Supply Chain Optimisation | Optimises supply chain object (schain) data for improved transparency and SSP compliance. | Toggle ON to activate supply chain optimisation. |
| Max Bidders Limit | Limits the number of bidders called per impression to control latency and optimise performance. | Example: 5 (limits to 5 bidders) |
| Whitelist Bidders | Specify which bidders are allowed to participate, ensuring only approved demand partners bid. | Select bidders from the dropdown list. |
| Enable Schain | Enables sending supply chain object with bid requests for transparency per ads.txt and sellers.json requirements. | Toggle ON to activate. |
| Schain | Define your Supply Chain Object in JSON format for authorised seller declarations. | Example: {"ver": "1.0", "nodes": [{"hp": 1, "asi": "example.com", "sid": "pub-123456789"}], "complete": 1} |
| Enable Dynamtic In Content Position | Enables dynamic insertion of in-content ads based on content structure. | Toggle ON to activate. |
| Dynamtic In Content Margin Top | Sets top margin (in pixels) for dynamically inserted in-content ads. | Example: 300 (adds 300px margin-top) |
| Dynamtic In Content Density | Controls density of in-content ads (e.g. insert ad every N paragraphs). | Example: 3 (insert ad every 3 paragraphs) |
| Insertion CSS Path | Defines the CSS selector path for targeting dynamic ad insertion positions within content. | Example: article p:nth-of-type(2). |
| Enable Consentless Ads | Enables serving ads without user consent under specific compliance configurations. | Toggle ON to activate. |
| Enable Browsing Topics | Enables Google Topics API for interest-based advertising without third-party cookies. | Toggle ON to activate. |
| Enable PAIR | Enables Google PAIR (Publisher Advertiser Identity Reconciliation) for first-party data-based targeting. | Toggle ON to activate. |
| Enable Scrolling View Mode | Adjusts ad behaviour based on user scrolling for viewability optimisation. | Toggle ON to activate. |
| Enable Publisher Audience Signals | Enables passing publisher-defined audience segments for advanced targeting. | Toggle ON to activate. |
| Segments | Define publisher audience segments to pass for targeting. | Select segments from the dropdown list. |
| Content Taxonomies | Define content categories based on standard taxonomies for contextual targeting and reporting. | Select categories from the dropdown list. |
4. Click “Save Changes” to Create the Project
This stores the configuration in the platform and generates a unique project ID.
5. Click “Settings” to Edit or Delete the Project
-
General: Update basic details like the project name, environment, domain, and general settings.
-
Block URL: Define specific URLs to block ads from displaying, requesting, or redirecting. This ensures brand safety, controls traffic quality, and optimizes advertising strategies.
-
Install: View ad tag installation instructions and script code snippets, including the project ID. Enable users to complete ad integration easily and ensure the project ID is correctly configured for ad delivery and data tracking.
6. Click "Publish" to Deploy
This pushes the project configuration to the live ad stack and makes it available for request handling.
Once published, the version number is updated to the latest. All changes must be published to take effect.
7. Create a Child Project
Child Projects enable independent management, hierarchical organization, and efficient operations across multiple projects. They can be used for environment-specific overrides or to test variations while maintaining a shared parent configuration.
You can create a child project in two ways:
- From the navigation bar: Click “New Child Project”. Fill in the details and save.
- From an existing parent project: Click “Duplicate to Child” to inherit configurations and quickly create a child project, reducing repetitive work and improving efficiency. Make the necessary changes and save.
Summary
By following these steps, you can successfully create, configure, and deploy projects within BiddingStack.
Always ensure project details and settings are accurate before publishing, as each update affects live bidding behavior and ad delivery.