In-app ad placements are typically either:
- Interstitial placements. These are implemented using the AwesomeAds SDK.
- Video placements. These are implemented using either the AwesomeAds SDK or video/VAST tags.
To set up an in-app ad placement, you first create the app in your AwesomeAds account, and then create a new placement for that app for each format. You can then generate the tags for the placement or use the placement ID in the AA SDK.
Create the app
- Select the Apps and Sites tab, and then click Create a new app/site:
The New App/Site view is displayed: 
- Enter the app details:
| Item | Description |
|---|---|
| Name | Give your app a unique, descriptive name. |
| Property type | Select ‘Mobile app’. |
| Bundle ID | Ensure that the bundle id is the same as in the app stores. |
| Audience info | Select the age and demographic that suit your platform best to ensure the most relevant ads appear for your users. – To increase relevance, it is recommended that you select a maximum of two age groups per app. – ‘Teens 13-16’ cannot be selected in conjunction with any other age group. Because our advertising is contextually targeted, we require high levels of accuracy when selecting your age buckets. If you are unsure of your age demographic, try getting a young person’s opinion. If you cannot decide, reach out to your Account Manager. |
| Auto approval | This setting determines whether all ads are approved by default or if you’d like to approve every ad that runs. – If set to ‘On’, you automatically accept all contextually relevant ads from our adserver. Auto-approval is recommended, for scalability. – If set to ‘Off’, you will need to dedicate resources to manually approve each creative before they go live. This will impact your fill rates and is not the optimal setup. |
- Click Save. The view closes, and the new app appears in the Apps and Sites view.
Create the placement
Next, create your ad placement:
- In the Apps and sites view, hover over the required app and click Add a new placement:
- In the New Placement view, select ‘Desktop formats’, ‘Mobile formats’ or ‘Video formats’ as required from the dropdown menu, and then select from the available sub-formats:
Mobile formats
The most commonly-used ‘Mobile formats’ are interstitial formats. For these, integration is via the AwesomeAds SDK.
For skippable placements, we recommend using interstitial placements.
To implement video ads on mobile, select ‘Video formats’.
Video formats
Use the standard Video format for in-app placements:
Video placements are implemented using either the SDK or video/VAST tags.
For rewarded placements, we recommend using video placements only, because they are measured on VCR.
- Enter a name for your placement. Choose a unique and descriptive name, so you can easily identify the placement in the dashboard and reports.
- Click Save. The New Placement view closes.
- In the Apps and Sites view, expand the app to view the details of the new placement:
The placement details are as follows:
| Item | Description |
|---|---|
| Dimensions | The format and size of the displayed ad. |
| Placement name | The name you provided for the placement. |
| Placement ID | A unique placement ID. This is used to call the tag using the SDK, or to report on placement level performance. Placement performance reporting is great for campaign optimisation and troubleshooting |
| Linked ads | The number of live ads that have been linked to the placement. This is zero until your placement goes live. When you first create your tag, there will be no ads linked. As soon as you begin to send requests, this number should reflect the number of suitable ads for this placement. |
| Get placement tags | Click to generate the placement tags for the placement. NOTE: This option is visible only when you hover over the placement. |
<Settings> | Click to: – Provide the URL and an image for the creative you wish to use as a fallback. – Provide a fallback tag. – View the impression / click counter (legacy functionality). – Preview a mock-up of the ad as it will appear on a mobile device. – Edit the details of the placement. – Delete the placement. |
Get the placement tags
- In the Apps and Sites view, expand the app to view the new placement.
- Hover over the placement and then click Get placement tags:
The Placement Tags view displays the generated tags. - For mobile interstitial formats, which are implemented using the AwesomeAds SDK, use the unique placement ID. This is displayed at the bottom of the Placement Tags view:
- For video placements, either use the placement ID with the SDK, or copy the Video Tag or VAST URL, as required:
The Test Video Tag is used only for setting up your test campaign, prior to going live.
Add VAST tag macro
When using VAST tags for your in-app video placements, you can optionally add the bundle macro at the end of each VAST tag to capture the app bundle:
&bundle=[insert bundle here]
Example tag structure
https://ads.superawesome.tv/v2/ad/XXXXX?vast=true&bundle=[insert bundle here]
Create an ad pod
Ad podding provides the ability to return multiple ads from a single ad request. This creates an additional opportunity to boost fill rate and monetisation, while avoiding duplication.
To set up an ad pod, include these parameters in your VAST tags:
| Parameter | Description | Format |
|---|---|---|
| &podAdSlots | The maximum number of ads that will be returned in the response. Mandatory if a pod is required. | &podAdSlots=3 |
| &podMaxDuration | The maximum total timeframe (in seconds) of all ads returned. Optional. Can be used only if podAdSlots is also present in the tag. | &podMaxDuration=20 |