HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityLog In

Cross-project events

This topic describes Optimizely Full Stack cross-project events, which help large optimization teams track consistent, program-level metrics across multiple projects.

Usually, an event lives and is tracked only in the project where it was created. Cross-project events help you track key events across all your Optimizely Full Stack projects.

With cross-project events, you can:

  • Track the same event across different projects to ensure consistency
  • Create a set of program-level metrics and reuse them for all your sites
  • Define metrics for a global component that crosses into property-specific events

📘

Note

Cross-project events require Optimizely 3.0+ SDKs (released after February 2019).
To check if global metrics (also called cross-project events) are available for your plan, see https://www.optimizely.com/plans/. For more information, reach out to your Optimizely account contact.

Imagine that your company has multiple web properties that are split into separate Optimizely projects. One set of program-level metrics are 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. In order to track this same metric in all properties, you'd ordinarily have to set it up in every project. With cross-project events, you can add the predefined event to any Optimizely project.

Plus, cross-project events do not affect snippet size! Just enable cross-origin tracking so project snippets can synchronize. And if you expect visitors to cross domains or top-level domains, you can use the waitForOriginSync API.

Create a cross-project event

If you have an Optimizely Enterprise account, cross-project events are automatically enabled in your projects. All your events will be cross-project events. Create an event as usual, and it will be available in projects for which you have a collaborator role.

Add a cross-project metric

By default, the rules configuration pane shows events in the current project. To include cross-project events:

  1. Navigate to Flags and select the flag you want.
  2. Under Rules, select your environment and select the experiment you want.
  3. Under Metrics, select All projects. Note you will only see cross-project events for which you are a collaborator.
Click to enlarge imageClick to enlarge image

Click to enlarge image

  1. Select your metrics to add them, and that’s it! Do not forget to click Save to confirm your changes.

Edit a cross-project event

To edit a cross-project event, you will need to navigate to the project where it was originally created. To find the project name, look under the event name in the Metrics dropdown in the flag rule configuration pane. Then, follow the steps in Create events to edit your event in the original project.

click to enlarge imageclick to enlarge image

click to enlarge image


Did this page help you?