# Google Analytics integration

{% hint style="info" %}
**Please Note!**\
This is a complete guide to opening and setting up a Google Analytics account for your Shopify app listing and connecting it with Shoffi. If you’ve already set up your Google Analytics for the 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")

## Setup 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 Key, 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/1nDp1ImQ6hoJ6UgCt89m" alt=""><figcaption></figcaption></figure>

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

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

Once you finished, 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 will show up only after you verified your Shopify Partners details.
{% endhint %}

Navigate to your Shoffi's `new app`/`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 will show, asking you to approve the 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shoffi.app/for-app-owners/google-analytics-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.