Overview
Gigya’s integration with Selligent integrates Gigya's rich, permission-based social and other profile info with Selligent's data-driven, multi-channel marketing services.
The integration requires no implementation by the customer. Just contact your Gigya Implementation Consultant and we will handle the details. You can specify exactly which social and site data you want Gigya to synchronize.
The integration synchronizes user data between Gigya and Selligent on a recurring basis (daily) or ad-hoc, including:
- Creating and updating users in Selligent based on information from Gigya.
- Updating user data in Gigya based on information from Selligent.
- Integration is by transferring single value Gigya user account fields such as name, age, address or email. Field names are matched with corresponding fields on the target system. Gigya account fields which hold complex multi-value object data such as user photos' URLs or Facebook likes cannot be integrated using this method.
Integration with Selligent is a premium service requiring activation. For more information, please contact your Gigya Account Manager or enter a support request on our site.
Configuration Parameters
Please create a test site in the Gigya admin console for integration testing (don't use your production site) and use a test list on the target integration platform. We are able to put integrations in "sample mode" for testing, which will restrict audiences to 10 sample accounts.
Setting up the Gigya- Selligent integration requires the following configuration information:
Parameters for General Integration Configuration
| Required | Name | Value | Description |
|---|---|---|---|
| [general] Section | |||
| | esp.update.hour | e.g. 22:00 | The time of day that that synchronization will run. By default it is read in the format of HH:MM. Time is set in 10 min. intervals. (e.g 20:10) |
| | gigya.api.key | The unique API key associated with your site in the console | |
| | getGm |
| Set to "true" to enable file flattening for Loyalty (Game Mechanics) data. To implement this data flattening, you need to specify the appropriate mapping (see [fieldMapping] section). See field.array.extract for an example of the output. |
| | getCounters |
| Set to "true" to enable file flattening for Counters data. To implement this data flattening, you need to specify the appropriate mapping (see [fieldMapping] section). See field.array.extract for an example of the output. |
| [fieldMapping] Section | |||
| | Mapping of field names in the source platform to field names in the target platform. Each Gigya field must map to a single field in the destination partner's platform. Format: "sourcefield=targetfield". For example: [fieldMapping] profile.email = email profile.UID = GigyaUID profile.firstName = First_Name profile.lastName = Last_Name Additional configuration options:
| ||
Parameters for FTP Configuration
| Required | Name | Type | Description |
|---|---|---|---|
| | fileNamePrefix | string | The outbound file name prefix created is {fileNamePrefix}{fileNameDateFormat}. We recommend indicating the company name in {fileNamePrefix}. |
| | fileNameSuffix | string | The suffix should include the extension of the created outbound file. (e.g. ".csv", ".txt"). |
| | fileNameDateFormat | string | Format for the filename timestamp. This should be in one of the simple date formats. Default: yyyyMMdd_HHmm For example, if we transfer a .csv file to a company called "ACME Inc." on March 22, 2015 at 11:15pm, the file may be named acme_20150322_1115.csv. Date-only formats (such as YYMMDD - without Time) are permitted, but in that case, if the file is transferred more than once a day, it will have the same name each time, and may overwrite a previously transferred file. |
| | fileDelimiter | char | Character used to distinguish columns in the CS file. Supported values are comma (","), semicolon (";"), pipe ("|") and tab ("\t"). |
| | outbound.compress | string | Determines whether compression is used, and if so, specifies a format. Permitted values are:
|
| | esp.storage.protocol | string | "SFTP" or "FTPS". |
| | esp.storage.server | string | IP of the destination server. |
| | esp.storage.port | string | Port on the destination server. |
| | esp.storage.user | string | File storage account user name. |
| | esp.storage.pass | string | File storage account password. |
| | esp.storage.key | string | If a value is entered, this field is used instead of the SFTP password, otherwise the SFTP password will be used. The key should be in OpenSSH format. For more information see http://www.ietf.org/rfc/rfc4716.txt. |
| | esp.storage.phrase | string | IF SFTP is used, a pass phrase can be set for additional security. This is the passphrase. |
| | outbound.completePopulationFolderName | string | Name of the folder to populate the full data import on the outbound server. |
| | outbound.deltaPopulationFolderName | string | Name of the folder to populate the data updates on the outbound server. |
Parameter for Data Filtering
| Required | Name | Type | Description |
|---|---|---|---|
| | ae.filterClause | string | An SQL-like query specifying the data to retrieve from Gigya on outbound data transfers. Refer to the filter criteria in the Identity Query Tool. |
Parameters for Inbound Data Transfers
| Required | Name | Type | Description |
|---|---|---|---|
| | inboundFilePattern | string | Gigya will search for files with a prefix, sorted by date: "Prefix*.extension". |
| | esp.sync.unsubscribed.hour | String | The time of day to retrieve unsubscribe actions in the format of HH:MM. Time is set in 10 min. intervals. (e.g 20:10) |
Compression Support
Gigya supports transmitting files in compressed format. By default files are not compressed, but you can set up gzip or LZO compression.
Example of Selligent integration with the Gigya platform
The following screenshot shows an example of a Selligent screen after an integration with Gigya:
