Cross-project events

  • Updated
  • Optimizely Web Experimentation
  • Optimizely Feature Experimentation
  • Optimizely Performance Edge 

Cross-project events help you track consistent, program-level metrics across multiple properties.

Usually, an event exists only in the project where you create and track it. Cross-project events let you do the following:

  • Track the same event across all Experimentation projects – Ensure consistency in how key actions are measured.
  • Standardize program-level metrics – Reuse metrics across your sites and applications.
  • Measure shared components – Define metrics for global components used across multiple properties.

For example, your company has multiple web properties split into separate Optimizely Web Experimentation and Optimizely Feature Experimentation projects. One set of program-level metrics is used to manage all the properties. For example, a key metric tracks engagement with the search bar in the enterprise site and all local store sites. To track this same metric in all properties, you would ordinarily have to set it up in every project. With cross-project events, you can add the pre-defined event to any Optimizely Web Experimentation or Optimizely Feature Experimentation project.

To ensure events are attributed correctly across projects, you must use the same user ID across all Optimizely Web Experimentation, Performance Edge, and Feature Experimentation projects. Consistent user identification is required for accurate cross-project attribution.

Cross-project events do not affect the Web Experimentation or Performance Edge snippet size. Enable cross-origin tracking to let project snippets sync correctly. If you expect visitors to cross domains or top-level domains, you can use the waitForOriginSync API.

Optimizely Performance Edge does not support the waitForOriginSync API, so cross-domain projects are not supported in Optimizely Performance Edge.

Optimizely Web Experimentation and Performance Edge

Create a cross-project event 

You can create events in any project where you have a collaborator role.

Add a cross-project event without the metrics module

  1. Go to an experiment.
  2. Click Metrics.
  3. Click Add Metric.
  4. Click All projects to display events from all your Experimentation projects.All Projects.png
  5. Click the event name.
  6. Click Save.

Edit a cross-project event 

  1. Find the project where you created the event. The project name is listed following the event name on the Metrics page within an experiment.

    Metrics - Project Name.png

  2. Go to the project where the event lives.
  3. Editing events is different if your account has the metrics module enabled.
    • If your account does not have the metrics module, go to Implementation > Events. Select and edit the event.alt
    • If your account does have the metrics module, go to Metrics > Events. Select and edit the event.
The metrics module is in beta. Contact your Customer Success Manager or Optimizely Support for information.

Optimizely Feature Experimentation

 See Cross-project events in the developer documentation for information about Feature Experimentation.