> For the complete documentation index, see [llms.txt](https://docs.shoffi.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoffi.app/for-app-owners/google-analytics-integration.md).

# Google Analytics integration

{% hint style="info" %}
**Please Note!**\
This is a complete guide to creating a Google Analytics account for your Shopify app listing and connecting it to Shoffi. If you’ve already set up Google Analytics for your app listing, jump to [#connect-to-shoffi](#connect-to-shoffi "mention").
{% endhint %}

### Jump to

[#setup-google-analytics](#setup-google-analytics "mention")

[#connect-your-shopify-app-listing](#connect-your-shopify-app-listing "mention")

[#connect-to-shoffi](#connect-to-shoffi "mention")

## Set up Google Analytics

### 1. Set Up or Access Your Google Analytics Account

Visit [analytics.google.com](https://analytics.google.com) and sign in using your Google account credentials.

### 2. Navigate to the Admin Section

<div align="left"><figure><img src="/files/eFIPjdHx58VoKyMcV6PI" alt=""><figcaption></figcaption></figure></div>

Click on the gear (cog) icon located at the bottom left to access the Admin panel.

### 3. Initialize a New Account

If you are starting a fresh account, you can skip the initial setup. Otherwise, click the **Create** button and select **Account**.

<div align="left"><figure><img src="/files/8kUhv7PZldHY3B206SGC" alt=""><figcaption></figcaption></figure></div>

### 4. Provide an Account Name

Enter a suitable name for your account and then click **Next** to proceed.

<figure><img src="/files/HOOa8wM4X9YM2XEmfBUP" alt=""><figcaption></figcaption></figure>

### 5. Specify Property Details

Input a name for your property, choose the appropriate timezone and currency, and then click **Next**.

<figure><img src="/files/ECCcvAtTaZownTxwHsdr" alt=""><figcaption></figcaption></figure>

### 6. Enter Business Information

Fill in your business category and size, then click **Next** to continue.

### 7. Define Business Objectives

Select the relevant business objectives that align with your goals and click **Create**.

### 8. Accept Google Analytics Terms of Service

Choose the terms applicable to your region. When ready, accept the terms by clicking the **I Accept** button.

### 9. Set Up Data Collection

Add a data stream to collect data from Shopify for your application. Select the **Web** platform.

<figure><img src="/files/KyOTNeLrakXRqP9KtxGj" alt=""><figcaption></figcaption></figure>

### 10. Create a Web Stream

Enter your Shopify app’s URL, assign a name to the stream, and then click **Create and continue**.

{% hint style="warning" %}
**Please Notice!**\
Make sure the "Website URL" is the full URL of your app listing, including the slug (ex. <https://apps.shopify.com/my-demo-app>).
{% endhint %}

<figure><img src="/files/F8byeuZGdQvu2eylHlo6" alt=""><figcaption></figcaption></figure>

### 11. Record the Measurement ID

Take note of the Measurement ID as this will be necessary for integration with Shopify via the Partner portal.

<figure><img src="/files/EXxvRoqngHp9Mk7d0eHa" alt=""><figcaption></figcaption></figure>

### 12. Obtain the API Secret

On the same page, retrieve the API Secret by clicking on **Measurement Protocol API secret**.

<figure><img src="/files/QeERN91quz0KrZXsi0nO" alt=""><figcaption></figcaption></figure>

### 13. Generate the API Secret

You may need to review and accept the terms first.

Next, click the **Create** button.

Assign a nickname to the API secret, such as “Shopify App Listing,” and click **Create**.

Ensure you save the secret value (API Secret) for future use.

<figure><img src="/files/uhMJOBBA44pNTS9jRs68" alt=""><figcaption></figcaption></figure>

## Connect your Shopify app listing

### 1. Access the Shopify Portal

Log in at [partners.shopify.com](https://partners.shopify.com).

### 2. Select Your App

From the left-hand menu, choose **Apps**.

Select your specific app.

<div align="left"><figure><img src="/files/U3ZeGCbHwCsRm06aprn2" alt=""><figcaption></figcaption></figure></div>

Navigate to **Distribution** in the left menu.

<div align="left"><figure><img src="/files/nMBxloTavUoRLqeGUpZQ" alt=""><figcaption></figcaption></figure></div>

Click on the **Manage Listing** button.

<div align="left"><figure><img src="/files/oZwbzNistRzOybaRez5M" alt=""><figcaption></figcaption></figure></div>

Now click **Edit** on your primary listing.

<figure><img src="/files/qZIzBxHX7SuopZtqGoII" alt=""><figcaption></figcaption></figure>

### 3. Input Google Analytics Details

Scroll to the **Tracking Information** section and enter your Measurement ID and API Secret in the designated fields. After entering the information, click **Save**.

<figure><img src="/files/6cg68FaCftlTa5AUE2Vl" alt=""><figcaption></figcaption></figure>

## Connect to Shoffi

### 1. Configure Custom Definitions

Custom definitions allow you to collect additional data, such as identifying which store is installing your app.

First, click the gear icon to return to the main Admin page.

Next, select **Custom Definitions**.

<figure><img src="/files/96h5agc8VsyAfQuXt0Jb" alt=""><figcaption></figcaption></figure>

Click on **Create Custom Dimension**.

<figure><img src="/files/UJjEFyWso1tQ3KjS9y4h" alt=""><figcaption></figcaption></figure>

Enter `shop_url` in both the **Dimension Name** and **Event Parameter** fields, then click **Save**.

<figure><img src="/files/cLergXdgc4l0eBOXxOCY" alt=""><figcaption></figcaption></figure>

Repeat this process to add another custom dimension called `ga_session_id`.

<figure><img src="/files/2JMIVVsA5dyIZ6P5s1e9" alt=""><figcaption></figcaption></figure>

Once you finish, you should see both custom definitions listed:

<figure><img src="/files/t7IfWdoiUyTBn4wduDVk" alt=""><figcaption></figcaption></figure>

### 2. Give read-only access to Shoffi

{% hint style="info" %}
Note!\
The Analytics integration section appears only after you verify your Shopify Partners details.
{% endhint %}

Navigate to your Shoffi `New app` or `Edit app` page.

Click the **Connect Google Analytics** button and select the Google account you used earlier to create your Google Analytics account.

<div align="left"><figure><img src="/files/Ba5kqBOHNZeFN2CtfZdO" alt=""><figcaption></figcaption></figure></div>

### 3. Approve Access to Shoffi

<div align="left"><figure><img src="/files/Pib1eHmDPraNiSIn0f4K" alt=""><figcaption></figcaption></figure></div>

A pop-up appears and asks you to approve read-only access.

By clicking **Approve**, you grant us permission to read your Google Analytics data.

### 4. Integration Completed

Once the integration is successfully completed, you’ll be redirected back to Shoffi, and your app will be automatically approved.

<figure><img src="/files/pis9zZy9bpgVlUt89NG1" alt=""><figcaption></figcaption></figure>