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
Basic
| Field | Purpose | Options / Configuration |
|---|---|---|
| Type | Defines the placement format type. | Select one of: Banner、JSTag、Native. |
| 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 |
| GAM Path | The path to the Google Ad Manager ad unit. Must match exactly to link correctly. | Example: /1234567/homepage/sidebar_btf |
| Ad Type | Specifies the type of ad creatives allowed. | Select one or multiple: Banner, Native, Video. |
| 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. |
Targeting
| 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 |
| Environment | 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. |
| Enable Prebid Server | Activates Prebid Server integration for server-side bidding on this placement. | Turn ON to activate. |
| Insertion Type | Defines how the ad is inserted into the page layout. | Options: |
| 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) |
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.
Summary
By following these steps, you can efficiently create, duplicate, and manage ad placements to optimize your ad delivery strategy across different projects and environments.