Attribute and Recommendations

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:

setup_integrations.png
  • Click Integrations to access your integration settings
  • Under Data Warehouses you can select Amazon S3 and enter the appropriate settings:
81274bc-Screen_Shot_2017-11-28_at_11.35.32_AM.png

This alias name will be used to select this particular set of Amazon S3 credentials in the Syndication editor.

  1. On the left navigation menu, click Syndications to go to the Syndications index page. 
  2. On the top right corner, click Syndication + and then click Attribute and Recommendation (if you see a dropdown). 
    select_attributes_and_recommendations.png
  3. Specify a name for the syndication and click Create Attributes and Recommendations Syndication.
    create_attrib_and_recomm.png
 

Step 1: Configuration

The first step is the configuration stage.

87ffef3-Screen_Shot_2017-12-07_at_1.43.27_PM.png

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:

  
Title Purpose
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.

5076b4f-Screen_Shot_2017-11-28_at_11.42.44_AM.png

 

 

To add more fields, click the + ADD USER FIELD button and add more user fields.

6cda469-Screen_Shot_2017-11-28_at_11.42.47_AM.png

You can add as many fields as you desire.

If recommendations are enabled on your account, you can add recommendations to your outputted file.

34ab1b3-Screen_Shot_2017-11-28_at_11.42.53_AM.png

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.

47c2cc9-Screen_Shot_2017-11-28_at_11.43.04_AM.png

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:

90c0c90-Screen_Shot_2017-12-07_at_11.59.48_AM.png

Adding the predictive scores is similar to adding user fields. You will want to select the score and enter the name of this column.

de4f22e-Screen_Shot_2017-11-28_at_11.43.15_AM.png

After configuring the actual file that will be outputted, you now have to choose where the file will ultimately be uploaded.

594df28-Screen_Shot_2017-12-07_at_12.02.13_PM.png

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.

syndications_page_index.png

Click on the syndication name to enter the syndication detail screen, where you can look at stats regarding this syndication.

5ef4f45-Screen_Shot_2017-12-07_at_12.07.18_PM.png

There are three pieces of information that are relevant per destination:

  1. Users in Segment: The total number of users that qualify for the conditions defined in a particular segment.
  2. Last Successful Run: The last time this Attribute and Recommendation syndication ran successfully, from calculating the users to uploading the final file.
  3. Next Scheduled Run: The next time this Attribute and Recommendation syndication will run.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request