Acquia Lift Push API reference

The Acquia Lift Push API allows you to receive information in real time when a visitor to your website enters a segment in which you're particularly interested. In the Profile Manager interface, you can enter an URL and associate specific segments to this location, so that whenever a person enters those segments, a notification containing information about the person, touch, event and matched segments is sent to the URL that you have chosen.

Using the Push API

The notification messages that the Acquia Lift service sends to an HTTP server will contain the following parameters:

Parameter Description Example
person Contains values for the fields in the Omnichannel person table anonymous_visitor, do_not_track
identifiers Contains values for the fields in the Omnichannel person_identifier table person_identifier_type_id, person_id
touch Contains values for the fields in the Omnichannel touch table engagement_score, number_of_page_views
event Contains values for the fields in the Omnichannel event table keywords, page_url
newMatchedSegments Contains values for the fields in the Omnichannel matched_segment table segment_id, and all of the new segments the visitor has entered during this touch
currentMatchedSegments Contains values for the fields in the Omnichannel matched_segment table segment_id, and all of the segments the visitor was in before this touch, including segments the visitor reentered during this touch

Configuring the Push API

To configure the Acquia Lift Push API, complete the following steps:

  1. Sign in to the Profile Manager interface, and then click the Admin tab.
  2. Click the Manage Configuration Data link.
  3. Click the Push API link.
  4. Click the Add new rule link.
  5. Configure the following settings:
    • Name - Enter the name of the new rule you are creating.
    • Endpoint URL - Enter the URL where you want the Acquia Lift service to send notifications.
    • Description - Enter a description of this particular push configuration for your own use.
    • Interval - Enter a number that corresponds with your selection in the Frequency criteria field: for example, if you want to push notifications triggered by the same website visitor every four hours, enter 4 in this field.
    • Frequency criteria list - Select how frequently you want to push notifications to be triggered by the same website visitor:
      • event - Receive notifications to your specified endpoint URL every time a visitor enters this segment.
      • touch - Receive notifications to your specified endpoint URL only for the first a visitor enters this segment during a particular touch.
        A touch is a series of contiguous events (such as content views) with a duration between events of no more than 30 minutes, and can can contain several events that are matched into the same segment. Choosing this option means that you will only receive a notification the first time an event in a touch matches a segment, and not when subsequent events in the touch match the segment.
      • minute - Set how many minutes you want to elapse between each push notification triggered by the same visitor.
      • hour - Set how many hours you want to elapse between each push notification triggered by the same visitor.
      • day - Set how many days you want to elapse between each push notification triggered by the same visitor.
        If you select minute, hour or day, you will receive a push notification only if the visitor re-enters the segment after this timeframe; no push will be sent if the visitor re-enters the segment before the set time has elapsed. For example, if you set the frequency criteria to 10 minutes, you would not receive a push notification if the visitor re-enters the segment after eight minutes, but would receive a notification if it occurred after 12 minutes.
  6. In the Segment Triggers section, in the Select a segment list, click the segment that you want to add to the Segment Triggers table.
  7. Click Add.
    The segment name, ID, and description will appear in the Segment Triggers table.
    A segment trigger means that if a website visitor enters the segment you have defined as a trigger, the Push API sends a notification to the endpoint URL. For example, you can define as a trigger a segment in which a visitor views two pages on your website. In this case, whenever a visitor views two pages on your website, the Acquia Lift service triggers a push notification to the endpoint URL.
  8. Click Save to save this configuration.

The Acquia Lift Push API will now begin sending notifications to your endpoint URL.

Deleting a segment

To delete a segment from the Segment Triggers table, complete the following steps:

  1. Sign in to the Profile Manager interface, and then click the Admin tab.
  2. Click the Manage Configuration Data link.
  3. Click the Push API link.
  4. In the Segment Triggers table, in Actions, click Delete to the right of the name of your segment.

Add new comment

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs break automatically.
  • Web page addresses and email addresses turn into links automatically.

Contact supportStill need assistance? Contact Acquia Support