The Attribute and Recommendation Syndication is used to export user attributes, recommendations and/or predictive scores to outside of Blueshift.
The Attribute and Recommendations Syndication, by default, has the option to upload the final CSV file to the Blueshift Customer bucket in AWS. This is where all of Blueshift's reporting gets uploaded. If you desire to upload the final CSV file to another location, you can do so in the Integration Settings:
- Click Integrations to access your integration settings
- Under Data Warehouses you can select Amazon S3 and enter the appropriate settings:
This alias name will be used to select this particular set of Amazon S3 credentials in the Syndication editor.
- On the left navigation menu, click Syndications to go to the Syndications index page.
- On the top right corner, click Syndication + and then click Attribute and Recommendation (if you see a dropdown).
- Specify a name for the syndication and click Create Attributes and Recommendations Syndication.
The first step is the configuration stage.
The Name field is the name of this particular syndication. This is used purely for organization purposes and must be unique for this syndication.
Start Time indicates when this syndication will launch.
Execution schedule is how often this syndication will run and is further elaborated in the following table:
|One-time||This setting will export the segment on a one-time basis.|
|Daily||This setting will export the segment daily, at the Start Time specified above.|
|Weekly||This setting will export the segment weekly, on the Start Time and 7 days afterwards, and so forth.|
|Custom||This setting will export the segment every N number days, where N is a number that the user inputs.|
Filename Prefix will be appended to the name of the file that is ultimately uploaded. This is required for organizational purposes.
Send Completion Email to ... is an optional field. Enter a single email or multiple emails (separated by commas) to be emailed once the syndication finishes calculating and uploading the file(s).
The second step is adding user fields for this syndication. These are the user level attributes that will be outputted to the CSV file. For good practice, you should probably choose at least one unique identifier for each user. e.g. email. Otherwise the outputted information may not be usable.
To add more fields, click the + ADD USER FIELD button and add more user fields.
You can add as many fields as you desire.
If recommendations are enabled on your account, you can add recommendations to your outputted file.
Click + ADD RECOMMENDATIONS to add recommendations to the file. This is an optional field.
You need to select the recommendation algorithm (either a predefined algorithm or any created via our Recommendation Studio), total the number of products you want returned (up to 20) and the different product fields that you desire.
The column names are predefined and will be generated from the product field name and the number of products.
If Predictive Scores are enabled, you can add predictive scores to your outputted file by clicking on the following:
Adding the predictive scores is similar to adding user fields. You will want to select the score and enter the name of this column.
After configuring the actual file that will be outputted, you now have to choose where the file will ultimately be uploaded.
Click on the Blueshift Bucket to upload this file to your Blueshift Bucket - the customer bucket that all other files are stored.
After all of the appropriate settings have been filled out, save this syndication then hit launch. This will activate this syndication. Attributes and recommendations will be computed and uploaded to the selected destination.
Click on the previously created syndication in the index page to view appropriate statistics.
Click on the syndication name to enter the syndication detail screen, where you can look at stats regarding this syndication.
There are three pieces of information that are relevant per destination:
- Users in Segment: The total number of users that qualify for the conditions defined in a particular segment.
- Last Successful Run: The last time this Attribute and Recommendation syndication ran successfully, from calculating the users to uploading the final file.
- Next Scheduled Run: The next time this Attribute and Recommendation syndication will run.