Silverpop

Skip to end of metadata
Go to start of metadata

 

Overview

Gigya’s integration with Silverpop combines Gigya's rich social info with Silverpop's automated digital marketing in order to target users more accurately in marketing campaigns and newsletters. Account data can be synchronized between Gigya and Silverpop on a recurring basis (daily batch transfers) or on demand.

In addition to basic user profile and social data, the integration supports synchronization of:

  • Complex social data such as Likes and Favorites from Gigya
  • Data from premium Gigya services such as Loyalty (Game Mechanics) and Signals
  • Scoring: if you use Silverpop's scoring models to rank the strength of your contacts, any scoring data can be synchronized to Gigya
  • SMS Campaigns: Phone numbers can be imported from Gigya in order to support SMS campaigns.

Information about users who have opted in or opted out is also transferred into Gigya with this integration.

Integration with Silverpop is a premium service and can only be activated if your site package includes Gigya's Identity Access and Storage or Registration-as-a-Service. For activation and more information, please contact your Gigya Account Manager or contact us by filling in a support form on our site.

Implementation

The integration will be set up and operated by Gigya based on your needs.

However, you will need to configure your Silverpop database(s) for the integration, and share some configuration details with your Gigya Implementation Consultant.

In addition, you can set up inbound and outbound flows using IdentitySync. See IdentitySync Integration.

Information to Provide to Gigya

Information to Provide to GigyaNotes
Your Engage pod numberFor example, if you access engage5.silverpop.com, 5 is the pod number.

OAuth application details:

  • Client ID
  • Client Secret
  • Refresh token
See: Set up an OAuth application
The ID of any database (or list, or query) you want to synchronize with Gigya.See: Set up your database

Table IDs for optional relational tables:

  • Likes table ID
  • Favorites table ID
  • GM table ID
  • Signals table ID
Whether to synchronize phone numbers from Gigya

Whether to synchronize scoring data from Silverpop to Gigya

  • If the answer is yes: the names of the scoring fields

Configuration Steps

1. Set Up an OAuth Application

  • In your Silverpop dashboard, go to Settings > Organization Settings > Application Account Access.
  • Click Add Application.
  • Enter the name Gigya and click Add.

Click to enlarge screenshot

The system displays the Client ID and Client Secret for the Gigya application. Copy these details to give to your Gigya Implementation Consultant

Click to enlarge screenshot

  • Back in the Application Account Access box, click Add Account Access.
  • Select the Gigya application you just created and select a user account.
  • Click Add.
  • A Refresh Token enabling access to the Gigya application will be sent to the user account's email address.

Click to enlarge screenshot

 

2. Set Up Your Database

When configuring your Silverpop database, you can choose either of two options:

  • Set up one database for each newsletter (best practice).
  • Have multiple newsletter fields in one database.

Discuss this choice with your Gigya Implementation Consultant as it will affect the configuration of the integration on the Gigya side.

This integration does not modify the contact's opted-in/opted-out status in Silverpop directly. Instead, information about unsubscribed users is transferred from Gigya to Silverpop by updating custom fields that have been added to the Silverpop database. Each field is set to "true" for contacts who are subscribed to a particular newsletter or "false" for contacts who are unsubscribed.

This means that when creating email campaigns, you should filter the database based on contacts that have the relevant newsletter field set to "true".

(a)  Go to Data > Database and select the database you want to use, or click Create to create a new database.

  • If you are creating a new database, select the database type Single Opt-In Database.
  • For the database name, use the format “Customer name” + “Database name”, e.g. "NewsMedia_ sports". This makes the database easier to identify in Silverpop reports and logs.

Click to enlarge screenshot

(b)  In the database, go to the Fields tab and add the newsletter field(s). For each field:

  • Enter the field name: food, sports, etc.
  • For Field Type, select Yes/No.
  • Click Add Field.

Click to enlarge screenshot

(c)  Next, add a field for the Gigya ID:

  • Give the field a name such as UID.
  • In Field Type, select Text.

    If this is a new database, set the Gigya UID field as the primary key for the database.

(d) In a similar way, add fields for any user data you would like to import from Gigya.

3. Configure Your Time Zone

To make sure your Silverpop account is set to GMT:

  • Go to Settings > User Accounts.
  • Select the user account you will be using for the Gigya integration.
  • In the View/Edit User page, under Time Zone, choose GMT.

Click to enlarge screenshot

4. Create Relational Tables (Optional)

Relational tables enable you to import complex data fields such as favorites, likes, loyalty (Game Mechanics) data, etc. from Gigya. If you only intend to synchronize simple data fields, you may skip this step.

To add a relational table:

  • Create a CSV file containing the field names you want to import from Gigya. The file should contain only field names (column names), no data.

Click to enlarge screenshot

  • Go to Data > View Data and click the Relational Tables tab.
  • Select Import > Import New.
  • Enter a name for the new table, browse for the CSV file you created, and click Next.

Click to enlarge screenshot

  • In the next page, check the First row contains field names checkbox and click Next.

Click to enlarge screenshot

  • In the next 2 pages, accept the default settings and finish the table creation process.
  • Go to your database and select the Fields tab.
  • Select Associate Table and in the list that is displayed, select the new relational table you created.
  • Select Map Fields.
  • Associate the relational table to the database through the Gigya UID field.

Click to enlarge screenshot

Click to enlarge screenshot

You will be requested to provide the Table ID to your Gigya Implementation Consultant.

To find the Table ID:

  • Click the table name in the Associated Relational Tables list.
  • In the Relational Table Summary page, click Show Additional Details.
  • Copy the Table ID that is displayed on the right side of the page.

Click to enlarge screenshot

Notes:

  • There is a limit of 10M records in total for all relational tables, although this can be modified by Silverpop.
  • The relational table has a reserved field named "email"; we cannot import to the email field, the import will fail

5. Set up SMS Synchronization (Optional)

To use Silverpop's SMS capabilities:

  • Activate SMS according to the instructions in the Silverpop documentation.
  • Make sure your Gigya integration includes synchronization of phone numbers from Gigya to Silverpop (this is implemented by your Gigya Implementation Consultant).

6. Set Up Scoring Synchronization (Optional)

To use Silverpop's scoring models:

  • Set up a scoring model for your database according to the instructions in the Silverpop documentation. This process creates new fields in your database to hold scoring data.
  • Make sure your Gigya integration includes synchronization of the scoring fields from Silverpop to Gigya (this is implemented by your Gigya Implementation Consultant).

IdentitySync Integration

If you are using IdentitySync, you can set up dataflows to import subscriber data from Silverpop to Gigya and export from Gigya to Silverpop. For sample dataflows, see: 

 

  • No labels