klaviyo/magento2-extension

There is no license information available for the latest version (2.0.0) of this package.

Klaviyo extension for Magento 2. Allows pushing newsletters to Klaviyo's platform and more.

Installs: 99 207

Dependents: 0

Suggesters: 0

Security: 0

Stars: 14

Watchers: 45

Forks: 25

Open Issues: 13

Type:magento2-module


README

Klaviyo extension for Magento 2. Allows pushing newsletters to Klaviyo's platform and more.

Features

  • Identifies users

    • Go to sign in or create account
    • Sign in or create account
    • Go to another page and inspect source for identify call with email, firstname, and lastname
  • Tracks viewing an item (catalog product)

    • Only will work if user is signed in
    • Inspect page source, find learnq snippet and see what PHP is echoing out
    • Should be a Viewed Product track call with product details
  • Saves checkout emails

    • Add some items to your cart and go to checkout page
    • In console see: Klaviyo_Reclaim - Binding to #customer-email
    • Change email
    • See Klaviyo_Reclaim - Quote updated with customer email: your.name@klaviyo.com
    • Make sure AJAX call comes back with checkout / quoute JSON
  • Sync Newsletter (Un)Subscribes to a Klaviyo List

    • This feature covers workflows where a Customer (un)subscribes from the following places:
      • Box at the bottom of every page
      • On account creation
      • Through their account settings
      • Through Customer Newsletter settings on the admin side
  • Abandoned Cart

    • Given a quote ID, a URL can be crafted that will load a Customer's cart with a quote

Prerequisites

Magento 2

Setup

  • From admin:
    • Go to stores > configuration
    • Find Klaviyo in sidebar
    • Open General
    • Enable Klaviyo
    • Add 6 digit Klaviyo public API key
    • For syncing Newsletter Subscribe/Unsubscribes: also add your Klaviyo private API key
    • To enable error logging: set "Enable Klaviyo Logger" to "Yes"
    • Save config
  • For syncing Newsletter Subscribe/Unsubscribes:
    • Open Newsletter from the sidebar
    • The page should load with your lists from Klaviyo
    • Select a list
    • Save config
  • To setup API credentials for the integration
    • Open Setup Klaviyo User from the sidebar
    • Enter the username, password, and email for the credentials
    • Save config

Making updates

  1. Follow Klaviyo's standard process of making a pull request and getting it reviewed before merging.
  2. Update CHANGELOG.md. Details on formatting the changelog (including categorizing changes) can be found here: keepachangelog.com
    1. If this is a change that will not immediately get sent along to Magento i.e. not a version update:
      1. Add any changes under the [Unreleased] section. This will be a comparision of the most recent commits to the latest tagged version.
    2. If this is a version update:
      1. Make sure to increment the version in two places:
        1. module.xml
        2. composer.json
      2. Add a new version between [Unreleased] and the most recent version. Include the incremented version number following semantic versioning practices and the date. Add your changes under this version.
      3. Move any unreleased changes into your version update under the appropriate categories.
      4. Update the [Unreleased] link to point from your new version to HEAD e.g. if you're updating to version 1.0.2 you'd update the link from 1.0.1...HEAD to 1.0.2...HEAD.
      5. Add a link to your new version. The tag won't yet exist but you can create a link to the tag you will create shortly. Follow the pattern of previous links.
  3. Upon approval merge your changes into master.
    1. If this is a version update:
      1. Checkout the master branch locally, make sure to pull down any changes that were just merged.
      2. Use git log to find the merge commit's checksum.
      3. Tag this commit with the version you just incremented: git tag -a {version} aeb8c682cebe7acee94506d3e4bfff2e5755e8c1 or just use git tag -a {version}.
      4. Push the tag to the remote repository: git push origin 1.0.1 replacing with the version you've just tagged.

Support

Contact extensions@klaviyo.com