Personalization

Exchange - Connect user data with Personalization

Overview

Acoustic Exchange helps marketers connect customer identities across their marketing platforms. It helps them to understand individual customers' cross-channel behavior in context.

In Exchange, you register your application as an endpoint. The publisher endpoint is the source that generates event data or visitor data. It then passes the data to Exchange. The subscriber endpoint is the destination for the event or visitor data from the source.

You can register the Personalization endpoints in Exchange to receive the events data. Register your analytics library as the publisher and Personalization as the subscriber. You can then subscribe to the events from the analytics library. The events data from the analytics library flows to Personalization through Exchange.

Before you begin

  • Subscribe to an Exchange account to use with Personalization. Contact Acoustic support to get an Exchange account provisioned.
  • Register your channel in Personalization and have the channel ID available with you.

You only need one Personalization publisher endpoint and one Personalization subscriber endpoint. You can use the same endpoints can be used to personalize many channels.
You can have any analytics library configured to your channel. The events data from those libraries are sent to the one subscriber endpoint.

Register Personalization publisher endpoint in Exchange

  1. Log in to Exchange, go to Endpoints and click Register new endpoint.
  2. Search and select Acoustic Personalization - Publisher and click Next.
  3. In the Deployment field, select an option relevant to your geographical location.
  4. You can provide an alias for this endpoint as an option. For example - Acme Personalization Publisher and add a description.
  5. Click Register. A message appears: "Thanks! We got it."
  6. Click Close. Application is displayed in the list with status as Pending. It takes a few minutes for the endpoint to become active. Refresh the page to check the status update.
  7. After the endpoint is Active, click its Actions menu and select Edit endpoint details.
  8. Copy and save the Endpoint authentication key. This key is required to configure your channel in Exchange Capture configuration.

Register Personalization subscriber endpoint in Exchange

  1. Go to Endpoints and click Register new endpoint.
  2. Search and select Acoustic Personalization - Subscriber and click Next.
  3. In the Deployment field, select an option relevant to your geographical location.
  4. You can provide an alias for this endpoint as an option. For example - Acme Personalization Subscriber and add a description.
  5. Click Register. A message appears: "Thanks! We got it."
  6. Click Close. Application is displayed in the list with status as Pending. It takes a few minutes for the endpoint to become active. Refresh the page to check the status update.

Subscribe events from publisher endpoint to subscriber endpoint

You must now subscribe to all the events from the publisher endpoint you registered. Then add the subscriber endpoint as the destination for those events to send data.

  1. Go to the Events tab and click Subscribe to events.
  2. In the Select events column, open the Acoustic > Acoustic Personalization - Publisher endpoint. Then select all the events listed for that endpoint.
  3. In the Select the destinations column, select Acoustic > Acoustic Personalization - Subscriber.
    4.Click Subscribe. You have now subscribed to the events.

Deploy Personalization in Exchange Capture

You must only deploy the Acoustic Personalization - Publisher endpoint. You do not have to deploy Acoustic Personalization - Subscriber endpoint in Exchange Capture. This is to capture data from the analytics libraries. The captured data is then sent to Exchange which then sends it to Personalization.

Exchange Capture now provides a single interface that streamlines the configuration and deployment of Acoustic and certified partner enablements. Choose from the following methods to deploy Personalization based on the Exchange Capture provisioned for you.

  1. In Exchange, go to Tools > Exchange Capture. Exchange Capture opens in a separate tab.
  2. From Exchange Capture, go to the Applications column and click Acoustic Personalization.
  3. In the Deploy application modal, provide the following information:
    • Name alias: Provide an alias for your channel.
    • Channel type: Select the type of your channel (SPA or MPA).
    • Channel tenant ID: Provide the channel tenant ID.
    • Acoustic Exchange event authentication Key – Provide the key for Acoustic Personalization - Publisher.
    • Personalization Library: This field is required to deploy the library for an MPA. You must specify the Personalization Library version for an MPA channel. For more information, see deploy the Personalization Library for your MPA channel.
    • DA Extra Field Index: Specify the index position of channel tenant ID to call a DA event. For more information, see configure the DA events. If you are not using Digital Analytics as the analytics library, ignore this field.
  4. Click Save and deploy. It might take a couple of hours for Personalization to be enabled and become active.

  1. From the Exchange menu, go to Tools > Exchange Capture.
  2. From the Partner Enablement's screen, search Acoustic Personalization. If the partner is not enabled, hover over the card and click Enable.
  3. Open the Tag Catalog screen from the side menu. Acoustic Personalization is listed as enabled in the Enabled partners' tab.
  4. Click Configure Tag to add the Acoustic Personalization in the Deployment Group.
    • Complete the following in the Provide details screen:
      • From the Enable Partner drop-down list, select Acoustic Personalization.
      • From the Tag Template drop-down list, select Enable Acoustic Personalization – [Head].
      • Provide a Tag name, for example, MPAPersonalizationTag, and click Next.
    • Complete the following in the Configure tags fields screen:
      • Open Channel Type. Then in the Channel Type field, select Multi-Page Application or Single Page Application.
      • Open Library URL. Then from the Method drop-down list, select Constant.
        In the Constant field, specify the library version URL. For more information, see Deploy the Personalization Library for your MPA.
      • Open Channel Tenant ID. Then, in the Method field, select Constant. In the Constant field, provide the Channel Tenant ID.
      • Open Exchange Event Authentication Key. Once again, select Constant in the Method field.
        In the Constant field, provide the endpoint authentication key for Acoustic Personalization – Publisher.
      • Open Acoustic Digital Analytics Extra Field Index. Select constant in the Method field. Then specify the channel tenant ID's index position to call a DA event in the Constant field. For more information, see configure the DA events. If you are not using Digital Analytics as the analytics library, ignore this field.
  5. Click Next and Submit.

Your tag is now configured for Acoustic Personalization. Next, you will deploy this tag with your Deployment Group on Exchange Capture.

Updated 7 months ago


Exchange - Connect user data with Personalization


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.