How to Create and Manage Ad Placements
This guide explains how to create and manage placements within a project. Placements define where and how ads are displayed on your website or app, including their size, targeting conditions, and bidder configurations.
1. Go to the Project List
From the sidebar, navigate to Projects > All Projects, then select the project.
2. Click "Placements"
This opens the list of all existing placements of the selected project.
3. Click "New Placement" (top-right)
4. Fill in Placement Details
Placement Type includes Banner, JSTag, Native, and Mobile. When mobile is selected, only the Basic and Ad Format sections need to be configured.
Basic
| Field | Purpose | Options / Configuration |
|---|---|---|
| Name | The internal human-readable identifier for this placement. Cannot be changed once saved. | Set a clear, structured name indicating placement location and type. |
| Display Name | External display name used in UI or reporting for clarity. Can be updated anytime to improve clarity. | Example: Homepage Sidebar BTF |
| Placement Type | Defines the placement format type. | Select one of: Banner、JSTag、Native、mobile. |
| Ad Type | Specifies the type of ad creatives allowed. | Select one or multiple: Banner, Native, Video. |
| GAM Path | The path to the Google Ad Manager ad unit. Must match exactly to link correctly. | Example: /1234567/homepage/sidebar_btf |
| Enable Prebid Server | Activates Prebid Server integration for server-side bidding on this placement. | Turn ON to activate. |
| Status | Controls whether the placement is active or paused for serving. | Turn ON to activate. |
Ad Format
| Field | Purpose | Options / Configuration |
|---|---|---|
| Unit Sizes | Sets the default allowed ad sizes for the placement, used by demand partners to match creatives with inventory. | Choose standard IAB sizes that match your site layout from the dropdown list. |
| Ad Sizes | Defines the exact creative sizes allowed to render within this placement. Controls the bidding and ad rendering process. | Choose standard IAB sizes that match your site layout from the dropdown list. |
Pre-Targeting
Targeting rule of the placement, limit delivery based on the rules. No limitation by default.
| Field | Purpose | Options / Configuration |
|---|---|---|
| Domain | Limits ad delivery to specific website domains if required. | Example: example.com, sub.example.com |
| Device | Specifies which device types the placement targets. | Options: All, Desktop, Mobile |
| Page Type | Defines which page types the placement applies to. | Options: All, Home Page, Article, Category |
| Traffic Type | Sets traffic quality targeting, filtering invalid traffic if required. | Options: Standard, IVT, None-IVT |
| Country or Area | Targets users based on geographic location for localized ad delivery. | Example: United States, Canada, EU |
| Type | Sets placement to run only in specified environments for testing or production. | Options: All, Testing, Production |
| Targeting KV | Adds custom key-value pairs for granular targeting rules integrated with bidders. | Example: category=sports, userType=premium |
Settings
| Field | Purpose | Options / Configuration |
|---|---|---|
| Enable single request architecture | Requests all ad slots in a single call to improve page performance and ad delivery, ideal for pages with multiple ad units. | Turn ON to activate. |
| Enable Ad Label | Displays "Ad" or similar label to indicate advertising content for user transparency and compliance. | Turn ON to activate. |
| Enable lazyload | Defers loading of the ad until it enters the user's viewport to improve page performance. | Turn ON to activate. |
| Enable refresh | Automatically refreshes the ad after a defined interval to increase impressions and revenue. | Turn ON to activate, then configure Max Refresh Times and Refresh Rate (ms). |
| Enable Safe Frame | Uses SafeFrame to sandbox creatives for improved security and page stability. | Turn ON to activate. |
| Insertion Type | Defines how the ad is inserted into the page layout. | Options: |
| Insertion Position | Defines the position of the ad relative to each target element. | Options: After End, Before Begin |
| Insertion Vertical Alignment | Sets vertical alignment of inserted ads within the container. | Options: Off, Top, Middle |
| Insertion CSS Path | Specifies CSS selector path for inserting the placement into the DOM at the correct position. | Example: .article-content p:nth-child(3) |
| First Offset (In List) | Specifies at which list item the first ad will appear. Applies only for In List insertion type. | Example: 0 (insert after the first item) |
| Step (In List) | Defines the interval between ads in the list. Applies only for In List insertion type. | Enter a number. Example: 5 (insert an ad every 5 items) |
| Number Pattern (In List) | Regex pattern to identify item indices in the list. Applies only for In List insertion type. | Enter a valid regular expression. Example: data-post-number:(\d+). |
Bidder Params and PBS Bidder Params
Specifies the parameters required by each bidder (SSP/Exchange) to ensure accurate bid requests, proper integration, effective targeting, and valid bid responses. Configuration should follow each bidder's documentation.
5. Click "Save Changes"
This stores the configuration in the platform and generates a unique placement ID.
6. Click "Duplicate"
This duplicates the configuration of an existing placement, quickly creating a new identical or similar placement to reduce repetitive tasks and improve setup efficiency.
7. Click "Settings" to Edit or Delete the Placement.
By following these steps, you can efficiently create, duplicate, and manage ad placements to optimize your ad delivery strategy across different projects and environments.