What are Subrequests?
Under Subrequests means the delivering one or more advertisements on the codes of another advertising medium. Concrete example that virtually everyone knows Google text ads: In an HTML advertising media in the format 728x90 displays Google AdSense / AdWords divided three small text advertising agents. The AdSpirit ad server may also implement this method by defining in a HTML-promotional the outer layout and then using Subrequests (to German subqueries) invites other advertising material into the advertising material.
Subrequests thus produce the same effect obtained when you copied the code of advertising space in an advertisement in, only with the difference a faster delivery (it has only one call is sent to the server) and a more detailed statistical analysis.
Use of Subrequests
Important: Before using Subrequests you should do so necessarily check with your technical contact since Subrequests create additional server load and can lead to errors in advertising delivery if necessary!
To use Subrequests first define a normal HTML advertising. This serves as an "outer" advertising media and is responsible for the layout. Fill out the ad with which your code. So you want to eg an advertisement customize how the ad described in the above example, the Google AdWords ads, then add in this example, the external advertising media such as a table with one column and three cells:
<table border="0" height="90" width="728">
Now create another "internal" advertising material, or about the texts to be displayed as another advertising medium. Optimally, the internal advertising material should always be placed in a different campaign than the outer. It is also important that all internal promotional material have the same height and width.
Finally, you add a corresponding placeholders in the external advertising. To generally activate Subrequests for an advertisement add the placeholder %% subrequest%[parameters]% in the ad, where [parameters] should be replaced with further instructions (exact parameter list see below). In our example, eg 3 ads in the format 240x90 to be included now, the parameter should read here:
In addition, add to the points at which advertising material should be inserted a placeholder %subwm-x-y-n% a where x = width, y = the height and n = the number of the creativem (0, 1, 2 ...) is. The complete code of our example looks therefore like this:
<table border="0" height="90" width="728">
Important: When searching for internal advertising exclusively those found whose width and height exactly match the search, which are active and which are posted on the respective advertising space! An internal advertising material behaves
Technique of placeholders
In the outer advertising medium placeholder must
be defined; this determines that other advertising media to be searched. Furthermore, it must instead of [parameters] one by | separated list of parameters are noted. These parameters determine what to look for "internal" advertising.
Found inner advertising material can in turn be inserted into the code with the placeholder %subwm-xyn%, wherein ...
x = width of the desired advertising material
y = height of the desired advertising material
n = number of the desired advertising material (starting with 0)
... to are replaced.
In an outer advertising material thus inner advertising media of different formats may be inserted as: The placeholders ...
... For two ads in the format 234x60 and an advertisement in the format 468x60 and add them in the placeholders ...
|num=||(Mandatory) Number of creatives to be searched for
|x=||(Mandatory) width of the creative to be searched|
|y=||(Mandatory) height of the creative to be searched|
|min=||(Optional) Number of creates the system needs to find as a minimum. Default to 1 if the parameter is not specified. If fewer "min" creatives are found, the entire (outer) creative not displayed. This will help avoid empty (inner) creatives.|
|dontex=1||(Optional) If set, the inner creative's campaign can appear more than once. Of not set, only one inner campaign can be displayed per outer creative.
|dontexme=1||(Optional) If set, the inner creative may be from the same campaign as the outer. If not set, the inner campaign must be from a different campaign than the outer campaign.
|matchproperties=1||(optional) If set, the inner creative must have at least one attribute that matches one attribute of the outer creative.|
Multiple parameters by | separated.
Data output in Subrequests
Advertising material by means of the placeholder% subwm-xyn% (see above) is output. For this purpose, it is also possible that data with a sub-advertising media associated specifically query. These are two more wildcards are available:
|%subwm-x-y-n:var:ZZZ%||Outputs the data, which would have had (without%) in the case of sub-advertisement, the placeholder ZZZ (eg are%subwm-x-y-n:var:wmid% the advertising media ID of the sub-advertising material off)|
|%subwm-x-y-n:ad:ZZZ%||Specifies the database column in question ZZZ of the sub-advertising material (for example, is %subwm-x-y-n:ad:strURL% click-through URL of the sub-advertising material off)|
Moreover subrequest with the %subrequest:found-items% the number of found sub-advertising money is spent.
In Subrequests the settlement is slightly different from the normal billing. Take the example from above into the 728x90er in an advertising medium 3 small 240x90 advertising materials are displayed:
- Compared to the webmasters only impressions of the outer 728x90er advertising material are settled and disclosed in the statistics. The screen displays the inner 240x90er advertising media are not reported for the webmaster in the statistics.
- Compared to the webmaster revenue from impressions of internal advertising media will only be charged if the property "Subrequests settle" in the outer campaign to the value is set "to add cost." However, evaluation of views continues to show only the number of external calls.
- (If the property is "Subrequests settle" to "add costs," set) With respect to the webmaster clicks, leads and sales are charged according to the pricing of the outer advertising medium and added to the cost of the inner advertising material.
- Compared to the advertisers always each advertising agent is settled that is allocated to this. That is, the outer advertising media view is billed to the customer 1 as the outer advertising material and the inner 3 views are charged to the respective "inner customers" (where set in the campaigns). For clicks / leads / sales, the same applies.
|CPM campaign without Subrequests "to add cost"||CPM campaign||CPC campaign||Lead Campaign||Webmaster gets TKP the outer Campaign|
|CPM campaign with Subrequests "to add cost"||CPM||CPC||lead||
Webmaster gets TKP the outer campaign
|No adjustment of settlement and adjustment "to add cost" Subrequests on||CPM||CPC||lead||Webmaster gets CPM for the view of the inner campaign 1
+ CPC inner campaign 2 provided that a click on this inner advertising materials
+ CPL the inner Campaign 3 provided a lead from this inner advertising materials