Solutions
PerksWallet
Integrating with Hosted PerksWallet
16 min
overview with hosted perkswallet, momentscience manages everything users see a save for later cta on your offer unit when they tap it, they're redirected to https //perkswallet com where they enter their email or phone number to save the offer users can return to perkswallet com anytime to access their saved offers you still earn revenue share on every conversion, no integration required need more control? if you want to embed the wallet directly in your app or website with custom user identifiers, see docid\ ivole8t7ogtn6pwtgr6y1 instead getting started step 1 enable hosted perkswallet contact your momentscience account manager to enable hosted perkswallet for your account step 2 choose your integration method hosted perkswallet supports three integration approaches choose the one that fits your needs option a javascript sdk best for zero code implementation with automatic save for later buttons the sdk automatically renders save for later ctas on your offer units no additional code required how it works the sdk renders a save for later cta button on your offer units when users click the button, they're redirected to perkswallet com users enter their email or phone to save the offer no additional code needed if you haven't integrated yet, see docid krjztx8lw1sog hyh2px docid\ vznklinzojeybod7 vavv option b direct links with url parameter best for email campaigns, push notifications, and direct deep links append \&save for later=1 to any click url to redirect users directly to the save page instead of the offer landing page how it works take any click url from your offer response and add \&save for later=1 at the end https //trk pubtailer com/sdk/offer click?o id=5597\&c id=2901\&p id=3507\&save for later=1 when users click this modified url they're redirected to https //app perkswallet com/save offer instead of the offer landing page they can enter their email or phone to save the offer the offer is saved to their wallet at https //perkswallet com setup simply modify your click urls by adding the parameter works with direct links and email tracking links if the offer doesn't support perkswallet, the \&save for later=1 parameter is ignored and users go to the offer landing page as usual option c native api call best for custom ui with programmatic control use the save for later url from api responses to trigger saves when users click your custom buttons this approach works with both the perkswall api and momentperks api how it works retrieve offers from the perkswall api or moments api extract the save for later url from each offer object in the response when a user clicks your save for later button, make a post request to the save for later url the user is redirected to https //app perkswallet com/save offer example api response { "offers" \[ { "id" "12345", "title" "20% off athletic wear", "click url" "https //trk pubtailer com/sdk/offer click?o id=5597 ", "save for later url" "https //api adspostx com/save offer?token=abc123 ", } ] } making the save request // when user clicks your custom "save for later" button const saveoffer = async (saveurl) => { const response = await fetch(saveurl, { method 'post', headers { 'content type' 'application/json' } }); if (response ok) { // redirect user to perkswallet save page window\ location href = response url; } }; setup requires integration with perkswall api or momentperks api for complete api integration details, refer to the docid 2un6uwr7 uyb7ctvyhyy or docid\ zpol4dx0bohl2aooyzrlq step 3 customize cta text (optional) once enabled, your offers display a save for later cta by default you can customize the perkswallet button text from your dashboard theme customizer customizing the button text navigate to your chosen theme customizer page if you're using perkswall to display offers go to https //app momentscience com/account/integration/perkswall if you're using momentperks to display offers go to https //app momentscience com/account/integration/customize#customize click on " theme settings" tab make sure the perkswallet cta toggle is enabled update the button text (e g , change "save for later" to "save to wallet") save your configuration click save to apply changes to the current theme click save as to create a new theme with these changes if you have multiple themes, you can customize the perkswallet cta text independently for each one this allows different button text across different themes user journey user discovers an offer on your site with a save for later button user taps save for later and is redirected to https //perkswallet com user enters their email or phone number to create a wallet account the offer saves automatically and an account is created instantly user returns to https //perkswallet com anytime to view, manage, and claim saved offers users receive reminder emails about saved offers to boost engagement and conversions cross device sync when users verify their email or phone number, momentscience links their wallet across all devices they can save an offer on mobile and claim it later on desktop access their wallet from any device with the same email or phone number pick up where they left off without losing saved offers users can save offers without verifying their email or phone number, but verification enables cross device access scenario behavior same device user is automatically logged in new device user verifies email or phone number to access saved offers expired offer offer is removed from wallet (only active offers shown) ready to get started? contact your account manager to enable perkswallet for your account need help? ๐ข if you're running into any issues, contact us at mailto\ help\@momentscience com