DestinationsLast Updated: 2022-01-25
Once your Records have all the data you need via Properties and Groups, you're ready to setup your Destinations. Destinations are the places you want to send your customer data so you can take action on your workflows. See this doc to learn more about the core concepts in Grouparoo.
Here's how to send Records, Groups, and Record properties to Destinations:
Select your Model from the navigation bar, scroll to the Destinations section, and click the "Add new Destination" button.
Choose the kind of Destination you'd like to create from the list of available Apps. The choices shown will be based on which Apps you've already connected. If you don't see the App you want to use, you can add a new App.
Once you've selected the type of App, the specific questions and settings will vary.
Here is Mailchimp as an example. Mailchimp has audiences that each have a
listId. You can choose the specific
listId you'll want to set for this Destination.
In addition to any Plugin-specific Destination options, you will also be asked to choose a Sync Mode. Grouparoo supports 3 types of Sync Modes which determine how we deal with creating and deleting records for the Destination.
- Sync (
sync): Add, update, and remove Records as needed.
- Additive (
additive): Add and update Records as needed, but do not remove anybody.
- Enrich (
enrich): Only update Records that already exist in the Destination. Do not add or remove anybody.
Not all plugins support all types of Sync Modes.
Next, you can choose which Record properties you want to send to your Destination. Usually, a unique Record Property such as
user id will be required so the Destination knows how to identify records and to keep records separate.
Lastly, you can choose how Group membership appears in your Destination. This Mapping lets you decide how Groups are represented in your Destination. Often groups are shown as
tags in these Destinations.
Generated Config File
Grouparoo's UI Config will write a JSON file to your local filesystem based on your inputs. That file will be placed in the
config/destinations directory in your Grouparoo project. You can further edit this file locally or through the UI Config.
You're all set! Once you have an App, Model, Source, a few Properties, at least one Group, and a Destination, you have all the pieces you need to start syncing customer data!
UI Config offers an additional benefit of sampling data as you go. If you haven't added any sample records, you may want to check that out before moving on to running the App.Add Sample Records
If you have any additional questions, see the Community doc for ways to connect with the Grouparoo team.