How to Build a KickFire Integration in Act-On

This article walks you through getting started with KickFire for Act-On, including essential steps like creating hidden fields, configuring landing pages, embedding forms on a website, and enhancing external forms with Act-On's form data.

Screen Shot 2021-05-13 at 4.21.58 PM

Required: KickFire API key, KickFire JavaScript file, and access to Act-On
Need help creating an API key? Refer to Getting Started with KickFire API.

 

Create Hidden Fields for KickFire Data Responses

  1. Content > Forms > Select your existing form > Edit

    Screen Shot 2021-05-13 at 4.23.10 PM
  2. On the Design tab, drag and drop the Hidden Field block to the form.

    Screen Shot 2021-05-13 at 4.22.28 PM
  3. In Edit Hidden Field dialog box, create Label and Field Name. Repeat as needed.

    Screen Shot 2021-05-13 at 4.22.35 PM
  4. Click OK and Close

If you will be using external website, not Act-On landing pages, jump to Embed Act-On Form on Website.


Configure Act-On Landing Page for Form

  1. Content > Landing Pages > Edit landing page that hosts previous form.

    Screen Shot 2021-05-13 at 4.22.42 PM

  2. Add the KickFire Enrichment Script to the landing page one of the following 3 ways:
    1. Upload KickFire Enrichment Script File:
      On the Design tab, under Settings, select Edit Javascript.

      Screen Shot 2021-05-13 at 4.22.48 PM
      Click on + to upload KickFire Enrichment Script. Select file and click Submit.
      Click OK > Save > Close
    2. Copy & Paste KickFire Enrichment Script file:
      On the Design tab, under Settings, select Edit Javascript.

      Screen Shot 2021-05-13 at 4.22.48 PM
      Paste KickFire Enrichment Script in the Edit Javascript default.

      Screen Shot 2021-05-13 at 4.22.56 PM

      Click OK > Save > Close
    3. Copy & Paste KickFire Enrichment Script file in Form Load JS field:
      Click on existing form block to edit.
      Under Edit Form Block, click Form Load JS and paste KickFire Enrichment Script.
      You do not need to include <script type=”text/javascript”></script> tag.

      Screen Shot 2021-05-13 at 4.23.02 PM
      Click OK > Save > Close.
  3. Continue to Confirm KickFire Data Is Collecting in Act-On.

     

    Embed Act-On Form on Website

    1. Content > Forms > Select existing form containing KickFire hidden fields > Edit

      Screen Shot 2021-05-13 at 4.23.10 PM
    2. Click on the Embed tab > Embed Code

      Screen Shot 2021-05-13 at 4.23.18 PM
    3. Click Copy Code.
    4. On your website, replace the existing script with this new script.
    5. Add the KickFire Enrichment Script file to your webpage.
    6. If you are not using external form, continue to Confirm KickFire Data Is Collecting in Act-On.

     

    Enhance External Form with Act-On's Form Data
    1. Add KickFire hidden fields to external form.
      Screen Shot 2021-05-13 at 4.22.35 PM
    2. Content > Form Post URLs > Click Get Form Post URL

      Screen Shot 2021-05-13 at 4.38.29 PM
    3. Select existing form containing KickFire hidden fields. Give the form a Tag/Source Name for the URL and click Create.

      Screen Shot 2021-05-13 at 4.38.35 PM
    4. Check that the input Field Names on the external form and Act-On form match.
    5. On your webpage, add the external post URL to the form HTML as an “action” attribute. Example: <form action=“http://companyname.actonsoftware...001/d-ext-0001”>
    6. Rename Email field to: emailAddress and Company Name field to: company
    7. Add KickFire Enrichment Script to your webpage.


    Confirm KickFire Data Is Collecting in Act-On

    1. Contacts > Other Lists > Form Submissions

      Screen Shot 2021-05-13 at 4.38.41 PM
    2. Open the list associated with the form containing the KickFire hidden fields to review the collected data.
    3. Congratulations, your KickFire integration is complete!