Perkswall

15 min

Who is this for: Partners who want to add a branded, scrollable offer gallery to their website, mobile app, or digital properties.

Outcome: Choose from direct URL, iFrame, webview, or API integration methods and get the implementation code needed to launch a customized Perkswall experience.

Overview

Perkswall displays multiple offers and perks in a customizable, branded interface. The platform supports LoyaltyBoost offers that reward users with points or virtual currency when they interact with offers. As users scroll, MomentScience loads additional offers dynamically to maintain engagement.

Key Features

Modern Interface: Perkswall 2.0 provides a clean, intuitive user interface that simplifies offer discovery and improves user engagement.

Brand Customization: Customize the favicon, header, and offer card appearance to match your brand identity. Adjust all settings directly through your dashboard.

Easy Integration: Add Perkswall to your digital properties by linking to a standalone URL or embedding it in your app or website. Use a webview, iFrame, or the API to fetch and display offers directly within your systems.

Save Offers with PerksWallet: Enable users to save offers for later with PerksWallet, increasing repeat engagement and giving users flexibility to claim perks at their convenience.

See Perkswall in action with our live demo. This basic implementation demonstrates how Perkswall displays offers - customize it further to optimize user experience and maximize revenue.

Implementation Methods

Implement Perkswall using one of these approaches:

Direct Integration

Perkswall works on mobile and desktop. Add it to your digital properties by either:

Linking to a standalone URL

Embedding it within your webpage or mobile app webview

To get your Perkswall URL and implementation code, go to the Perkswall Integration Page in your dashboard.

Getting Implementation Code from Dashboard

To obtain your direct Perkswall link and embed code:

Navigate to the Perkswall Integration page in your dashboard.

Scroll to the Webview section below the live preview.

Copy the provided Perkswall URL for use in your app, website, or webview.

Watch this demonstration to learn how to get your implementation code from the dashboard:

Integrating Embedded Perkswall

Follow these steps to integrate Perkswall into your webpage:

Step 1: Embed the Perkswall Script

Place the Perkswall script inside the <body> section of your HTML file, just before the closing </body> tag. You can get the embed code from the Perkswall Integration page in your dashboard.

Step 2: Add the Perkswall Container

Add the following container element to your HTML body where you want the Perkswall to appear:

<div id="adpx_container"></div>

Ensure the id attribute adpx_container is unique and not used by other elements on the page.

Complete HTML Example

Here is a complete example of an HTML page with the embedded Perkswall code:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>MomentScience Perkswall Integration</title>
</head>
<body>
    <header>
        <h1>Welcome to MomentScience Perkswall Integration</h1>
    </header>

    <!-- Perkswall Container -->
    <div id="adpx_container">
    <!-- Perkswall will be dynamically injected here -->
  
    </div>

    <footer>
        <p>&copy; 2024 MomentScience. All rights reserved.</p>
    </footer>

    <!-- Embed the Perkswall script at the end of the body -->
    <script>
        // Configuration for Perkswall
        window.AdpxConfig = {
            accountId: "f8e15t86865hef4",  // Replace with your account ID
            themeId: "MomentScience_Docs",  // Custom theme ID
            containerId: "adpx_container"   // Container ID for rendering
        };

        // User-specific data (payload)
        window.AdpxUser = {
            // Add relevant user data here
            age: 25
        };

        // Create and append the Perkswall script
        var adpx = document.createElement('script');
        adpx.type = 'text/javascript';
        adpx.async = true;
        adpx.src = 'https://cdn.adspostx.com/launcher.perkswall.js';
        document.body.appendChild(adpx);
    </script>
</body>
</html>

API Integration

The Perkswall API lets you fetch MomentScience offers directly into your platform. Use it to enhance your existing offerings or create a fully customized experience. You can retrieve offer fragments via the API and construct your own Perkswall implementation.

Payload Parameters for Reporting and Targeting

Use payload parameters in the Perkswall URL to enhance both reporting and targeting capabilities. These parameters track performance and personalize offer displays.

Reporting Parameters

Track Perkswall performance across different conditions by adding custom parameters to the URL. For example, monitor traffic sources with the refsource parameter:

https://get.perkswall.com/offerwall/v2/?accountId=99e58babc94df55a&refsource=push

This example shows a refsource=push parameter indicating the user came from a push notification. Access this data in your reporting to compare performance across different channels.

Targeting Parameters

Tailor displayed offers based on user attributes by passing targeting parameters. For example, target offers by location using zip code:

https://get.perkswall.com/offerwall/v2/?accountId=99e58babc94df55a&zipcode=78099

The zipcode=78099 parameter ensures users see offers relevant to their area. Combine multiple parameters for precise targeting based on demographics, location, and user behavior.

Need help with integration? Contact us at [email protected]