Contentstack

Add the Uniform Marketplace app to Contentstack

The Uniform app in the Contentstack Marketplace enables content managers to use Uniform capabilities within the Contentstack user interface.

  • Classification - Assign enrichment tags to Contentstack entries. These tags describe data you want to track on the visitor who views the entry. For example, you might want to track that a visitor is interested in making a purchase when the visitor views a specific entry.
  • Personalization - Associate personalization conditions with Contentstack entries. For example, you might have a hero entry that should only be shown to visitors coming from a specific geographic region.

This section guides you through the process of adding the Uniform app from the Contentstack Marketplace.

Before you start

You must have the following available to complete this setup:

  • Contentstack account with administrator access.
  • Uniform account with administrator access. If you don't already have one, you can request an account at https://uniform.dev/try.

A Uniform API key is needed in order for the Marketplace app to read various settings involved with configuring personalization. You need an API key with the following permissions:

tip

For details on how to create an API key, see the instructions on how to create a Uniform API key.

The Uniform app in the Contentstack Marketplace adds a number of custom field types that allow content authors to configure personalization during the content authoring process. You must add this app to your stack.

  1. In Contentstack, navigate to the Marketplace.

  2. In the Apps section, find the Uniform app and click Install App.

    app
  3. Select your stack, accept the terms of service and click Install.

    install
  4. In the app configuration screen, scroll down to the section Now let's connect this app....

    now-lets-connect
  5. Paste your Quick Connect API key in the field.

    About this step

    This is the value you copied when you created the API key in Uniform.

  6. Click Connect.

    connected

    About this step

    If the Quick Connect API key you entered is valid, you will see a message indicating the Marketplace app was able to connect to your Uniform project.

  7. Now that you have Uniform app added to your stack, some new custom field types are available to add to your content models.

    content-type-custom-field-types

    These custom fields enable your content authors to do things like:

    • Associate personalization conditions with Contentstack entries. For example, you might have a hero entry that should only be shown to visitors coming from a specific geographic region.

    • Assign enrichment tags to Contentstack entries. These tags describe data you want to track on the visitor who views the entry. For example, you might want to track that a visitor is interested in making a purchase when the visitor views a specific entry.

Using the custom field types described above only describes something that should happen when the content model is used. For example, when a visitor views a specific type of content, you might want to classify the visitor in a specific way. This requires activating Uniform in your front-end application.

tip

As a next step, we recommend you follow a tutorial. This will guide you through the entire process of enabling classification and personalization with Contentstack, using your preferred front-end technology.