Mapp: BlueHornet

BlueHornet

Connect with BlueHornet to import and export your subscribers and activity.

Authentication

  1. Navigate to the BlueHornet app in the integrations section of Lytics.
    bluehornet

  2. Navigate to the Authorizations section.
    Authorizations section

  3. Click the New authorization button.
    New authorization

  4. Create a new API user in BlueHornet if you have not already done so.
    create API user

    1. To manage (and create) BlueHornet API Users, log in to eMS Enterprise as an administrator and then navigate to Administration > API Settings > Manage API Users.
    2. Click on the Create API User button.
    3. Enter API user details. Lytics requires full API access.
    4. Add Lytics IP addresses to the list of allowed IPs. Contact your Account Manager for the current list of Lytics' IP addresses.
    5. Click Save
    6. Take note of your API key and secret. You'll need them later.
  5. Authorize BlueHornet by configuring your API key and secret. If you do not know your API key or secret, you can retrieve them from BlueHornet.
    BlueHornet authorization setup

    1. Your BlueHornet API key and shared secret can be found under Administration > API Settings > Manage API Users of the BlueHornet administrators' interface.
    2. Select the user you want and click the API Keys button to display the user's API Key and API Secret.

Importing data to Lytics

Summary
FrequencyOne-time only /Activities Hourly; Subscribers Daily
Streamsbluehornet_subscribers, bluehornet_activity
User fieldsemail, first_name, last_name, location, home phone, work phone, custom fields
Provider fieldsgroups subscribed
User activitysends, opens, clicks, unsubs, bounces
Campaign contentno
  1. Authorize Lytics with BlueHornet, if you have not previously done so.
  2. Select Import List from the list of workflows available.
  3. Select the authorization you want to use for this import.
  4. From the Segments multi-select, select the segments you want to import subscribers and activity from. If no segments are selected all subscribers and activity will be imported. Note: Activity for all messages that were sent to the selected segment will be imported. This will include activity for users in segments other than the selected one that the message was sent to.
  5. Under the Advanced tab, select the One time subscribers/unsubscriber sync checkbox to import your subscribers/unsubscribers only once, and skip importing activities.
    import configuration
  6. Click on the Start import button to begin the work.

Export an audience to a BlueHornet list

Summary
FrequencyOne-time only / Real-time
Exports toGroup
NameLytics + segment name
Identifiersemail
Mapped Fieldsno
Segment Exportsnone; audience is selected during work configuration
Typeadd & remove
  1. Authorize Lytics with BlueHornet, if you have not previously done so.
  2. Select Export List.
  3. Select the authorization you want to use for this export.
  4. Configure the integration options:
    export configuration
    • Audience: Select the Lytics segment to export to BlueHornet. A group will be created for the exported subscribers.
    • Email Field: Select the Lytics field that contains the subscriber's email.
    • Click Show Advanced Options for the following setup options:
      • Keep Updated: Select this to keep the BlueHornet group up to date with the Lytics segment. Subscribers will be added and removed based as they enter and leave the lytics segment.
      • Existing Users: Add users who already exist in the segment. If this is unselected users in the segment will only be added to the BlueHornet group if they experience an event in Lytics.
  5. Click on the Start Export button to begin the work. Users should start appearing in BlueHornet after a few minutes.
    Lytics in BlueHornet