Kognitiv
Sync audience memberships to Kognitiv Inspire promotional member groups. Zeotap adds and removes members from your Kognitiv loyalty segments in real time, keeping your promotional targeting in sync with warehouse data.
Prerequisites
- A Kognitiv Inspire account with API access enabled
- OAuth 2.0 client credentials (Client ID and Client Secret) from the API Security Tokens page in Kognitiv Inspire
- The external reference identifier of the promotional member group you want to sync to
- Member internal IDs available in your warehouse data
Authentication
Kognitiv uses OAuth 2.0 Client Credentials authentication.
- Log in to your Kognitiv Inspire admin console
- Navigate to Settings > API Security Tokens
- Create a new API token or use an existing one
- Copy the Client ID and Client Secret
- In Zeotap, select Client Credentials as the authentication method
- Paste the Client ID and Client Secret into the corresponding fields
Zeotap automatically handles token acquisition and refresh using these credentials.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| API Base URL | Text | Yes | Your Kognitiv Inspire API base URL (e.g. https://app.kognitivloyalty.com) |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Object Type | Select | Yes | The type of object to sync. Currently supports Promotional Member Group. |
| Group External Reference | Text | Yes | The external reference identifier of the promotional member group to sync members to. |
Supported Operations
Sync Modes
| Mode | Supported |
|---|---|
| Upsert | — |
| Insert | — |
| Update | — |
| Mirror | — |
This destination is audience-only. Use audience sync modes below to manage group memberships.
Audience Sync Modes
| Mode | Supported |
|---|---|
| Add | Yes |
| Remove | Yes |
| Mirror | Yes |
| Upsert | — |
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Field | Description |
|---|---|
| member_internal_id | The Kognitiv internal member identifier used to add or remove members from promotional groups |
Default Destination Fields
member_internal_id
How It Works
- Authentication: Zeotap obtains an OAuth 2.0 access token using your client credentials before each sync batch. Tokens are cached and refreshed automatically.
- Member Operations: For each row in the sync batch, Zeotap calls the Kognitiv Promotional Member Group API:
- Add:
PUT /api/groups/promotionalMember/{ref}/members/{memberID}adds the member to the group - Remove:
DELETE /api/groups/promotionalMember/{ref}/members/{memberID}removes the member from the group
- Add:
- Mirror Mode: In mirror mode, Zeotap compares the current audience with the previous sync and automatically adds new members and removes members who are no longer in the audience.
- Error Handling: If a token expires mid-batch, Zeotap automatically refreshes it and retries the failed operation. Individual member failures do not block the rest of the batch.
Rate Limits
Kognitiv does not publish specific rate limits for the Promotional Member Group API. Zeotap processes members sequentially to avoid overloading the API. Contact your Kognitiv account team for rate limit details specific to your deployment.
Best Practices
- Use stable member IDs: Map the
member_internal_idfield to the Kognitiv internal member identifier from your warehouse. Do not use mutable values like email addresses. - Verify group references: Confirm the promotional member group external reference exists in Kognitiv Inspire before configuring the sync.
- Use mirror mode for full syncs: If your audience definition changes frequently, use mirror mode to ensure the Kognitiv group always matches your warehouse audience exactly.
- Monitor sync results: Check the sync history in Zeotap for failed member operations, which typically indicate invalid member IDs.
Troubleshooting
Authentication failed: invalid client credentials
Verify that the Client ID and Client Secret are correct and have not been rotated. Re-generate credentials from the API Security Tokens page in Kognitiv Inspire if needed.
Member not found (HTTP 404)
The member_internal_id value does not correspond to a valid member in Kognitiv. Verify that the member exists and that you are using the correct internal ID format (not an external or third-party ID).
Group external reference not found
The promotional member group external reference does not exist in Kognitiv Inspire. Verify the reference in the Kognitiv admin console under promotional member group settings.
Token refresh failures
If you see repeated token refresh errors, your client credentials may have been revoked or the Kognitiv OAuth endpoint may be temporarily unavailable. Check the Kognitiv Inspire status page and verify your credentials are still active.
Members added but not appearing in group
There may be a propagation delay in Kognitiv Inspire. Allow a few minutes for group membership changes to reflect in the UI. If members still do not appear, verify they are active (inactive members cannot be added to groups).
HTTP 500 errors from Kognitiv
Server errors from Kognitiv are typically transient. Zeotap will retry on the next sync run. If errors persist, contact Kognitiv support with the member IDs and group reference for investigation.