Overview

GIGYA was purchased by SAP and is now SAP Customer Data Cloud.

GIGYA offers a suite of social plugins including social login, sharing, identity management, mobile website integration, and subscriptions.

Integrating Lytics with GIGYA allows you to pull insights from your users' login patterns, subscriptions, and GIGYA ID which is often used as an identifier across platforms. You can also export Lytics audience membership containing behavioral scores and content affinities to personalize your brand experiences delivered to existing GIGYA users.

Authorization

If you haven't already done so, you will need to set up a GIGYA account before you begin the process described below. If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

  1. Select Gigya fraom the list of providers.
  2. Select the Gigya method for authorization.
  3. In the Label text box, enter a name for the authorization
  4. (optional) In the Description text box, enter a description for this authorization
  5. from the Datacenter input, select the GIGYA datacenter your account uses. See GIGYA's documentation for more information.
    6.In the API Key text box, enter your Api Key from your GIGYA account dashboard.
  6. In the User Key text box, enter User Key from your GIGYA account settings by navigating to Your name > Account.
  7. In the Secret Key text box, enter your Secret Key from your GIGYA account settings
  8. Click Save Authorization.

gigya-auth

Import Users

Import GIGYA contacts and email subscriptions into Lytics to build a more complete view of your customers. You can import from full accounts and lite GIGYA (SAP Customer Data Cloud) accounts.

Integration Details

  • Implementation Type: Server-side Integration.
  • Implementation Technique: REST API Integration
  • Frequency: Batch Integration with option for continuous, hourly updates.
  • Resulting data: User Profiles and User Fields.

This integration utilizes the GIGYA APIs to import user data. Once the import is started the job will:

  1. Validate credentials by getting the user schema.
  2. Search for users that have been updated since the last import.
    1. Initial search request: SELECT * FROM accounts WHERE lastUpdatedTimestamp >= <last import date> ORDER BY lastUpdatedTimestamp LIMIT 10000, and openCursor = true.
    2. Page through results.
  3. Search for lite users that have been updated since the last import.
    1. Initial search request: SELECT * FROM emailAccounts WHERE lastUpdatedTimestamp >= <last import date> AND hasLiteAccount=true AND hasFullAccount=false ORDER BY lastUpdatedTimestamp LIMIT 10000, and openCursor = true.
    2. Page through results.
  4. Search for subscriptions that have been updated since the last import.
    1. Initial search request: SELECT * FROM emailAccounts WHERE subscriptions.<subscription name>.email.lastUpdatedSubscriptionState > <last import date>, and openCursor = true.
    2. Page through results.
  5. Ingest the data from the searches into the gigya_users stream.

Fields

The following fields are included in the default mapping of the gigya_users stream:

Source FieldConditionalLytics User FieldDescriptionType
addressaddressAddressstring
birth_daybirth_dayBirth Daystring
birth_monthbirth_monthBirth Monthstring
birth_yearbirth_yearBirth Yearstring
citycityCitystring
countrycountryCountrystring
createdgy_user_createdGIGYA Profile Createddate
email(email)email unique idEmail Addressstring
emaildomain(email)email_domainEmail Domainstring
facebook_idfb_uid unique idFacebook User IDstring
first_namefirst_nameFirst Namestring
gendergenderGenderstring
google_idgoogle_id unique idGoogle IDstring
idgy_profile_id unique idGIGYA Distinct IDstring
instagram_idinstagram_id unique idInstagram IDstring
is_registeredgy_is_registeredGIGYA Is Registeredstring
last_logingy_user_last_loginGIGYA Profile Last Logindate
last_namelast_nameLast Namestring
last_updatedgy_user_updatedGIGYA Profile Updateddate
login_providergy_login_providerGIGYA Login Providerstring
map(subscription_name, double_optin-status)IF exists(subscription_name)gy_subscription_optin_statusGIGYA Subscription Optin Statusmap[string]string
map(subscription_name, subscribed)IF exists(subscription_name)gy_subscriptionsGIGYA Subscriptionsmap[string]bool
map(subscription_name, todate(modified))IF exists(subscription_name)gy_subscription_modified_dateGIGYA Subscription Modified Datemap[string]time
site_idgy_site_idGIGYA Site IDstring
statestateStatestring
tobool("true")IF eq(lite_account, "false") OR eq(full_account, "true")gy_lite_accountGIGYA Lite Accountbool
twitter_idtw_uid unique idTwitter User IDstring
twitter_nametw_user_screenname unique idTwitter Usernamestring
zipzipZipstring

Configuration

Follow these steps to set up and configure an import job for Gigya in the Lytics platform. If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

  1. Select Gigya from the list of providers.
  2. Select the Import Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Complete the configuration steps for your job.
  7. (optional) In the Import Since text box, enter the date from which you want to import data using the YYYY-MM-DD format. If left blank, Lytics will import all available data.
  8. (optional) From the Extended Data Fields input, select additional data fields to import to Lytics. Basic profile data will automatically be imported.
  9. (Optional) Toggle Show Advanced Options. Select the Keep Updated checkbox to run this import hourly.
  10. Click Start Import.

gigya integration import config

Export Users

Export Lytics audience membership to your existing GIGYA users to enrich your marketing efforts with cross-channel data, behavioral scores, and content affinities from Lytics.

Integration Details

  • Implementation Type: Server-side Integration.
  • Implementation Technique: REST API Integration.
  • Frequency: Batch Integration.
  • Resulting data: Array of audiences the user is a member of.

This integration utilizes GIGYA APIs to send user data. Once the export is started the job will:

  1. Iterate through users in the selected audience.
  2. Get the audience membership for each user.
  3. Export the user's audience membership to either:
    1. Data store.
    2. User's account.

Fields

By default, Lytics exports the following fields to GIGYA:

Lytics User FieldDescriptionGIGYA FieldType
GIGYA IDGIGYA IDUIDstring
Audience MembershipArray of audiences the user is a part of.lytics_segments[]string

Configuration

Follow these steps to set up and configure an export job for Gigya in the Lytics platform. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

  1. Select Gigya from the list of providers.
  2. Select the Export Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to export.
  7. Complete the configuration steps for your job.
  8. (Optional) Toggle Show Advanced Options.
    • (optional) From the Gigya ID Field input, select the field name that contains the Gigya unique id.
    • (optional) From the Storage input, select where the user fields get stored in GIGYA.
    • (optional) Select the Keep Updated checkbox, to continuously run this export.
    • (optional) From the Time of Day input, select time of day to start export each day.
    • (optional) From the Timezone input, select timezone for time of day.
  9. Click Start Export.
    gigya integration export config