Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Contentstack Cloud Destination


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Contentstack, or Contentstack Cloud in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta
(information)

This destination sends data in cloud-mode

This destination transmits data from Segment to Contentstack server-side. Contentstack supports both device-mode and cloud-mode destinations. For more more about the device-mode web destination, see Contentstack Web.

Contentstack(link takes you to an external page) is a headless CMS that allows you to build digital experiences using a modular approach. This integration lets you sync data from Segment to your Contentstack Personalize project, enabling dynamic and personalized content delivery.

This destination is maintained by Contentstack. For any issues with the destination, contact their Support team(link takes you to an external page).


Prerequisites

prerequisites page anchor
  • a Contentstack account with Personalize enabled
  • a Contentstack Personalize project created in your Contentstack organization

  • Contentstack Personalize Project: Create a Contentstack Personalize project within your organization and link your Contentstack stack to enable variant functionality.
  • Attributes & Audiences: Define attributes and create audiences based on those attributes within your Contentstack Personalize project.
  • Events: Define and create the events that you want to track and sync with your Contentstack Personalize project.

  1. From your workspace's Destination catalog page(link takes you to an external page) search for "Contentstack".
  2. Select Contentstack and click Add Destination.
  3. Select an existing Source to connect to Contentstack.
  4. Go to the Contentstack account and find the following parameters to input as settings in the Segment destiantion settings:
    • Personalize Project ID: Enter the unique ID of your Contentstack Personalize project.
    • Personalize Edge API Base URL: Enter the base URL of your Contentstack Personalize API. You can find this URL in the Contentstack documentation.

Property nameTypeRequiredDescription
Personalize Edge API base URLstring
required

Your region-based personalize-edge API base URL.


Personalize project IDstring
required

Your Personalize project ID to which Segment's data should be synced.


Build your own Mappings. Combine supported triggers with the following Contentstack Cloud-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Custom Attributes Sync

custom-attributes-sync page anchor

Sync Custom Attributes to your Contentstack Experience.

Custom Attributes Sync is a Cloud action. The default Trigger is type = "identify"

Property nameTypeRequiredDescription
User traitsOBJECT
required

User Profile traits to send to Contentstack


User IDSTRING

Optional

ID for the user


Create AttributesBOOLEAN

Optional

Inidicates if Attributes should be created in Contentstack

Contentstack Browser Plugin

contentstack-browser-plugin page anchor

Enriches all Segment payloads with a value indicating if Attributes need to be created in Contentstack before they are synced.

Contentstack Browser Plugin is a Web action. The default Trigger is type = "track" or type = "identify" or type = "page" or type = "group" or type = "alias"

Property nameTypeRequiredDescription
User traitsOBJECT
required

User Profile traits to send to Contentstack

Sync Computed Attributes to your Contentstack Experience.

Computed Attribute Sync is a Cloud action. The default Trigger is type = "track" or type = "identify"

Property nameTypeRequiredDescription
User traitsOBJECT

Optional

User Profile traits to send to Contentstack, for Identify calls


User propertiesOBJECT

Optional

User Profile properties to send to Contentstack, for Track calls


Event TypeSTRING
required

Type of the event


User IDSTRING
required

ID for the user

Sync Audiences to your Contentstack Experience.

Audience Sync is a Cloud action. The default Trigger is type = "track" or type = "identify"

Property nameTypeRequiredDescription
User traitsOBJECT

Optional

User Profile traits to send to Contentstack, for Identify calls


User traitsOBJECT

Optional

User Profile traits to send to Contentstack, for Track calls


Event TypeSTRING
required

Type of the event


User IDSTRING
required

ID for the user


Start sending the payload of events to Segment using Track or Identify calls. This will not only send events to Segment but will forward the selected values to Contentstack Personalization. Ensure your event payloads align with the mapping configuration you created for the Contentstack destination in Segment.


Receive personalized content

receive-personalized-content page anchor

Based on your events/payloads, your Contentstack Personalize project should now start receiving events to help you understand the users associated with your mapped values.

The event names and properties you use must match those defined in your Contentstack Personalize project. For advanced customization and to further enhance your personalized experience, explore Contentstack Personalize in Contentstack's Documentation(link takes you to an external page).


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to Contentstack Cloud may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
Personalize Edge API base URLstring
required

Your region-based personalize-edge API base URL.


Personalize project IDstring
required

Your Personalize project ID to which Segment's data should be synced.