Retrieving Information Required by Apollo

1. In order to link your Google Analytics and Tag Manager Accounts to your Apollo property, there is some information you will need to collect from these accounts.

1.1 Obtain the Google Tag Manager Account Id. Go to https://tagmanager.google.com/ and login.

1.1.1 Find the account you would like to connect with Apollo. Click the three-dotted menu button in the right corner and select Account Settings:

1.1.2 You will find the Account Id listed under Account Settings:

1.2 Obtain the Google Analytics Account Id. Go to https://analytics.google.com/ and login.

1.2.1 From the left side panel, open the menu and click Admin.

1.2.2 From the Admin page, ensure the desired account is selected using the carrot and click Account Settings.

1.2.3 You will find your Account Id under Basic Settings.

1.3 Obtain your Google Analytics Property Id. From the left side panel open the menu and click Admin.

1.3.1 From the Admin page, select the desired account and property using the carrot found in either section. You will find the Property Id in parentheses next to the Property Name.

Create an Apollo Property for Google Implementations

2 Go to https://app.apolloplatform.com/login and log in with your Apollo account.

2.1 On the left side of the screen click Properties.

2.2 Next, click Add New Property in the right corner.

2.3 Fill in the Property name. Then, select Google Tag Manager/Google Analytics under Platform and click Next.

2.4 Review the pop-up dialog and confirm, if you accept. At this point, your new Apollo property has been created.

Add Data Layer Details for your Google Apollo Property

3 Input the Data Layer Name. Since most Google Tag Manager implementations leverage the dataLayer object, this field is automatically configured with dataLayer. However, you can edit this as needed.

3.1 At this time, you can also connect to your GitHub repository. Clicking the Connect to GitHub button will redirect you to their authentication portal. This can also be done later from Property Settings.

3.2 When you are done, click Next.

Import your Google Cloud Service Account Credentials

4 Fill in the Connection Name.

4.1 Fill in the GTM Account Id that was obtained at step 1.2.

4.2 To populate the rest of the fields, click Import your JSON Keyfile. Open the JSON file containing the private key for your Google Cloud Service Account as described in Step 7 of the Instructions for Setting Up Google Cloud API Connections. Copy the contents of the file, paste them into the JSON Keyfile text box, and click Parse.

4.3 If the credentials are parsed and formatted correctly, every input field will be highlighted in green. Click Test, and wait for several seconds. If the credentials are correct and the API connection succeeds, a popup with a confirmation message will appear.

4.4 When you have a working connection, click Next.

Configure your Google Analytics Settings

5 Now that we are connected to your Google Cloud Service Account, you can select which Google Analytics account and property you would like Apollo to use.

5.1 Select the desired Google Analytics account under the Account dropdown. This field is mandatory.

5.2 Indicate whether this account is Standard (free-tier) or Analytics 360 (enterprise-level) under the Account Type dropdown. This field is also mandatory.

5.3 Finally, select the desired Google Analytics property under the Property drop down. This field is optional.

5.4 When you are done, click Finish to create your property setup.

Adding additional Google Cloud Service Accounts

Other users within your organization will need to associate their own Google Cloud Service Account with the Apollo Property if they wish to deploy builds. Ensuring each user has a separate connection allows you to maintain a record of who has deployed from Apollo and prevents you from hitting the API limits for any given Google Cloud Project.

13. Have each Apollo user follow the steps listed in the Instructions for Setting Up Google Cloud API Connections.

13.1 After each user has created a Google Cloud Service Account, they can navigate to Property Settings by clicking the gear icon in the global navigation:

13.2 From the Property Settings drawer, click Connections -> Add a Connection. Then follow steps 4-4.3 and click Save.

13.3 Your connection will be tested after you click Save. If the connection succeeds, a pop-up with a confirmation message will appear.