Customizing Airpage

    This document outlines how to customize the Airpage that users see when scheme deep linking is attempted via the tracking link.

    Basic Functionality

    When a user accesses Airpage, the URL of the static page is loaded in iframe. Even if the loading fails, the logic attempting scheme deep linking and fallback will still be executed.

    Prerequisite

    Prepare a static page following the steps below and provide the URL to your Airbridge CSM.

    1. Configure the iframe Cross Origin settings so that the server serving the static page allows all domains. Refer to the links below for details.

    2. Make sure the static page is served over HTTPS.

    3. The deep link button, which is the CTA button embedded with the deep link in the default Airpage, should execute ‘postMessage’ when a user clicks it.

    By default, scheme deep linking and fallback are automatically attempted when a user accesses Airpage. If the user returns to the browser and clicks the button, scheme deep linking and fallback can be manually executed. Implement the deep link button to execute the following code when a user clicks it.

    1
    parent.postMessage('airbridge.deeplink_page.deeplink_button.clicked', '*')

    Attention

    Conduct a test in your expected live environment before deploying the tracking link to ensure proper functionality.

    Attention

    We recommend applying this first to your development app registered with Airbridge, and then applying it to your production app after testing is complete.

    Troubleshooting

    Q. The Airpage is not displayed, and the following error message is shown in the browser console.

    Refused to display '{URL}' in a frame because it set 'X-Frame-Options' to 'sameorigin'.

    A. You need to configure the server settings so that all domains are allowed. Refer to this document.

    Was this page helpful?

    Have any questions or suggestions?