The Shopalyst landing page can be utilized as an ad by leveraging the HTML5 creative approach. This method is supported on platforms that accommodate HTML5 creatives. The ideal ad placement for this approach is half-page ads, with dimensions of 300x600 (width x height).
The system supports two primary use cases:
- Standard HTML5 Ad Tag - Compatible with platforms like Google Ads, DV360, and similar.
- MRAID-Compliant Ad Tag - Designed for platforms such as InMobi, Xandr, and others
1. Standard HTML5 Ad Tag
This option involves sharing a ZIP file containing an HTML file with the following functionalities:
- Meta Tag for Ad Size:
The file includes a meta tag (ad.size
) to define the ad's dimensions. - Impression Tracker:
Upon serving the ad, an impression tracker fires using a 1x1 HTML image tag (<img>
). - Shopalyst Landing Page in an iFrame:
The HTML file renders the Shopalyst landing page within an iframe, set to occupy 100% of the ad's width and height. - Click Tracker Trigger:
The first click anywhere inside the iframe triggers a click tracker, while subsequent clicks do not. - Optional Brand Safety Tag:
If you require additional tracking for brand safety, the system can trigger this tag alongside the impression tracker.
2. MRAID-Compliant Ad Tag
MRAID-compliant ad tags follow the Mobile Rich Media Ad Interface Definitions (MRAID) API standard. These tags enable rich media ads to interact with mobile apps using HTML5 and JavaScript.
This option involves sharing a ZIP file containing an HTML file that performs the following actions:
a. MRAID SDK Integration:
The file expects the presence of the MRAID SDK in the ad environment. It listens for the ready
event broadcast by the SDK.
1. Device Orientation and Screen Size:
Once the SDK is ready, the ad unit:
- Fixes the device orientation to portrait.
- Detects the screen size and renders an iframe to fill 100% of the detected width and height.
- Loads the Shopalyst landing page inside the iframe.
2. Click Tracker Trigger:
The first click anywhere on the ad unit triggers a click tracker. The click tracker is implemented using the ${CLICK_URL}
macro, which the ad environment populates dynamically.
- Note: No impression tracker is supported for MRAID-compliant ad tags.
b. Requirements for Activating Ad Tags
To take an ad tag live, the following elements are required:
1. For Standard HTML5 Ad Tag:
- Click Tracker: Mandatory
- Impression Tracker: Optional
2. For MRAID-Compliant Ad Tag:
- Click Tracker: Mandatory
Step-by-Step: Setting Up and Downloading Your Ad Tag:
1. Choose the Purpose
Start by creating a landing page using the experience module. Select the purpose based on whether you want a Standard or MRAID tag.
2. Set Up Trackers
Add the trackers provided by the brand during creation—this is the only time you can set them up. Double-check everything. You won’t be able to change them later.
3. Add Widgets
Customize the landing page by adding the widgets you need. Use this step to improve functionality and boost engagement.
4. Submit and Download the Ad Tag
Once your page is ready:
Click Submit
A modal will appear with two options:
Download the Ad Tag
Validate the Ad Tag (via a link to Google’s HTML5 Ad Validator)
5. Validate the Ad Tag
Upload your ad tag to the Google HTML5 Ad Validator and make sure all checks pass.
Don’t worry if the relative asset check is flagged—this is acceptable in this case.
After Your Ad Tag Goes Live, Here’s what to keep an eye on once the ad is active:
- Data Discrepancies: Be aware of potential differences between the data recorded by the impression tracker and the store views displayed on our dashboard. These discrepancies primarily arise due to filtering mechanisms employed by most ad platforms. These platforms use additional signals (not accessible to us) to determine the authenticity of impressions.
- Custom Reports: Please reach out to Ops team for tailored reports on campaign statistics or engagement metrics.
Looking for more help? Instructions to reach out to support is here.