Getting Started Smaato Ad Tag

Home » Publisher Documentation » Getting Started Smaato Ad Tag

Introduction

The Ad Tag can be easily enriched with user targeting data, device ID, demographics or location data (see table below for more details). Furthermore, the Ad Tag gives you the option to choose ad dimension, an auto-reload timer, and ad display mode (inline or fullscreen). Lastly, Ad Tag can also be enriched using your ad server’s replacement macros to pass additional targeting data.

Ad Tag Code for In-App

Inline Ads

<div id="smaatoad" style="padding:0px"></div>
<script type="text/javascript" src="https://soma-assets.smaato.net/js/smaatoAdTag.js"></script>
<script>
   function myJSCallBack(status) {
       if (status == "SUCCESS") {
           // TODO Handle ad available (Option)
       } else if (status == "ERROR") {
           // TODO Handle not ad available
       }
   };
   SomaJS.loadAd({
       adDivId: "smaatoad",
       publisherId: REPLACE_WITH_PUBLISHER_ID,
       adSpaceId: REPLACE_WITH_ADSPACE_ID,
       autoReload: 240,
       dimension: "xxlarge",
       dimensionstrict: true,
       keywords: "cars,shopping",
       gender: "m",
       age: 27
   }, myJSCallBack);
</script>

Ad Tag Usage

Insert the code at the desired section of your application.

Replace REPLACE_WITH_ADSPACE_ID with your Ad Space ID and replace REPLACE_WITH_PUBLISHER_ID with your Publisher ID.

Ad Tag Advanced Usage

You can add additional targeting data by inserting additional parameter lines. Usually, you will insert your ad server’s replacement macros here instead of actual data. The format to be used is shown here:

PARAMETER: 'STRING' (for string values) with quotation marks

PARAMETER: true (for boolean values) WITHOUT quotations marks

PARAMETER: 12345 (for numeric values) WITHOUT quotation marks

Example:

city: 'Miami'
formatstrict: false
age: 25

You can also prevent your AdTag from auto-reloading by either setting the autoReload parameter to 0, or by adding the following code snippet just below your AdTag:

<button onclick = stopAutoReloadAd()>Stop Auto Reload Ad</button> <script>
function stopAutoReloadAd() {
    SomaJS.stopAutoReloadAd();
    }
</script>

Ad Tag Parameters

IAB-XXX or IAB-XXX-XXX

MyApp_iOS_320x50

Ads for Testing Purposes

Last Modified: August 31, 2023 at 11:51 am