Shopify Integration

Connect your Shopify store to AccessFuel to unlock powerful analytics including customer lifetime value (LTV), retention analysis, order tracking, and product performance insights.

Prerequisites

Before you begin, you'll need:

• A Shopify store with admin or staff access
• Your Shopify store URL (e.g., mystore.myshopify.com)

Connection Methods

AccessFuel supports two ways to connect Shopify:

1. OAuth Connection (Recommended) - Quick and secure, no technical setup required
2. Custom App Setup - For advanced users who need custom API configurations

Setup Guide: OAuth Connection (Recommended)

The OAuth method is the fastest and most secure way to connect Shopify to AccessFuel. It takes less than 2 minutes and requires no technical configuration.

Step 1: Navigate to Integrations

1. Log in to AccessFuel Console
2. Go to Settings → Integrations → Shopify
3. Enter your Shopify store URL (e.g., mystore.myshopify.com)
4. Click the Connect button

Step 2: Authenticate with Shopify

1. A popup window will open showing Shopify's authorization page
2. Review the permissions requested (read-only access to your store data)
3. Click Install app to grant AccessFuel access

Step 3: Verify Connection

1. You should see a green "Connected" status
2. Data sync will begin automatically
3. Initial data may take a few hours to appear in your dashboard

---

Setup Guide: Custom App (Alternative)

The Custom App method is useful when you need to manage credentials at the organization level or when OAuth authentication isn't suitable for your organization.

Follow these steps to connect using a Custom App:

Custom App Step 1: Access Shopify Admin

1. Log in to your Shopify Admin Dashboard
2. Make sure you have admin permissions for your store

Custom App Step 2: Create a Custom App

To connect AccessFuel to your Shopify store, you'll need to create a custom app:

1. From your Shopify admin, go to Settings → Apps and sales channels
2. Click Develop apps (you may need to enable custom app development first)
3. Click Create an app
4. Name your app "AccessFuel" and select yourself as the app developer
5. Click Create app

Custom App Step 3: Configure Admin API Scopes

Your app needs specific permissions to access your store data:

1. In your app settings, click Configure Admin API scopes

2. Select the following scopes:

   Customer Data:

   • read_customers - View customer information
   • read_customer_events - View customer events

   Order Data:

   • read_orders - View orders
   • read_draft_orders - View draft orders
   • read_order_edits - View order edits

   Product Data:

   • read_products - View products
   • read_product_listings - View product listings
   • read_inventory - View inventory

   Additional Scopes:

   • read_locations - View store locations
   • read_price_rules - View discount codes
   • read_checkouts - View abandoned checkouts
   • read_fulfillments - View fulfillment data

3. Click Save to apply the scopes

Custom App Step 4: Install the App

1. Click Install app to install it to your store
2. Review the permissions and click Install
3. The app is now installed and ready to generate credentials

Custom App Step 5: Generate Access Token

1. In your app settings, go to API credentials
2. Under Admin API access token, click Reveal token once
3. Copy and save this token securely - you won't be able to see it again
4. Also copy your API key (Client ID) and API secret key (Client Secret)

Custom App Step 6: Gather Your Store Information

You'll need the following information:

• Shop URL: Your myshopify.com URL (e.g., mystore.myshopify.com)
• Client ID: Your API key from Step 5
• Client Secret: Your API secret key from Step 5
• Access Token: The Admin API access token from Step 5

Custom App Step 7: Send Us the Credentials

Enter the following in Settings > Integrations:

• Shop URL: Your myshopify.com URL (e.g., mystore.myshopify.com)
• Client ID: Your Shopify API key
• Client Secret: Your Shopify API secret key
• Access Token: Your Admin API access token
• Start Date (optional): The date from which you want to sync data (format: YYYY-MM-DDTHH:mm:ssZ)

What Data Gets Synced?

Once connected, AccessFuel will sync the following data from your Shopify store:

Essential Data

• Orders: Complete order details including line items, totals, and status
• Customers: Customer profiles, contact information, and purchase history
• Products: Product catalog, variants, and pricing
• Transactions: Payment transactions and refunds
• Inventory: Stock levels and inventory tracking

Additional Data

• Collections: Product collections (custom and smart)
• Abandoned Checkouts: Cart abandonment data
• Fulfillments: Shipping and fulfillment information
• Discount Codes: Promotional codes and usage
• Locations: Store locations and inventory allocation
• Customer Journey: Attribution and customer journey data

Data Refresh Schedule

• Frequency: Data syncs every 24 hours
• Historical Data: All data from your specified start date (or all available history)
• Incremental Updates: Only new and updated records are synced after the initial load
• Real-time Updates: Not available; data reflects the previous day's activity

Features Enabled

Connecting Shopify unlocks these AccessFuel features:

• Customer Lifetime Value (LTV): Track 30-day, 90-day, 180-day, and total LTV
• Retention & Cohort Analysis: Understand customer retention patterns
• Order and Revenue Tracking: Monitor sales trends and performance
• Product Performance Analytics: Identify top-performing products
• Customer Segmentation: Create targeted customer segments
• Churn Prediction: AI-powered churn risk analysis

Troubleshooting

OAuth Connection Issues

Popup Blocked

If the authentication popup is blocked:

1. Check your browser's popup blocker settings
2. Allow popups from app.accessfuel.com
3. Try clicking the Connect button again
4. If using Safari, enable popups in Safari Preferences → Websites → Pop-up Windows

Authorization Failed

If you see an authorization error:

1. Ensure you're logging into the correct Shopify store
2. Verify you have admin or staff access to the store
3. Try using a different browser or clearing cookies
4. Contact your store owner if you need elevated permissions

Connection Expired

If your connection shows as expired or needs reauthorization:

1. Navigate to Settings → Integrations → Shopify
2. Click the Reconnect button
3. Re-authenticate with Shopify
4. Your data will continue syncing automatically

Store Not Found

If your store URL is not recognized:

1. Verify you entered the full myshopify.com URL (e.g., mystore.myshopify.com)
2. Ensure your store is active and not paused
3. Check for typos in the store URL
4. Try without the https:// prefix

Custom App Issues

Invalid Access Token

If your access token is invalid or expired:

1. Go back to your Shopify app settings
2. Uninstall and reinstall the app
3. Generate a new access token
4. Update the token in Settings > Integrations

Missing Permissions

If certain data isn't syncing:

1. Check that you've granted all required API scopes
2. Uninstall and reinstall the app with correct permissions
3. Generate a new access token after updating scopes

Data Not Syncing

Check the following:

1. Verify your Shop URL is correct (must be the full myshopify.com URL)
2. Ensure your access token is valid
3. Confirm all required API scopes are enabled
4. Check that your Shopify plan supports API access

Connection Errors

If you're experiencing connection errors:

1. Verify your credentials are correct
2. Check that the custom app is still installed
3. Ensure the access token hasn't been revoked
4. Contact support if the issue persists

Security & Privacy

• Token Storage: Access tokens are encrypted and stored securely
• Data Transmission: All data is transmitted over HTTPS with TLS 1.3
• Access Control: Only authorized AccessFuel team members can access your credentials
• Compliance: We comply with GDPR, CCPA, and Shopify's data protection requirements
• Data Retention: Data is retained according to your organization's settings

Related Resources