Integration Guide

How to integrate Pick-4-Win app into an iframe:

  • Use https://engagearena.xyz/[locale]/contests-list as the default iframe URL to show the contest list page.
  • Set the language by replacing [locale] in the URL with the desired language code. For example:
    • /en/contests-list for English
    Supported languages: en (English), ja (Japanese), es (Spanish), pt (Portuguese), tr (Turkish), th (Thai), de (German), zh (Chinese), fr (French), ko (Korean), vi (Vietnamese), ar (Arabic), id (Indonesian)
  • Pass the authentication token as a query string parameter: ?token=YOUR_TOKEN
  • Pass the auth URL to redirect users to a login page if they’re not authenticated: ?auth_url=example.com/login. If not provided, the system will attempt to use window.parent.location.origin or document.referrer by default.
  • Pass the registration URL to redirect users to a registration page if they’re not authenticated: ?reg_url=example.com/register. If not provided, the system will attempt to use window.parent.location.origin or document.referrer by default.
  • Pass the action URL, which acts like a call-to-action (CTA) and defines where logged-in users should be redirected to perform the action you want them to complete to become eligible to use the platform: &action_url=example.com/action. If not provided, the system will attempt to use window.parent.location.origin or document.referrer by default.

Example: Embed iframe in parent page

<iframe
  src="https://engagearena.xyz/en/contests-list?auth_url=example.com&reg_url=example.com&action_url=example.com&token=YOUR_TOKEN"
  width="1130px"
  height="820px"
  frameborder="0"
></iframe>