IdentitySync is Gigya's ETL solution (Extract, Transform, Load) that offers an easy way to transfer data in bulk between platforms. Use it to transfer user data from Gigya to a third-party platform or vice versa, or even from one Gigya database to another.
With IdentitySync, you can:
- Take all the permission-based social and profile identity information stored at Gigya and channel it into another platform, such as an ESP, CRM, or marketing automation system.
- Get up-to-date data from a 3rd party platform, such as newsletter subscription status, survey responses or account balance, and import it into Gigya.
IdentitySync jobs can be carried out on a one-time basis, for example if migrating data, or they can be scheduled to run on a regular basis in order to keep your platforms synchronized.
Each IdentitySync job runs a dataflow. The building blocks of the dataflow are dedicated scripts. Each script is responsible for performing a single task, such as:
- Extracting accounts from Gigya based on specific parameters
- Changing some field names
- Creating a CSV file
- Uploading a file to a given FTP
Scripts can be added to the dataflow, removed or changed as needed.
The following chart is a visualization of a dataflow in IdentitySync. This dataflow exports user accounts from Gigya to a partner platform (Krux).
Each step in the dataflow runs a separate script.
The above flow demonstrates a split dataflow. Dataflows are split using the next parameter. For more details, see Customize the Dataflow.
IdentitySync gives you the flexibility to use your data in any way you need. For example, with IdentitySync, the following scenarios are supported:
- Retrieve all accounts that have remained unverified or unregistered for over a week (isVerified==false or isRegistered==false and created>'one week ago'), export the relevant email addresses to an ESP, from which to send follow-up emails.
- As a sports club, regularly import accounts from an external ticketing system, thus fortifying your fanbase.
- Query the audit log to retrieve deleted users, and use a batch job to other external systems so that they can be deleted from there, too.
User Segmentation and Progressive Profiling
- Set up data fields for segmenting users according to certain types of behavior in your site - such as Loyalty interactions, purchases or page visits (people who like and share content related to tabi socks, or have purchased said socks) then use an IdentitySync job to send only users that match these criteria to a marketing system for a targeted campaign (50% off in our summer sock sale).
- Use a Gigya-toGigya IdentitySync job to query users by Facebook likes stored in their profiles - for example, people who like vampire and zombie related content - and to plant a value (e.g. "horrorFic") in a Gigya data field. Then launch a gruesome Halloween marketing campaign targeting these users.
- Use an IdentitySync job to initialize default data to a Boolean field (e.g. set to null), and using custom script that is activated according to this value, trigger a progressive profiling screen that requests more information from site visitors.
For full, up-to-date details of the service's capabilities, see the Script Repository.
|Main Supported Data Sources/Targets||Sample Transformations||Main File Formats|
Main file formats supported:
A dataflow is a complete definition for a transfer of information between Gigya and a third-party platform in a specific direction.
The dataflow includes all the necessary information about where the data is extracted from, which data is extracted, how the data is processed, and where the data is transmitted.
For details, see Dataflow Object
Steps are the building blocks of the dataflow. Each step is a call to a script that performs a specific task, such as extracting accounts from Gigya, or compressing a file in GZIP format. The step calls the script with specific parameters, and the output is passed on to the next step in the dataflow for further processing. For example, "datasource.read.gigya.account" is a script that searches the Gigya account database and returns all accounts that match specific parameters (an SQL-like search query). This script will typically be called in the first step in a dataflow that exports accounts from Gigya to a partner platform. Each step includes the following attributes:
- id: the unique identifier of the step within a given dataflow. Each step has to have an ID so it can be called by other steps in the "next" attribute.
- type: the ID of the IdentitySync script used in this step (see Script Repository).
- params: an object defining the parameters passed in this IdentitySync script.
- next: an array containing one or more IDs of the next step(s) to be carried out.
- A step to which no other step refers in the next attribute is automatically considered the entry point of the dataflow.
- Steps which do not have a next attribute are automatically considered end-points of the dataflow.
- Assign multiple values to a next attribute to split the dataflow. See example.
Data File Example
The following is an example of a data file in DSV format. The quotes around each field can be removed.
Note that IdentitySync jobs are scheduled in UTC time. Therefore, the platform participating in the flow should be set to the UTC timezone to ensure that file requests are handled properly.
To create an integration based on IdentitySync, complete the following process:
1. Arrange Permissions
Partner ID Permissions
Before IdentitySync can work with any specific partner ID, it needs to be given permissions to the partner.
- If you don't have the necessary permissions (extended permissions) to the partner ID, request them.
If you have permissions to do so, call admin.updateGroup. If you do not, open a SalesForce case requesting to add this partner to the IDX system. Include the following details in your request:
|partnerID||The partner ID.|
|groupID||_idx_application_viewers - for jobs that read data from Gigya|
_idx_application_editors - for jobs that write data to Gigya
2. Create Data Flow
Open IdentitySync Data Flows in Gigya's Console. Make sure your are signed in and have selected the relevant site. The IdentitySync dashboard may also be accessed by clicking Settings in the upper menu and then IdentitySync Data Flows in the left menu.
In the dashboard, click Create Data Flow.
In the Create Data Flow window, select the data flow integration from the dropdown. If the flow you wish to create is not available in the dropdown, select a different one: this selection is of a template only, and the flow is customized in the next steps. For more information, see Dataflow Templates.
Select the data flow template: the direction of the flow, whether from or into Gigya. Note that at the bottom of this window, you can see an outline of the flow that will be created (e.g., Account > rename > dsv > gzip >sftp).
Click Continue. As a result, the Create Data Flow screen opens in the dashboard.
Relevant IDX API Methods:
3. Customize the Data Flow
The data flow you created is built of the required steps for data transfer between Gigya and the selected vendor. Use the Script Repository to understand the structure and parameters required in each step, and to add or remove steps as needed. For example:
- Specify passwords, IDs, API keys etc. required for accessing each system and customer database.
- Add the fields you wish to transfer between databases.
- Flatten fields, remove non-ASCII strings, specify the compression type, parse in JSON or DSV format, etc.
- Change the name and/or description of the data flow itself, at the very beginning of the flow.
- Split a data flow, for example if you want to create two duplicate files and upload each file into a different destination. To do so, in the next attribute, reference the next two steps rather than just one. For a sample dataflow which employs this method, see the Epsilon Dataflow.
Finally, click Create Data Flow.
Your dashboard should now look something like this:
The following actions are available:
|Edit||Opens the current data flow in the Edit Data Flow window and change any of its attributes, steps and parameters using the Script Repository.|
|Run Test||Runs the data flow once on 10 records for test purposes. If the test was successful, after refreshing the dashboard, you will see the timestamp of the test run under Last Successful Run. For a detailed report of the test results, at this current stage of development, use idx.search and retrieve the JobStatus object. Later on, job status reports will be available within the dashboard.|
|Duplicate||Useful for creating a new data flow based on a flow which has already been customized, if you wish to create a similar flow with slight variations.|
|Status||Displays the status of the current jobs running in your IdentitySync configuration.|
4. Schedule the Dataflow
- Under Actions, click (schedule) to open the Scheduler.
- Click Create Schedule.
- Configure the schedule:
- Enter a schedule name
- Change the start time as needed
- Choose whether to run once or at scheduled intervals
- "Pull all records" should usually be selected only in the first run, when migrating records from one database to the other, and in any case should be used with caution. If the checkbox is not selected, and this is the first time this dataflow is run, records will be pulled according to the following logic:
- If the dataflow is set to run once, all records from the last 24 hours will be pulled.
- If the dataflow is recurring, records will be pulled according to the defined frequency. For example, if the dataflow is set to run once a week, the first time it is run, it will pull all records from the previous week.
- (Optional) Enter the email adress(es) for success and failure of the dataflow run.
- (Optional) Limit to a specific number of records. This is usually used for test runs: when running a test from the dashboard, a one-time schedule is created which runs immediately for 10 records.
- Click Create, and, once you are back in the Schedule dashboard, click the Refresh button.
Relevant IDX API Methods:
Test and Monitor
Test the data flow by clicking(run test) under Actions. This creates an immediate one-time run for 10 records. If the run was successful, after refreshing the dashboard (with the Refresh button) you will see its timestamp under Last Successful Run.
You can monitor data flows by reviewing previous runs (jobs). The job history displays the status of each run, its start and end times, and the number of records for which the data flow was completed successfully (under Processed).
Under Actions, click the Status buttonto open the Job History screen.
For advanced debugging, click the info icon for the relevant job under Details, and the Job Status Detail screen opens.
You can use the idx.search method to receive job history data.
Depending on your networking policies, you may have to add the IPs of IdentitySync servers to a whitelist in order to allow IdentitySync to upload/pull information. The relevant IPs are: EU Data Center: US Data Center: AU Data Center: CN Data Center: RU Data Center
Depending on your networking policies, you may have to add the IPs of IdentitySync servers to a whitelist in order to allow IdentitySync to upload/pull information.
The relevant IPs are:
EU Data Center:
US Data Center:
AU Data Center:
CN Data Center:
RU Data Center