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">
<tr>
<td></td>
<td></td>
<td></td>
</tr>
</table>
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:
%%subrequest%x=240|y=90|num=3%
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:
%%subrequest%x=240|y=90|num=3%
<table border="0" height="90" width="728">
<tr>
<td>%subwm-240-90-0%</td>
<td>%subwm-240-90-1%</td>
<td>%subwm-240-90-2%</td>
</tr>
</table>
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
%%subrequest%[Parameter]%
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 ...
%%subrequest%x=234|y=60|num=2%
%%subrequest%x=468|y=60|num=1%
... For two ads in the format 234x60 and an advertisement in the format 468x60 and add them in the placeholders ...
%subwm-234-60-0%
%subwm-234-60-1%
%subwm-468-60-0%
... on.
parameter
| parameter | description |
| 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.