Create your Profiles project from the RudderStack dashboard.
5 minute read
While creating a Profiles project, you can choose either of the below:
Profile Builder (PB) CLI which gives you the flexibility to create, develop, and debug your Profiles project using various commands in fine detail. You can explore and implement the exhaustive list of features and functionalities offered by Profiles.
Profiles UI which provides a step-by-step intuitive workflow in the RudderStack dashboard. You can configure your project, schedule its run, explore the outputs and the user profiles.
This guide lists the detailed steps to create a Profiles project in the RudderStack dashboard.
Create Profiles project
Log in to the RudderStack dashboard and go to Unify > Profiles option in the left sidebar.
Click Create project.
Select Basic Entity Setup on the next screen.
You can also import an existing project from your Git repository. See Import Profiles from Git for more information.
Enter a unique name and description for your Profiles project.
Select a data warehouse from the dropdown and the source(s) connected to the warehouse.
You must connect an event stream source to one of the above warehouses and sync data at least once so that they populate in the dropdown.
For example, in the below image, the Node event stream source (es src) is connected to the Snowflake warehouse destination (cohort sample ) containing the schema SAMPLE_SHOPIFY_DATA.
Click Add mapping and provide values to map the existing ID types from the above-selected event stream source:
You can see some predefined mappings for the identifiers which comes from the Profiles library project.
Here, Event column represents the tables present in the warehouse, Property column represents the column name in that table, and ID type represents the type of identifier.
Define features either by adding a custom feature or selecting a pre-defined feature as shown:
To add a custom feature, click Add a custom feature and enter the relevant feature details:
To use a pre-defined feature, select the required feature from the Template features library.
You cannot revert to your UI-based project after Git conversion. Once converted, all the project edits and updates can only be done via Git repository.
Navigate to the Unify > Profiles option in the left sidebar to view all your Profiles projects.
Click Convert to Git button next to the project you want to convert.
Copy the SSH public key and click Add deploy key which will take you to your git repository’s Deploy keys section. See deploy keys section in the GitHub, GitLab, or Bitbucket documentation for more information.
Make sure your Git repository has at least one commit for successful validation.
Click Add deploy key, add a Title, paste your SSH public key, and click Add key.
Click Continue to let RudderStack verify read access.
Click Download project to download the Profiles project you set up in the dashboard.
Commit the downloaded project to your Git repository.
Once the project is committed successfully, return to the dashboard and click Convert Profiles project.
Run project
Once created, you can run your Profiles project using either of the following ways:
To download the Profiles project, click the arrow icon corresponding to your Profiles project and click Download this project:
Once downloaded, you can view the project folder structure, modify the files, or run various commands to execute the desired use-cases.
Project details
To view the Profile project details, click the arrow icon corresponding to your Profiles project:
Option
Description
Entities
Lists the entities, cohorts, features, activations, etc. for your Profiles project.
History
Displays the history of Profile runs.
Settings
Displays your profile settings and lets you delete your Profiles project. You can edit the project by clicking the edit icon next to each section.
Profile details
You can also view the details of a specific profile in your Profiles project:
In your Profiles project’s Entities tab, click View button across the entity for which you want to see the profile:
Click Profile Lookup tab to search a profile record.
Type an available unique identifier like email, phone number, user id, anonymous id etc. and click Search user profile.
Note that:
It can take a few minutes for the data preview to show up in your profile’s History tab.
If you keep getting a blank screen, it may be because you do not have sufficient access. Make sure you have a Connections Admin resource role with access to PII. In case the problem persists, contact RudderStack support.
FAQ
When trying to fetch data for a lib project, then data/columns are shown as blank. What should I do?
You’ll need to sync data from a source to a destination. If data is synced from the source you are using and not from some pre-existing tables in the destination, the missing column/data issues should not occur.
I am not able to see Unify tab on the web app though I have admin privileges. What should I do?
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.