Managing campaigns

What is a campaign?

Whereas a listing identifies your organization in our system, a campaign can be used to create multiple unique experiences under a single parent listing. If you have not already read about listings, we recommend you start here.

The following are use cases where you might want to use campaigns under your listing:

You have different offers for various affiliation groups (i.e. 20% off for Military vs 10% off for First Responders).
You manage multiple online stores under different brands
You are a technical agency managing websites for multiple clients
You are running a seasonal promotion and want to customize the user experience without changing the core listing settings

Customizable elements

The following settings can be customized for a campaign.

Affiliations

Similar to Listings, you can configure the eligible affiliations per campaign. This allows you to manage different offers per group under the same listing. All the same affiliations are available at the Campaign level as on the Listing level.

If you are using campaigns to control eligible affiliations, we recommend you make your Listings settings all-inclusive of the child campaigns.

Display

Our goal is to create a great experience for your customers while supporting and reinforcing your brand. To this end, you can skin the verification funnel to match your organization. The following elements are customizable:

Customize	Description	Specs
Color scheme	You can customize the following elements: Header color Form background color Footer color	Colors should be supplied as a HEX color-code
Logo	Custom logo in form header	Landscape/horizontal logos are recommended and should be at least 40px tall. Square or vertical logos should be at least 100px tall. Logos should be on a transparent background. Supported file types are JPEG and PNG.
Background image	Instead of a solid color, you can also apply an image to the form background. The image will only display on desktop screen resolutions.	Image files should be at least 2000px wide Image files should be web-optimized, with a target size is under 100kb. Uncompressed / larger files will be accepted and our service will automatically compress images as much as possible. The small file size recommendation is purely to enhance page load times in the verification application. Supported file types are JPEG and PNG.

Messaging

In addition to the branding, we also allow you to customize some of the messages displayed during the verification process. Specific text areas include:

Messaging	Description	Specs
Welcome message	This is the message displayed on the opening screen of the verification funnel. You can use this text to reiterate your offer (ex: Acme Widget Company thanks you for your service with our military discount).	200 character limit, including spaces.
Terms of Use	If you are requesting scope from the user, we will display a link to your terms of use.	URL for Terms of Use page on your website. Page must be publicly available.
Privacy Policy	If you are requesting scope from the user, we will display a link to your privacy policy.	URL for Privacy Policy page on your website. Page must be publicly available.

Appending a Campaign Parameter

To trigger your campaign settings, simply append the campaign_id parameter to your verification url. The verification url is the authorization endpoint you're deploying on your website or application that triggers the verification flow.

An example authorization endpoint, with a campaign_id, will look like this (with placeholders for real values). You'll notice the campaign_id parameter appended at the end of the url.

GET https://auth.govx.com/oauth/authorize?client_id={client_id}&redirect_uri={redirect_uri}&scope=user_profile%20verification%20user_demographics&response_type=code&state={state}&campaign_id={campaign_id}

Our system will read the parameter and automatically apply the custom settings. If for some reason the campaign parameter is unrecognized, we will fall-back to the default listing settings.