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 to be searched advertising material|
|x =||(Mandatory) width of the advertising media to be searched|
|y =||(Mandatory) the amount of advertising material to be searched|
|min =||(Optional) number of at least findenen advertising material. Default is 1 if the parameter is not specified. If fewer than looking for "min" advertising material found is the entire (outer) Advertising media not displayed. So will help avoid empty (inner) advertising space.|
|dontex = 1||(Optional) If set to internal advertising media the same campaign appear more than once. only one internal advertising material is not set when accepted by each campaign.|
|dontexme = 1||(Optional) If set to inner promotional material from the same campaign originate as the outer advertising material. If not set advertising resources from other campaigns must come.|
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