Prerequisites for configuring a Google Analytics data source

Before you can set up a Google Analytics data source, you must establish the Search, Social, & Commerce query string parameter “ef_id” as the primary key to pass data from Google Analytics to Search, Social, & Commerce. Set up the primary key for each Google Analytics account and property combination for which you want sync data. Other people in your organization may need to complete these tasks; see below for more information.

If the landing page URLs for your ads or keywords don’t already include Search, Social, & Commerce redirects, then add them first.

Prerequisite 1: Implement a Search, Social, & Commerce token (“ef_id” query string parameter) in the landing page URLs for all applicable advertising accounts

On each paid search click for the relevant campaigns, a unique ef_id must be generated and appended to the landing page URL as a query string, such as https://www.adobe.com?someParam=123&ef_id=abcde:123456789:s, where &ef_id=abcde:123456789:s is the append symbol, ef_id key, and ef_id value. To include an ef_id, the relevant ad network accounts and campaigns must have the Tracking Type “EF Redirect” and the Redirect Type “Token.”

For existing accounts and campaigns, the ef_id is probably already implemented.

If the ef_id isn’t included, ask your Adobe Account Team for assistance.

When all prerequisites are completed, the ef_id is used as the primary key to pass data from Google Analytics to Search, Social, & Commerce.

Prerequisite 2: Capture the Search, Social, & Commerce token (“ef_id” query string parameter) in a custom dimension for each relevant Google Analytics property

Repeat the following tasks for each Google Analytics account and property combination for which you want to sync data. See Google Analytics documentation on creating and implementing custom dimensions for help with these tasks.

  1. In Google Analytics, create a custom dimension named “ef_id”. Set the scope of the dimension to User, and set the dimension to active.

    note note
    NOTE
    This prerequisite requires edit permission for the relevant properties.
  2. Update your Google Analytics tracking code to capture the value of the ef_id query string parameter when it’s present in the landing page URL and store it in the ef_id custom dimension.

    note note
    NOTE
    The ef_id should be only in landing page URLs.

    For example, if the landing page URL is https://www.adobe.com?someParam=123&ef_id=abcde:123456789:s&anotherParam=asdf, then the value of the ef_id dimension in Google Analytics is abcde:123456789:s.

    note note
    NOTE
    This prerequisite should be completed by a qualified developer.
recommendation-more-help
bba95088-f653-468b-a1c0-bd1dbc81025c