Google Analytics integration

Developer assistance needed

Google Analytics User ID feature lets you collect and apply comprehensive user data by connecting multiple data resources to the same users. Connect Pushwoosh with Google Analytics and use GA data for audience segmentation and targeting your push notifications campaigns. Lets see how it works.

To enable User ID feature in your Google Analytics account, follow the Google guide: https://support.google.com/analytics/answer/3123666

Note

Note

To integrate Pushwoosh SDK in your Google Tag Manager, follow the Web Push SDK guide.

Create a Custom HTML Tag firing on All Pages trigger.
Use the following code to set up User ID that matches the user data between Pushwoosh and Google Analytics.

In the example below, we use Pushwoosh Hardware ID (HWID) to set up User ID. You can use a different identifier, but be aware not to put email addresses or any other personally identifiable information (PII) into User ID as this is not compliant with Google Analytics Privacy Policy.

<script>
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var registrationId = localStorage.deviceRegistrationId;
  var gaRegistered = registrationStatus === 'registered' ? registrationId : false;

  if (!gaRegistered) {
    var Pushwoosh = Pushwoosh || [];
    Pushwoosh.push(['onPermissionGranted', function(api) {
      api.getParams()
        .then(function(params) {
          var hwid = params.hwid;
          ga('set', 'userId', hwid);
          ga('send', 'pageview');
          localStorage.setItem('deviceRegistrationId', hwid);
          api.registerUser(hwid);
        })
    }])
};
</script>

Modify your Page View tag to include User ID if it is known for the user:

<script>
  var hwid = localStorage.deviceRegistrationId;
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var isNeedToTrackUser = hwid && registrationStatus === "registered";

  if (isNeedToTrackUser) {
    ga('set', 'userId', hwid);
  };
  ga('send', 'pageview');
</script>

To test the integration, use User ID coverage report:
https://support.google.com/analytics/answer/3123670

Note

Select your User ID reporting view in Google Analytics. Add any segments there to slice and dice your audience.

You can see your User IDs displayed in the User ID column. Use the Export button and select the CSV option to download the list of User IDs.

To send a push to users from your GA audience, use One-Time Push and at the Audience step choose Import segment. Upload the CSV file you exported from Google Analytics and map the column that contains User IDs to the User ID field. Learn more