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.

integrations-acton-01

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

    integrations-acton-02
  2. On the Design tab, drag and drop the Hidden Field block to the form.
    integrations-acton-03
  3. In Edit Hidden Field dialog box, create Label and Field Name. Repeat as needed.

    integrations-acton-04
  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.

    integrations-acton-05

  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.

      integrations-acton-06
      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.

      integrations-acton-06
      Paste KickFire Enrichment Script in the Edit Javascript default.

      integrations-acton-07

      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.

      integrations-acton-08
      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

      integrations-acton-09
    2. Click on the Embed tab > Embed Code

      integrations-acton-10
    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.
      integrations-acton-11
    2. Content > Form Post URLs > Click Get Form Post URL

      integrations-acton-12
    3. Select existing form containing KickFire hidden fields. Give the form a Tag/Source Name for the URL and click Create.

      integrations-acton-13
    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

      integrations-acton-14
    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!