ConvertKit Add-on

Quick Reference

Overview

Logic Hop integrates with ConvertKit to provide personalization using your ConvertKit data. You can easily display any ConvertKit data and custom field on your website to create an engaging, personalized experience.

ConvertKit tags and custom fields can be used in Logic Hop Conditions to determine what content to display and when to display it.

ConvertKit tags can be added and removed and custom fields can be updated, incremented and decremented based on a user’s activity on your site.

Note: ConvertKit data is dynamically loaded via the ConvertKit API. If you have caching enabled, be sure to enable Javascript Mode in the Logic Hop Settings panel.

Learn more about caching.

Configuring ConvertKit

  • Install and activate ConvertKit Add-on plugin
  • Locate your ConvertKit API Key & API Secret found at:
    • ConvertKit Account > Account Info
  • ConvertKit Account Info
  • Enter your ConvertKit API Key & API Secret on the Logic Hop Settings page.

Note: Logic Hop will add a Custom Field titled LogicHop to your ConvertKit account. This Custom Field will be available to all of your ConvertKit subscribers to identify their accounts across devices and browsers.

After saving your ConvertKit API Key & Secret, check a ConvertKit subscriber and confirm the LogicHop field has been added.

ConvertKit Quick Start Guide

Step 1

Create a new page titled ConvertKit Test

Step 2

Add the following Logic Tag:

{{ if condition: convertkit }}
    <h2>Hello {% var: ConvertKit.first_name %}</h2>
{{ endif }}

Step 3

Visit the page in an incognito window and add the following query string (replace 1234 with one of your ConvertKit subscriber’s ID):

?ck_subscriber_id=1234

That’s all there is to it! You should see your test ConvertKit subscriber’s first name on the page.

Sending ConvertKit Data to Logic Hop

ConvertKit user data is made available to Logic Hop by passing identifying data appended to links from ConvertKit Forms and Broadcasts as query string values.

To automatically enable this for Broadcasts:

  • Visit ConvertKit > Email
  • Under Advanced check _Add subscriberid parameter in email links
  • Click Save Settings

ConvertKit Forms

Use the following ConvertKit form settings to enable data to Logic Hop for new users.

  • Check Send incentive / double opt-in email to confirm new subscribers
  • Select Thank you page: URL
  • Check Special Options: Send subscriber data to Thank you page
  • Append ?convertkit=true to the Thank you page URL
    • Example: http://yoursite.com/thank-you/?convertkit=true

ConvertKit will automatically append the user’s subscriber to the URL. ConvertKit data is available to Logic Hop after users confirm their subscription.

Displaying ConvertKit Data

Logic Hop provides a variety of integration points for ConvertKit. One of the most useful is displaying ConvertKit user data within WordPress content using Logic Tags.

Display ConvertKit Data with Logic Tags

Logic Tags can be added from the Logic Hop tool in the WordPress Page/Post editor. Click the Data tab, select a value and click Insert Variable.

Like all Logic Tags for data, the ConvertKit Logic Tag is a single block of code which appears as:

{{ var: ConvertKit.first_name }}

If the data is available for the user, it will be displayed on the page. Logic Tags can be nested within HTML tags and also within Logic Tag conditions.

To check if data is available before display, use the default condition ConvertKit Data Is Available for User:

{% if condition: convertkit %}
    Hello {{ var: ConvertKit.first_name }}
{% endif %}

View the full list of ConvertKit variables.

Note: ConvertKit data is dynamically loaded via the ConvertKit API. If you are using caching make sure to enable Javascript Mode in the Logic Hop settings.

Using ConvertKit Data with Conditions

ConvertKit Tags and Custom Fields can be used as parameters in Logic Hop Conditions. The Logic Hop Condition Builder will display all Tags and Custom Fields available to your account. Conditions can test if a Tag has been set or not set and if a Custom Field is equal, or not equal to a specific value.

ConvertKit Condition Types

The Logic Hop Condition Builder will display all ConvertKit condition types available for use. Each can be used alone or combined with other condition types to create complex logic.

  • ConvertKit
    • Is ConvertKit data available
  • ConvertKit Tag
    • Is a ConvertKit Tag set or not set
  • ConvertKit Custom Field
    • Is a ConvertKit Custom Field set to a specific value

Learn more about Logic Hop Conditions

Setting ConvertKit Tags with Goals

As Logic Hop Goals are triggered, ConvertKit Tags can be set or removed. The Logic Hop Goal editor will display all Tags available to your account.

Tags

Select the option to Add or Remove a Tag and select the Tag to add/remove. When the Goal is triggered, the Tag will be added or removed for the user’s ConvertKit account.

Leave or set the Tag selectors blank to disable adding or removing Tags.

Learn more about Logic Hop Goals

Updating ConvertKit Custom Fields with Goals

As Logic Hop Goals are triggered, ConvertKit Custom Fields can be updated. The Logic Hop Goal editor will display all Custom Fields available to your account.

Custom Fields

Select the Custom Field to update, the update method and enter a value. When the Goal is triggered, the Custom Field will be updated for the user’s ConvertKit account.

Update Methods:

  • Set value to
    • Sets the Custom Field to the value specified
    • Any data type – Numeric, characters, spaces or punctuation
    • Any Logic Hop variables using Liquid-style markup:
      • {{LeadScore}}
      • {{Date.DateTime}}
      • {{QueryStore:#variable_name#}}
  • Increment value by
    • Adds the value specified to the current value of the Custom Field
    • Must be a number – Whole numbers or decimal numbers
    • If existing field value is not a number or is zero, it will be replaced by the value specified
  • Decrement value by
    • Subtracts the value specified from the current value of the Custom Field
    • Must be a number – Whole numbers or decimal numbers
    • Decremented values will stop at zero

Leave or set the Custom Field selectors blank to disable updating Custom Fields.

Learn more about Logic Hop Goals

ConvertKit Lead Scoring

With Logic Hop you can easily add Lead Scoring to ConvertKit and use it when selecting Subscribers for Broadcasts.

Add a Lead Score Custom Field

To add Lead Scoring, simply add a new Custom Field named Lead Score in ConvertKit.

Custom Fields can be added from any Subscriber page:

  • Click + Add a new field and type Lead Score in the Field name input
  • Click Update Subscriber

The Lead Score custom field is now available to all Subscribers and Logic Hop

Learn more about adding custom fields to ConvertKit.

Use Lead Scores with Broadcasts

To use Lead Scoring when creating Broadcasts, create a Filter Group and specify the Lead Score value to determine the recipients.

Filter Group are added on the Broadcast Recipients page:

  • Click + Add Filter Group
  • Click + Add Filter
  • Set the filter selector to Subscriber details
  • Select Lead Score for Choose subscriber details
  • Select a conditional operator – Is greater than, Is less than, etc
  • Enter the Lead Score value – 5, 10, 25, etc
  • Click Add Filter

Learn more about ConvertKit Subscriber filters.

Automatically Update Subscriber Lead Scores

Subscriber Lead Scores can be set, incremented or decremented when Logic Hop Goals are triggered.

The following Goal will increment the Lead Score value by 10 when completed.

Learn more about Logic Hop Goals.

ConvertKit Variable Reference

  • ConvertKitID
  • ConvetKit
    • id
    • first_name
    • email_address
    • created_at
  • fields
    • custom fields
  • tags
    • tags
  • gravatar
    • url
      • fullsize
      • large
      • medium
      • small
      • thumb
    • img
      • fullsize
      • large
      • medium
      • small
      • thumb