VAST Tag Types

Infillion uses two types of VAST tags for both TrueX and Interactive Video products. The tags differ in how the adParameters JSON payload is embedded in the VAST XML.

"Generic" Tag

The adParameters are embedded directly as a JSON string within the <AdParameters> node:

TrueX "Generic" Tag:

https://get.truex.com/{placement_hash}/vast/generic?{ad_request_parameters}

Interactive Video "Generic" Tag:

https://get.truex.com/{placement_hash}/vast/idvx/generic?{ad_request_parameters}

VAST Structure:

<VAST version="4.0">
  <Ad id="...">
    <InLine>
      <AdSystem>trueX</AdSystem> <!-- or "IDVx" for IDVx ads -->
      <Creatives>
        <Creative>
          <Linear>
            <Duration>00:00:30</Duration>
            <AdParameters>
              <![CDATA[ { ...ad_parameters_json_string... } ]]>
            </AdParameters>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="1280" height="720" apiFramework="truex">
                <![CDATA[https://qa-media.truex.com/m/video/truexloadingplaceholder-30s.mp4 ]]>
              </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

"Companion" Tag

The adParameters are embedded in a companion ad's <StaticResource> node as base64-encoded json string:

TrueX "Companion" Tag:

https://get.truex.com/{placement_hash}/vast/companion?{ad_request_parameters}

IDVx "Companion" Tag:

https://get.truex.com/{placement_hash}/vast/idvx/companion?{ad_request_parameters}

VAST Structure:

<VAST version="4.0">
  <Ad id="...">
    <InLine>
      <AdSystem>trueX</AdSystem> <!-- or "IDVx" for IDVx ads -->
      <Creatives>
        <Creative>
          <CompanionAds>
            <Companion id="super_tag" width="960" height="540" apiFramework="truex">
              <StaticResource creativeType="application/json">
                <![CDATA[ ...base64_encoded_json_string... ]]>
              </StaticResource>
            </Companion>
          </CompanionAds>
        </Creative>
        <Creative>
          <Linear>
            <Duration>00:00:30</Duration>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="1280" height="720">
                <![CDATA[https://qa-media.truex.com/m/video/truexloadingplaceholder-30s.mp4 ]]>
              </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

Differentiating TrueX and IDVx

The <AdSystem> node value identifies the ad type:

• TrueX ads: <AdSystem>trueX</AdSystem>
• IDVx ads: <AdSystem>IDVx</AdSystem>

Both tag types (Generic and Companion) work with both TrueX and IDVx products.