Create destinations

👍

Data hub rollout

Data hub provides new unified API integration methods for sending data to multiple Bloomreach products. Access is being rolled out in phases. For new implementations, we recommend using Data hub where available. Existing product-specific integrations remain fully supported for Marketing, Search, and Conversational agent.

Configure destinations to deliver items and attributes to Marketing and Search.

Prerequisites

Knowledge

Understanding of item collection concepts.

Process

Ensure that you review the items and validate the schema

Permissions 

For the Data hub, ensure you have the Item Collections Admin permissions.

For Marketing destinations, appropriate access management roles to view synced catalog data.

For Search destinations, appropriate user permissions to view the synced catalog data.

Setup

For Marketing destinations, the target Marketing project must be connected to your Data hub workspace.

For Search destinations, there must be an existing Search catalog in the staging or production environment.

Steps to create a destination

1. Navigation

  1. Go to Data hub > Items in your Bloomreach workspace. 

  2. Locate and open the existing item collection from the item collections listing page.

  3. Click the Destinations tab.

  4. Click + Add destination.

2. Choose and connect a destination

  1. Choose a relevant destination:

    • Select Marketing as the destination. Choose which Marketing project linked to the workspace that should receive your items.

    • Select Search as the destination. Choose your target Search catalog and environment (staging or production).

      Connect item collection to destination dialog in {user.dh}, showing {user.mkg} and {user.search} destination options.
  2. Click the Connect button.

  3. Click Review and save configuration. Review the modifications and deselect any changes you don't want to save. Click Save configuration. The system triggers a sync job automatically.

3. Go to destinations

Marketing destination

On sync completion, click Go to destination under the Destinations tab. This redirects you to the Marketing application to verify data under Data & Assets > Catalogs.

Click View next to the created product or variant catalogs. Under the Attributes tab, you can control the attribute searchability settings.

Search destination

The sync job overwrites any existing data in the Search catalog. Check the Jobs tab for status, then log into your Search environment to see the synced data in the Catalogs application.

How Marketing destinations work

When you create an Marketing destination, you select which Marketing project should receive your items. Data hub automatically creates catalogs in that project to store your product data.

For item collections with variants, the system creates two catalogs:

  • Product catalog lookup: Contains product-level data for looking up products by their product ID.

  • Variant catalog lookup: Contains variant-level data with denormalized product attributes for looking up individual variants.

The system keeps these catalogs synchronized with your item collection data and maintains the schema configuration automatically.

How Search destinations work

When you create a Search destination, you select a target catalog in a specific Search account and environment (staging or production). Data hub synchronizes item data and attribute configurations to the selected Search catalog, maintaining consistency with your schema. View the data received in the Catalogs application. Here, configure the searchability, facetability, and displayability settings.

📘

Note

Search catalogs must exist before you can select them as destinations. Data hub synchronizes data into existing Search catalogs but doesn't create or delete them.

Data synchronization with destinations

Once you configure a destination, Data hub automatically synchronizes your items whenever data changes. You don’t need to manually trigger syncs. 

What syncs automatically

  • New items added to your collection.

  • Updated items when records change.

  • Schema modifications that affect item attributes.

  • Item deletions when corresponding records are removed. 

📘

Note

Modification synchronizations can impact downstream services. Carefully review all changes.

Monitor sync status

Check the jobs interface to see the destination sync job status. Each sync operation creates a job showing how many items were synced, whether the sync succeeded or failed, and any errors encountered during synchronization.

The destinations view in your collection also displays the last sync date and current status for each destination

FAQs

Can I have multiple Marketing destinations for the same collection?

No. Each collection supports one Marketing destination and one Search destination. If you need to send data to multiple projects or catalogs, you'll need separate collections.

What happens to my Marketing catalogs if I delete the destination?

Deleting an Marketing destination also deletes the catalogs created in that Marketing project. The system warns you before deletion, but this action removes the catalog data from Marketing.

What happens to my Search catalog if I delete the destination?

Deleting a Search destination removes the connection between the Data hub and that catalog, but the catalog itself remains in Search. The catalog will no longer receive updates from Data hub.


Did this page help you?

© Bloomreach, Inc. All rights reserved.