With dynamic master tags, you can automatically create publishers and placements without accessing your Adform account. Because the setup is quicker, it's especially suitable for ad networks with many publishers and placements.
The dynamic master tag structure includes the values inventory ID, placement name, and publisher domain from a publisher. These values are dynamic, and you can change them by entering different values in the corresponding script.
Once you implement a tag and the tag gets the first hit, Adform creates a new publisher or placement.
A dynamic tag in a URL has this form:
http://adx.adform.net/adx/?inv=XXX&mname=PlacementName&pdom=domain.com
The required parameters within the tag include:
-
inv=XXXis the inventory ID -
mname=PlacementNameis the placement name -
pdom=domain.comis the publisher domain
Note
You can use your Inventory Source ID in this field, which can be found in the Deals page: in the Id column, the number between the dashes represents the Source ID. For example: DID-xxxx-123456 - where xxxx is the Inventory Source ID.
If you don't have any deals created yet, create a test deal with any settings so that a deal ID is generated and you can use it in this field.
You can add other parameters: height (param h=), width (param w=), categories (param cat=), or position (param pos=).
Note
Provide correct, meaningful names for the placement name and publisher domain values because you can't update those settings in your Adform account once you use them in a dynamic tag. Adform doesn't update any placement settings that you don't specify with the optional parameters.
Click to learn about how to for your ads.
Placement Type
To define the type of placement, use the variable t.
-
If a dynamic master tag is sent without a variable or with a value of "1" in the variable, Adform creates a web placement.
Note
Example:
http://adx.adform.net/adx/?inv=XXX&mname=PlacementName&pdom=domain.com&t=1 -
If the variable's value is "2", Adform creates an in-stream placement.
-
If the variable's value is "5", Adform creates a mobile web placement.
Note
Once you set it up, you can't change the placement type.
Placement Size
To define the size of placement, use the variables w (width) and h (height).
If a dynamic master tag is sent without this variable, Adform creates an unsized placement. An example of a sized placement is:
http://adx.adform.net/adx/?inv=XXX&mname=PlacementName&pdom=domain.com&w=300&h=250
You can edit the placement size at any time. However, the placement size specified in the tag always overrides any values that you set manually in Adform.
Placement Position
To define if the placement is positioned above or below the fold, use the variable pos.
-
For the placement to be above the fold, use
pos=atf. -
For the placement to be below the fold, use
pos=below.
http://adx.adform.net/adx/?inv=XXX&mname=PlacementName&pdom=domain.com&pos=atf
If a dynamic master tag is sent without this variable, Adform interprets the position as "Unknown".
Important
Unique pdom and mname values create new publishers and placements. If this combination is being sent with another placement type (type, size or position), Adform only registers the values coming with the initial request.
In Adform SSP, placements created using dynamic master tags have the tag type set as 'Global'.
Placements created through dynamic tags have a 'Not Approved' status. You can find such placements by filtering them. To make the placements active, click the name of a placement, adjust the settings if necessary, and activate it.
Create Dynamic Master Tags in Header Bidding
You can create dynamic master tags in the header bidding container. There are two different versions: Prebid 4 (or lower) and Prebid 5 (or higher).
After triggering the tag, the placement shows as 'Not Approved' in your Adform account.
Note
You can't add creative templates to placement by using dynamic tags. You must add them manually.
Dynamic Master Tag in Prebid 4 or Lower Version
For a Prebid 4 (or lower) version, follow this code sample:
{
bidder: 'adform',
params: {
inv: 1234,
mname: 'hb_dynamic_test',
pdom: 'hb_dynamic_tag_test.com',
mid: 'FJBGOL'
}
With header bidding, the mid parameter is mandatory. Because dynamic tags don't have this parameter, you can insert random letters (alpha characters only).
Dynamic Master Tag in Prebid 5 or Higher Version
You can use the following parameters with Prebid 5 (or higher):
-
site.name,app.name: publisher name/domain (This is the same as thepdomquery parameter in prebid 4.) if this field is empty, thesite.domainvalue is used. ifsite.domainis also empty, the domain is extracted fromsite.pageurl. -
imp[].banner.pos,imp[].video.pos: ad position on screen -
imp[].ext.bidder.inv: inventory source idimp[].ext.bidder.mname: placement name -
imp[].banner.w,imp[].banner.hORimp[].banner.format[0].w,imp[].banner.format[0].h: common openRTB fields for placement size (wandhquery parameters)