Rationale
Currently the 3rd party payment option in the Google Ad Manager (GAM) Offerwall only supports specific countries. If your country is not supported, then another option would be to use the Custom Choices API within GAM to load and use Supertab in your country.
Prerequisites
The following will need to be set up before you can continue to configure the Offerwall using the custom choices option:
-
A Supertab account configured with your offerings and pricing.
Site Setup
Full documentation on using the Custom Choices API is available for reference. However, the following configuration on your site should work “out of the box”.
Insert the following code in the <head> section of the pages you want to monetize, be sure to use your Supertab clientId and merchantName:
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="https://onpage-widget.supertab.co/v2/widget.js"></script>
<script>
// Offerwall "custom choice" integration
const SupertabMonetizationProvider = window.googlefc.monetization.providerRegistry.get("supertab").constructor;
const supertabMonetizationProvider = new SupertabMonetizationProvider({
clientId: "client.xxxxx", // PROD
merchantName: "XXX Merchant Name"
});
window.googlefc.monetization.providerRegistry.set("publisherCustom", supertabMonetizationProvider);
</script>The gpt.js script is what enables the Offerwall, and the SupertabMonetizationProvider is what configures the Custom Choice API with Google.
If you are already using the Google Tag Manager (gpt.js) then make sure the Supertab block of code appears just below it.
Google Ad Manager Configuration
In GAM select, “Messaging & Privacy” and then “Create” under the Offerwall option.
Then select “Create Offerwall”
On the right hand side, ensure that Rewarded Ad and Suptertab.co are disabled.
Click on the “Styling” option and configure the look and feel of the offerwall. Including the call to action text. The text in the preview section of the page is editable.
You can add a logo to the offerwall, but it is done in another section of GAM, you can follow these instructions.
You can also configure how many “free” page views a visitor will receive before being displayed the offerwall. As well as supported languages and which pages the offerwall will appear (more info below).
Page inclusions and exclusions allows you specify which pages the offerwall will appear on. There are two ways you can do this:
Option 1
Include the SupertabMonetizationProvider configuration only on pages that you want the offerwall to appear.
Configure the offerwall to appear on all pages. By default if there is no Custom Choice API configured on the page, then the offerwall will “fail open” and not be displayed even if it is configured to do so.
Option 2
Include the SupertabMonetizationProvider on all pages, but use the Inclusions and Exclusions rule set to control where the offerwall appears.
Note: There is a limit to only 4 url patterns per inclusion or exclusion.
When you are ready to publish the offerwall and go live. Click on the “publish button” on the top right of the page. Note it may take 10-15 min for your offerwall to appear on the site.