PostgreSQL
Integration
PostgreSQL integration allows you to import customer data, events, catalogs, and vouchers directly from your PostgreSQL database into Bloomreach Engagement. You can schedule regular imports for ongoing data synchronization or run one-time imports for historical data migration.
Benefits
- Automation: Schedule regular imports to eliminate manual file exports and uploads
- Accuracy: Direct database connections minimize manual errors and keep data synchronized
- Flexibility: Use standard SQL syntax to import precisely the data you need
- Security: Store credentials securely and control access at the database level
PostgreSQL integration use cases
- Import customer profiles for personalization and segmentation
- Sync product catalogs for accurate recommendations
- Pull transaction events to build customer journeys
- Import voucher codes for targeted campaigns
How the integration works
- Set up database connection: Configure connection details in Bloomreach Engagement.
- Choose data selection method: Write custom SQL queries or select entire tables.
- Map columns: Map database columns to Bloomreach Engagement attributes.
- Schedule imports: Run one-time imports or set recurring schedules.
Set up integration
- Go to Data & Assets > Integrations and click + Add new integration in the top right corner.
- In the Available integrations dialog, enter PostgreSQL in the search box, and select + Add new integration.

- Enter connection details (hostname, port, database name, credentials).

- Optional security configuration:
- Static IPs: Enable static IP usage, then configure your PostgreSQL server firewall to allow connections from Bloomreach's IP addresses.
- SSL encryption: Enable to encrypt data during transfer between your database and Bloomreach Engagement.
- SSH tunnel: Enable for an additional security layer when connecting through intermediate servers.
- Give your integration a name and Save integration for use during data imports.
Create data import
- Go to Data & Assets > Imports > + Create new
- Choose the type of data to import:
- Customers (columns mapped to attributes)
- Events (with customer IDs, timestamps, and event attributes)
- Catalogs (general or product-specific)
- Vouchers

- Select Database as your data source and pick your PostgreSQL connection from the SQL integration dropdown menu.
- Choose your data selection method:
- Query mode: Write custom SELECT statements to pull specific data
- Table mode: Select entire tables without custom query options
- For Query mode: Write your SQL SELECT statement

For Table mode: Select the table to import from in the Source Table dropdown.

- Select Test query or Preview data to verify your data source is working.
- Click Next to proceed to mapping.
- Map your PostgreSQL columns to Bloomreach Engagement attributes by dragging source columns to the corresponding target fields, then click Next.
- Configure your schedule execution and click Finish to start the import.
Learn more information on the Data import page.
Best practices
- Always preview data before importing to ensure format correctness.
- Map identifiers carefully to avoid duplicates or overwrites.
- Use scheduling for ongoing syncs and manual runs for one-time imports.
- Secure credentials and review permissions for all integrations.
Limitations
- Schema changes in your database may disrupt active imports - manage changes cautiously.
- Follow data structure and mapping best practices to prevent import issues.
- Custom database integrations should align with Engagement's data requirements.
Additional sources
Updated 1 day ago