Configuring DNN connectors

Overview

This article provides a guide to configuring the Evoq Connectors that reach out to third-party services such as Zendesk, Azure, Google Analytics, and MailChimp.

 

Prerequisites

 

Solution

To configure a connection to an external service:

  1. Go to Persona Bar > Settings > Connectors.
    Persona Bar > Settings > Connectors

     

  2. Under Configure Connections, choose the service provider in the list and click/tap Connect or Edit.

    Configure Connections expanded tabs
  3. Provide the information required by the service provider.
     
    Tip: Some connectors can be configured further in the Advanced Settings dialog. If available, simply click/tap Connect, then click/tap the gear icon for that connector.

     

    Connectors gear icon
     
    Below are the input settings required to complete the configuration of each external connector.
     
    Provider Fields
    Amazon S3
    • Access Key ID
    • Secret Access Key

    How to get your Amazon S3 access key ID and secret.

    Azure
    • Storage Account Name
    • Storage Account Key
    • Container (This input appears after connection to azure has been made). The type of data that you want to be synchronized with Azure.
      • backups
      • portals
      • wad-iis-logfiles (Azure logfiles)

    How to get your Azure account name and key.

    Box
    • Client ID
    • Client Secret

    How to get your Box client ID and secret.

    Disqus
    • Disqus Shortname
    • API Key

    How to get your Disqus shortname and API key. Disqus URL is Disqus Shortname; the Public Key is the API Key.

    DropBox

     

    Snipaste_2021-10-29_20-42-39.png

     

    Facebook
    • App ID
    • App Secret

    How to get your Facebook app ID and secret.

    Google Analytics
    • Tracking ID

    How to get your Google Analytics tracking ID.

    Click/tab the gear icon to create segmentation rules in Advanced Settings. For each rule,

    • Name and Value. The key-and-value pair that defines the criteria for the segmentation. Example: To create a segment that includes the activities of registered users only,
      • Set Name to Registered User.
      • Set Value to True.
    • Page. The pages whose associated activity to analyze.
    • Role. The roles whose associated activity to analyze.

    For more information, see How to Segment Your Visitors in Google Analytics Using Evoq and Set Up Site Search in Google Analytics.

     

    Google Analytics Advanced Settings
    LinkedIn
    • API Key
    • API Secret

    How to get your LinkedIn API key and secret.

    MailChimp
    • API Key

    How to get your MailChimp API key.

    After saving the API Key, click/tab the gear icon to configure user and list associations in Advanced Settings.

     

    MailChimp Advanced Settings
    Marketo
    • Munchkin Account ID

    How to get your Marketo Munchkin account ID.

    Optimizely
    • Optimizely Snippet

    How to get your Optimizely snippet.

    Twitter
    • API Key
    • API Secret

    How to get your Twitter API key and secret.

    ZenDesk
    • Zendesk URL
    • Agent Email
    • Agent Password

    How to create a ZenDesk agent.

    Click/tab the gear icon to select fields to track in Advanced Settings.

    • Select Additional Fields

     

    Zendesk Advanced Settings
  4. Click/tap Save.

 

Testing

You can test that the connection has been successful by:

  1. Accessing the Persona > Settings > Connectors menu
  2. You should see a green checkbox next to the connector that you've configured.

    2020-05-21_1603.png

  3. Test the relevant external service via the service's module or the Evoq feature its related to.

Comments

1 comment

  • Avatar
    Alberto Troiano

    For Dropbox, it says to scroll down to Where can I find my app key and secret?. Should be Where can I get my app key and secret?.

    -1
    Comment actions Permalink

Please sign in to leave a comment.