How to Validate Emails with Kickbox in Digioh

Digioh App Extensions

When a user submits an email with a form submission, you may want to validate this email with Kickbox.  In order to do this, simply use the Kickbox Integration App

1. Install the App in your Digioh Account

In your account, navigate to the menu under your account name at the top right of the page. Here, select “Extensions”.

 

Next, click on the “Expand all sections” button to see all of the available apps.

Here, scroll down under the Data Validation section and find the “Kickbox Integration” app.  Click “Install”

 

2. Set up your Kickbox Integration

To set up your Kickbox Integration, navigate to the Integrations tab in your account.

Select the “+ New Integration” button

Name your integration. Then, under “Integration”, select “Kickbox”.  Finally, select the campaign you would like to run the Kickbox Validation on.

Once you have set up your integration, on your Integrations page, find the Kickbox Integration Id by looking to the left of the Integration name.

3. Configure Account Metadata

After finding your Kickbox Integration Id, navigate to the menu under your account name on the top right hand side of the page.

Select “Account Metadata”.

Here, configure metadata key: kickbox_proxy_integration_id and for the value, put your kickbox integration id.

and also site-specific integration IDs. This is useful if you are running multiple sites out of a single Digioh instance and/or have a sandbox site that you want to point to your kickbox sandbox:

4. Configure Widget-level Metadata

1. Open the lightbox you’re setting up for Kickbox and go to the Widget tab.

2. Add the widget metadata key email_field and set its value to one of the following:

• email — uses the default Email field.

• custom_X — where X is the number of the custom field that stores the email address (for example, custom_1).

  

Optional metadata

• kickbox_allow_risky = true (or 'risky')

• kickbox_allow_unknown = true (or 'unknown')

Effect: When enabled, the app treats the corresponding Kickbox result (risky or unknown) as acceptable and proceeds with submission.

Submission behavior

When the visitor submits, the app validates the address in the field specified by email_field using your configured Kickbox integration. If validation succeeds, the form submits. If validation fails, submission is blocked and the user is shown an error.

 

 

 

Questions? Comments? Let us know at support@digioh.com!