Shoffi Docs
  • 👋Getting Started
  • 💻For App Owners
    • Adding a new app
    • Google Analytics integration
    • The affiliate terms
    • Managing affiliates
    • Invite affiliates
    • Paying affiliates
    • Managing your apps
    • Managing your team
    • Integrations (Webhooks)
  • 💳Subscriptions
    • Choosing/Upgrading a plan
    • Plan limits
    • Changing billing details
    • Downgrade and cancellation
    • Frozen and Deactivated accounts
  • 🔀The Shoffi API
    • Introduction to Shoffi API
    • Get All Affiliates
    • Get Affiliate Info
    • Create New Affiliate
    • Update Affiliate Terms
    • Affiliate Payment Request
  • 🔗For Affiliates
    • Connecting to new apps
    • Referral links
    • Manual referrals
    • Payout requests
    • Performance analytics
    • Connected app Information
  • General
    • The markets
    • The affiliate commision
    • Disputes
Powered by GitBook
On this page
  • The New App Form
  • App Settings
  • Affiliate Terms
  • App Details
  • Authentication
  • App Resources (Optional)
  • The app integration process
  • Partners API connection
  • Google Analytics Integration
  • The POST request (Deprecated)
  • Intigration status
  1. For App Owners

Adding a new app

PreviousGetting StartedNextGoogle Analytics integration

Last updated 1 month ago

Good to know: While you control multiple affiliate programs from the same dashboard, you set up each individually. That allows you to set different affiliate terms (ex., Commission Rate) for each app.

The New App Form

Go to the 'My Apps' page and click on the 'Add a new app' button. You will be redirected to the new app page.

App Settings

Set your app's setting per your prefeence. The settings can be changed anytime later from your dashboard.

Affiliate Terms

The contract details between an app and an affiliate. You can find a detailed explanation of

App Details

  • App name: The exact name is shown on the App Store.

  • App Logo:

    A .png file of your logo. A 125x125 is recommended.

  • Shopify App Store Listing Link:

    eg. https://apps.shopify.com/YourApp

  • App Support Email:

    Your affiliates will use this email if they want to contact you

  • App Category:

    Your App category, as it is on the Shopify app store. If you can't find the right one, choose 'other'.

Authentication

  • Partner ID:

    Find it under Settings > Account information

  • Partners API Client Access Token:

Important! Shoffi requires API permissions for your app so we can tell if an install was made using a referral link and calculate the earning and commission rates correctly.

Those permissions grant us a 'Read only' access, which we use only to read the information relevant to the Shoffi platform.

When creating a new API client, please approve permissions to:

  • View financials

  • Manage apps

App ID:

  • Go to your app page on the partner admin and copy it from the URL.

    For example:

    https://partners.shopify.com/1111111/apps/1234567#/

    1234567 is your app ID.

App Resources (Optional)

Add links to a public Google Drive, YouTube channel, or any other platform where your affiliate partners can find resources and tutorials to help them learn and promote the app.

The app integration process

Partners API connection

To submit the 'new app' form, you must validate the connection to your Shopify Partners API to ensure the details you've entered are correct. If one of the fields is wrong or you need to add the correct permissions, you will get an error explaining precisely what went wrong.

Google Analytics Integration

To complete the integration, you will need to connect your Google Analytics property. Later on, this request will allow us match which affiliate is associated with each install, if any.

The POST request (Deprecated)

If you signed up to Shoffi in the past, and still using the old matching method using a POST request, we highly recommend start using the new Google Analytics method. You can do that by navigating to your app under "My apps" page, clicking "Edit app" and adding the Google Analytics details.

Shoffi will still support the POST request method for apps that were approved in the past until October 1st, 2025.

Intigration status

You can find the status of your app integration on the "My Apps" page. There are three different integration statuses:

  1. Initiated

    The connection with the Partner API was successful. Waiting for Google Analytics integration.

  2. Under review If you deleted and reactivated your Shoffi account, your apps will be under review for up to 48 hours.

  3. Completed

    Your app was approved and is now live on Shoffi.

  4. Deactivated If you closed your account or, for some reason, your app is not activated anymore.

We don't read any data that was before your integration with Shoffi. You can find more information about the .

If it's your first time making a Partner API key, follow

Shoffi requires a "read-only" access to your GA property that is connected to your Shopify App Store listing. .

💻
Partner API permissions here
Shopify's guide here.
Find here the complete inegration guide
the affiliate terms here.