Access custom code contextual information

Harness event data from the payload object to customize user experiences and perform event-based functions

When a placement executes custom code as an experience or a trigger executes a Custom Code action, you can access the payload object containing contextual information related to the event that triggered the code execution. This payload allows you to employ relevant data to customize the user experience, enhance analytics, and perform other functions based on the event details.

Common Use Cases

PropertyUse Case
payload.analytics.outcomeId
  • Reporting
payload.placementId
  • Reporting
  • Obtaining a reference to the <div> element in which the experience is nested


Retrieve contextual information

Follow these steps to retrieve contextual information:

  1. In the custom code block in your JWX dashboard, add the following code.

    Be sure to replace the <PROPERTY> placeholder with the payload property to be retrieved.

    console.log(payload.<PROPERTY>);

  2. Use the value of the property within the custom code.



payload reference

payload: {
  placementId: "abcd1234",
  analytics: {
    embedId: "cd3e43f3",
    evaluationId: "j4hncv8a",
    outcomeId: "kn349ng3"
  },
  eventEmitter: {<various>},
  eventEmitterType: {<various>},
  eventPayload: {<various>}
}
Property Description
analytics object Collection of unique identifiers related to a Dynamic Strategy Rule branch and its conditions

See: analytics
eventEmitter object (Trigger-executed custom code) Instance of the experience emitting the event
eventEmitterType string (Trigger-executed custom code) Type of experience emitting the event

Possible Values:
  • player
eventPayload object (Trigger-executed custom code) Event metadata included in the underlying event

For example, if the event is a JWX ad Impression, eventPayload would be the event metadata received when using jwplayer.on('adImpression', function(e) {...}), where e is the event metadata.
placementId string Unique identifier for a placement

This is the primary key used when embedding a placement within a publisher's page.

See also: Placement ID

analytics

PropertyDescription
embedId string

Unique identifier generated for each placement instance that is embedded on a page



See also: Placement Embed ID

evaluationId string

Unique identifier generated for each evaluation of a placement on a page



See also: Placement Evaluation ID

outcomeId string

Unique identifier for a strategy outcome



See also: Strategy Outcome ID



Did this page help you?
© 2007- Longtail Ad Solutions, Inc.