Skip to content

Shopify Integration Guide

This guide walks you through integrating Frak into your Shopify store using our official Shopify app. The app takes care of the technical plumbing — registration, tracking, webhooks — and guides you through a short wizard to install the Frak components on your storefront.

Quick Start with the Shopify App

The easiest way to integrate Frak with your Shopify store is through our official Shopify app available on the Shopify App Store.

Installation

  1. Visit the Frak app on the Shopify App Store
  2. Click "Add app" to install it to your Shopify store
  3. Follow the in-app onboarding wizard — it walks you through everything, from registration to theme customization

What the onboarding wizard sets up

Once installed, the app opens an onboarding wizard that drives the full setup. Some steps are fully automated, others are short manual actions inside the Shopify admin:

Automated steps (one click each)
  • Shop registration — links your store to Frak and creates your merchant on the Frak platform
  • Application pixel — installs the Frak web pixel so customer interactions can be tracked
  • Shopify webhook — subscribes to orders/updated so purchases are reported to Frak
  • Frak purchase tracker — connects the Shopify webhook to the Frak backend, so rewards can be processed
Manual steps (in the Shopify theme / checkout editor)
  • Frak Listener — enable the Frak Listener App Embed in your theme. This is required — it loads the Frak SDK and enables every other component
  • Frak Sharing Button — add the Share button to your product detail pages so customers can share and earn referral rewards
  • Frak Banner — add the Banner block to your theme to promote active campaigns and referral rewards
  • Checkout extension — enable the Frak post-purchase block in your Checkout Editor (Thank You & Order Status pages) to show a sharing card right after purchase

The wizard deep-links you directly to the right spot in the Shopify theme editor for each manual step, so no copy-pasting of snippets or code is needed.

Advanced Features and Analytics

Once your merchant is set up and fully onboarded through the Shopify app, you can access advanced features and detailed analytics through the Frak business dashboard.

What you can do in the business dashboard:

  • View detailed campaign statistics and performance metrics
  • Access advanced analytics for your referral and purchase campaigns
  • Configure advanced campaign settings and targeting options
  • Monitor real-time tracking and engagement data
  • Set up additional campaign types beyond the basic setup

Accessing the business dashboard:

  1. Go to business.frak.id
  2. Log in with the same account used during the Shopify app setup
  3. Navigate to your merchant to view detailed statistics and configure advanced settings

Need Help?

If you encounter any issues during the setup process:

  1. Check the in-app onboarding within the Shopify app — each step surfaces its own status and troubleshooting hints
  2. Contact support through the app if you need assistance
  3. Visit the business dashboard for advanced configuration and troubleshooting

The Shopify app streamlines the entire integration process, making it much easier to get started with Frak's referral and campaign features on your Shopify store.

Source Code

The Frak Shopify app is open source and lives inside the Frak wallet monorepo under apps/shopify. Open an issue or a PR if you want to contribute or report a bug.