How to Migrate Universal GA to GA4?

💡 Starting from July 1, 2023, Google Analytics (Universal GA) will no longer process new data in standard properties.

▶︎ Applicable Users

• Existing customers who have purchased the e-commerce solution, currently integrated with Universal GA, and are planning to migrate to GA4.
• New customers who have purchased the e-commerce solution and will directly integrate with GA4.

▶︎ Preparation:

If your brand is using the MAAC solution, specifically the MAAC e-commerce solution, please ensure that you have completed the necessary settings and switched to Google Analytics 4 properties. Also, confirm whether e-commerce-related data can be tracked.

• "Customer Journey - Purchase" data comes from "Checkout" behavior.
• "Cart Retargeting" data comes from "addToCarts."

After completing the setup and confirming that e-commerce-related data can be tracked, please contact the support team via the bottom-right corner or your designated CSM.

▶︎ Steps to Migrate from Universal GA to GA4

Method 1: Grant GA4 Authorization to Cresclab

➤ Share Google Analytics Access

1. Go to the GA dashboard > Click on Admin.
2. Click on "User Management."
3. 
4. Click on "+" and select "Add new users."
5. Enter the email provided by your CSM (e.g., [e-mail], please refer to the email from your CSM).
6. Check "Notify" > Select Permissions > Click "Add."
7. Provide the Property ID to Cresclab for setup.
8. Crescendo lab will complete the setup 🎉

Method 2: Brand to Call Crescendo lab API for GA4 Integration

➤ Step 1：

Verify Google or Google Workspace account’s [Account ID] & [Property ID] have access to the target GA4.

Follow these steps to check [Account ID] & [Property ID]:

[ Account ID ]

1. Go to the brand’s GA dashboard, click on "Admin" at the bottom left.
2. Click on "Account Settings."
3. Confirm the "Account ID."

[ Property ID ]

1. Go to the brand’s GA dashboard, click on "Admin" at the bottom left.
2. Click on "Property Settings."
3. Confirm the "Property ID."

➤ Step 2：Obtain MAAC login user token

• Use the API call format below to retrieve the MAAC login user token.

# request 
curl --request POST \ 
--url 'https://api.cresclab.com/accounts/v1/user/login/' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ 
"username": "<MAAC user name>", 
"password": "<MAAC user password>" }' 

# response 
{ 
"token": "<MAAC login user token>" 
}

🚨Attention：

• <MAAC user name> is your MAAC login username.
• <MAAC user password> is your MAAC login password.

➤ Step 3：Obtain MAAC OTP

• You need to provide ❶ GA4 account id, ❷ GA4 property id, & ❸ the URL of the tracked website (brand’s domain). Use the API call format below to retrieve MAAC OTP. After successful retrieval, save the OTP parameter and proceed to Step 4 for verification.

🚨Attention：

• The OTP is valid for only 240 seconds (4 minutes). Complete Step 4 as quickly as possible.

# request 
curl --request POST \ 
  --url 'https://api.cresclab.com/ga/v1/settings/otp' \ 
  --header 'Authorization: Bearer <MAAC login user token>' \ 
  --header 'Content-Type: application/json' \ 
  --data '{ 
  "account_id": "<GA4 account_id>", 
  "property_id": "<GA4 property_id>", 
  "website_url": "<Your GA website Url>" 
}' 


# response { 
"otp": "<otp>" 
}

➤ Step 4：Verify Authorization

1. Log in to the brand's GA4 dashboard.
2. Prepare the OTP from Step 3.
3. Open a new window, copy the URL below, and paste the OTP into the red text section. Then paste it into the new window.
   https://api.cresclab.com/ga/v1/settings/authorize?otp=<otp> 
   

4. After verification, a confirmation screen will appear.

   
   
5. Once the process is completed, notify Crescendo lab to proceed with the setup. (Please email [e-mail] or contact your Customer Success Manager.)