-
Notifications
You must be signed in to change notification settings - Fork 393
Add documentation for Recombee destination #7049
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 7 commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
a1a108c
Add documentation for Recombee (Actions) destination
f7ad6fb
Apply suggestions from code review
mstieranka 01d9566
Apply suggestions from code review
6e6291e
Update src/connections/destinations/catalog/actions-recombee/index.md
mstieranka c6afcef
Apply suggestions from code review
mstieranka fb48359
Apply suggestions from code review
mstieranka 4382891
Apply suggestions from code review
mstieranka a53dc06
Apply suggestions from code review
mstieranka File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
62 changes: 62 additions & 0 deletions
62
src/connections/destinations/catalog/actions-recombee/index.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,62 @@ | ||
--- | ||
title: Recombee Destination | ||
hidden: true | ||
id: 66f2aea175bae98028d5185a | ||
versions: | ||
- name: Recombee AI | ||
link: /docs/connections/destinations/catalog/recombee-ai | ||
--- | ||
|
||
{% include content/plan-grid.md name="actions" %} | ||
|
||
[Recombee](https://recombee.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a Recommender as a Service, offering precise content or product recommendations and personalized search based on user behavior. | ||
|
||
Use this Segment destination to send your interaction data (for example, views, purchases, or plays) to Recombee. | ||
|
||
This destination is maintained by Recombee. For any issues with the destination, [contact the Recombee Support team](mailto:[email protected]). | ||
|
||
## Benefits of Recombee (Actions) vs Recombee AI Classic | ||
|
||
The new Recombee destination built on the Segment Actions framework provides the following benefits over the classic Recombee AI destination: | ||
|
||
- **Streamlined Configuration**: You can now create mappings in a dedicated tab in the Segment web app, as opposed to needing to edit this in the settings. This allows you to configure the mappings on a per-event basis and makes it easier to verify that your mappings work as intended. | ||
- **Removable Bookmarks**: You can now configure a mapping to send a *Delete Bookmark* Action, which removes the bookmark interaction from the Recombee database. | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
## Migration from the classic Recombee AI destination | ||
|
||
Recombee recommends ensuring that a Recombee (Actions) destination and a classic Recombee AI destination connected to the same source are not enabled at the same time in order to prevent errors. | ||
|
||
### Configuration changes | ||
|
||
Compared to the classic Recombee AI destination, the following configuration changes were made: | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
- In the destination settings, the **API Key** setting was renamed **Private Token** to better reflect the type of token used. | ||
- The **Track Events Mapping** setting has been removed. If you want to map custom events to Recombee interactions, create your own mappings in the Mappings tab in the Segment app. | ||
- The **Item ID Property Name** setting is now no longer available, as this functionality is now available in Segment's native Mappings tab. Ensure that your mappings use the desired property for the **Item ID** action field. | ||
- *The following change only affects users that were relying on the `name` property to set their **Item ID**:* In presets, the **Item ID** property is now determined differently - in the default settings, the `asset_id` property (or `sku` for Ecommerce events) is now used as the fallback instead of `name`. The `name` property is never used by default, as it may not conform to the required **Item ID** format. Additionally, the property `content_asset_id` (or the first ID in `content_asset_ids`) is now the default **Item ID** only in Video events, where they are always present. | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
## Getting started | ||
|
||
1. If you don't already have one, set up a [Recombee account](https://recombee.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"}. | ||
2. From the Segment web app, navigate to **Connections > Destinations** and click **Add Destination**. | ||
3. Select **Recombee** and click **Add Destination**. | ||
4. Select an existing Source to connect to Recombee. | ||
5. Navigate to the [Recombee Admin UI](https://admin.recombee.com){:target="_blank"} and complete the following actions: | ||
- Choose the Recombee Database where you want to send the interactions. | ||
- Click **Settings** in the menu on the left. | ||
- In the **API ID & Tokens** settings section, find the **Database ID** and the **Private Token** of the Database. | ||
6. Back in the Segment app, navigate to the settings page of the Recombee destination you created. | ||
- Copy the **Database ID** from the Recombee Admin UI and paste it into the **Database ID** field in the destination settings. | ||
- Copy the **Private Token** from the Recombee Admin UI and paste it into the **Private Token** field in the destination settings. | ||
|
||
Once you send the data from Segment to the Recombee destination, you can: | ||
- Open the KPI console of the [Recombee Admin UI](https://admin.recombee.com){:target="_blank"} to see the numbers of the ingested interactions (updated in realtime). | ||
- Select the ID of an Item (or User) in the Items (or Users) catalog section in the Admin UI to view a specific ingested interaction. | ||
|
||
{% include components/actions-fields.html %} | ||
|
||
## Reporting successful recommendations | ||
|
||
You can inform Recombee that a specific interaction resulted from a successful recommendation (meaning the recommendations were presented to a user, and the user clicked on one of the items) by setting the ID of the successful recommendation request in the `Recommendation ID` field of the action (this is the `recomm_id` property by default). You can read more about this setting in Recombee's [Reported Metrics documentations](https://docs.recombee.com/admin_ui.html#reported-metrics){:target="_blank"} | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
Sending the `Recommendation ID` gives you precise numbers about successful recommendations in the KPI section of the [Recombee Admin UI](https://admin.recombee.com){:target="_blank"}. This explicit feedback also helps improve the output of the recommendation models. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,41 +1,38 @@ | ||
--- | ||
title: Recombee AI Destination | ||
rewrite: true | ||
maintenance: true | ||
mstieranka marked this conversation as resolved.
Show resolved
Hide resolved
|
||
maintenance-content: This destination is no longer available in the Segment catalog but will remain active in workspaces where it has already been installed. Recombee has developed an updated destination built on the Actions framework. See [Recombee Destination](/docs/connections/destinations/catalog/actions-recombee/) for more information. | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
hide-settings: true | ||
hide-personas-partial: true | ||
id: 6095391bd839b62fca8a8606 | ||
versions: | ||
- name: Recombee (Actions) | ||
link: /docs/connections/destinations/catalog/actions-recombee | ||
--- | ||
[Recombee](https://recombee.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a Recommender as a Service, that can use your data to provide the most accurate recommendations of content or products for your users. | ||
|
||
Use this Segment destination to send your interaction data views, purchases, plays, etc.) to Recombee. | ||
|
||
This destination is maintained by Recombee. For any issues with the destination, [contact the Recombee Support team](mailto:[email protected]). | ||
|
||
> note "Note:" | ||
> The Recombee Destination is currently in beta, which means that they are still actively developing the destination. If you have any feedback to help improve the Recombee Destination and its documentation, [contact the Recombee support team](mailto:[email protected])! | ||
[Recombee](https://recombee.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a Recommender as a Service that can use your data to provide the most accurate recommendations of content or products for your users. | ||
|
||
Use this Segment destination to send your interaction data (views, purchases, plays, etc.) to Recombee. | ||
mstieranka marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
## Getting Started | ||
|
||
|
||
|
||
1. If you don't already have one, set up a [Recombee account](https://recombee.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"}. | ||
1. From the Destinations catalog page in the Segment App, click **Add Destination**. | ||
2. Search for "Recombee" in the Destinations Catalog, and select the Recombee destination. | ||
3. Choose which Source should send data to the Recombee destination. | ||
4. Go to the [Recombee Admin UI](https://admin.recombee.com){:target="_blank"}: | ||
- Choose the Recombee Database where you want to send the interactions. | ||
- Click **Settings** in the menu on the left. | ||
- In the **Settings** section find the **API Identifier** of the Database and its corresponding **Private Token** | ||
- In the **Settings** section find the **Database ID** and the **Private Token** of the Database. | ||
5. Back in the Segment web app, go to the Recombee destination settings. | ||
- Paste the **API Identifier** you just copied in the **Database ID** field. | ||
- Paste the **Database ID** you just copied in the **Database ID** field. | ||
- Paste the **Private Token** you just copied in the **API Key** field. | ||
|
||
Once you send the data from Segment to the Recombee destination you can: | ||
- Go to the KPI console of the [Recombee Admin UI](https://admin.recombee.com){:target="_blank"} to see the numbers of the ingested interactions (updated in Real-time) | ||
- Click the ID of an Item, User in Items, or section in the Users catalog to see a specific ingested interaction. | ||
|
||
|
||
## Page | ||
|
||
If you aren't familiar with the Segment Spec, take a look at the [Page method documentation](/docs/connections/spec/page/) to learn about what it does. An example call would look like: | ||
|
@@ -46,7 +43,6 @@ analytics.page() | |
|
||
Segment sends Page calls to Recombee as a [Detail View](https://docs.recombee.com/api.html#add-detail-view){:target="_blank"}. | ||
|
||
|
||
## Track | ||
|
||
If you aren't familiar with the Segment Spec, take a look at the [Track method documentation](/docs/connections/spec/track/) to learn about what it does. An example call would look like: | ||
|
@@ -62,6 +58,7 @@ analytics.track('Video Content Playing', { | |
``` | ||
|
||
#### Sending semantic spec events to Recombee | ||
|
||
Recombee Destination can process several [Semantic Events](/docs/connections/spec/semantic/): | ||
|
||
[Ecommerce](/docs/connections/spec/ecommerce/v2/): | ||
|
@@ -91,7 +88,6 @@ If you aren't familiar with the Segment Spec, take a look at the [Screen method | |
|
||
Segment sends Screen calls to Recombee as a [Detail View](https://docs.recombee.com/api.html#add-detail-view){:target="_blank"}. | ||
|
||
|
||
## Alias | ||
|
||
If you aren't familiar with the Segment Spec, take a look at the [Alias method documentation](/docs/connections/spec/alias/) to learn about what it does. An example call would look like: | ||
|
@@ -108,8 +104,8 @@ Segment sends a [Delete User](https://docs.recombee.com/api.html#delete-user){:t | |
All the data associated with the user (including interactions) are removed from Recombee. | ||
|
||
## Reporting successful recommendations | ||
You can tell Recombee that a specific interaction is based on a successful recommendation (meaning that the recommendations were presented to a user, and the user clicked one of the items), by setting the ID of the successful recommendation request on the `recomm_id` property of a Segment event. You can read more about this setting in [Recombee's Reported Metrics documentations](https://docs.recombee.com/admin_ui.html#reported-metrics){:target="_blank"} | ||
|
||
You can tell Recombee that a specific interaction is based on a successful recommendation (meaning that the recommendations were presented to a user, and the user clicked one of the items), by setting the ID of the successful recommendation request on the `recomm_id` property of a Segment event. You can read more about this setting in [Recombee's Reported Metrics documentations](https://docs.recombee.com/admin_ui.html#reported-metrics){:target="_blank"} | ||
|
||
Recombee recognizes the `recomm_id` property in all the events that send interactions. | ||
|
||
|
@@ -140,7 +136,6 @@ If you don't provide an **Item ID Property Name**: | |
- `content_asset_id` or `asset_id` is used for [Video Events](/docs/connections/spec/video/). | ||
- `name` property is used if it exists. | ||
|
||
|
||
### Track Events Mapping (Optional) | ||
|
||
Recombee can automatically handle different [Ecommerce Events](/docs/connections/spec/ecommerce/v2/) and [Video Events](/docs/connections/spec/video/) in the *Track* call type (see the [Track section](#track)). | ||
|
@@ -158,7 +153,6 @@ The value of the mapping is the name of your event, and the key can be one of: | |
- [View Portion](https://docs.recombee.com/api.html#set-view-portion){:target="_blank"} | ||
- the portion (how much of the content was consumed by the user) is computed from the `position` and `total_length` properties (see [Content Event Object](/docs/connections/spec/video/#content-event-object)), or can be given as the `portion` property (a number between 0 and 1). | ||
|
||
|
||
### API URI (Optional) | ||
|
||
Specify the URI of the Recombee API to use. Omit the protocol. For example, `rapi.recombee.com`. | ||
|
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.