Integration settings

Integration settings

Integrations Overview

The Integrations tab in Settings provides a variety of options for data integrations with the platform.
  1. To access Integration Settings go to the gear icon in the top right corner and then click on Settings.
  2. Next click on the Integrations button at the top of the page. 


Select an integration card to view information for that integration. Integrations cards highlighted in blue denote existing integrations that have been setup, where non-highlighted cards denote integrations that are not currently setup.




Site Analytics

To learn how to integrate an analytics suite to your seoClarity account, visit our Integrations section of the Knowledge Base. 
Google Analytics: This setting allows you to authenticate Google Analytics, either Universal Analytics (UA) or GA4. Enabling goals will bring in the specified data for that conversion and allow for a custom name to be set. Learn More
Adobe Analytics: Integrate Adobe Analytics via the Partner Exchange integration Learn More. Once setup, goals that have been mapped for integration will be displayed.
Custom Analytics: Integrate any other analytics platform Learn More. Once setup, goals that have been mapped for integration will be displayed.

Search Analytics

Google Search Console: To leverage this setting, integrate Google Search Console Learn More. 
When adding a new Search Console profile, the profile must have permissions from the authenticated email. Multiple GSC profiles, such as for subdomains or subfolders, can be added for data integration. Search Console Property sets can be identified by name where they begin with  "sc-domain:". After a GSC profile is added, you can verify data is available by selecting the link to that profile within the table. To add a property to Google Search Console, click on the red Add Property button. In the pop-up that appears, type in the URL that you would like to manage in the text box and click Continue to verify the account. Accounts need to be verified before they can be added to seoClarity.
  1. Input the average conversion rate and average order value to view estimated conversion data. This will be shown in features like PPC vs Organic to provide a comparison estimate.
Once Google Search Console is authenticated in your seoClarity domain, you will see an option in Settings > Integrations > Google Search Console to "Ignore Fresh Data." Enabling this feature will prevent unfinalized Google Search Console data from displaying in Search Analytics.


Google Search Console via BigQuery: Google now allows Google Search Console users to export all of their data via an API to BigQuery set up in Google Cloud Services (Google announcement).

You can take the additional step of integrating that data export directly into a profile in seoClarity's Search Analytics.
Integration may incur an additional cost depending on the contract agreement.

CMS

Wordpress: This integration allows web pages in Wordpress to be created or updated via Content Fusion. Learn More

      Wordpress Integration Fields
  1. Wordpress Site: Provide the full domain name including the protocol.
  2. Username/Login: Provide the specific email address that will be used for publishing.

Workflow

Jira: Access to Jira and Admin access to seoClarity is required for integration Learn More. The Jira integration is user specific, which means each individual user that wishes to use the synch to Jira capabilities should provide their own credentials for the integration. This ensures that synched tasks in Jira show the correct user in the “Reporter” field. This helps maintains a clear log of which tasks have been created and assigned by which user.  If there is a SEO team login that is used for Jira, all users could use the same API token and other details, at the risk of losing visibility into who created and assigned which task. 

Jira Integration Fields
  1. Atlassian Email: This is the email address used to login to the Jira Cloud instance
  2. Atlassian API Token: This token can be retrieved within Jira by navigating to Account Settings >  Security > Create and Manage API Tokens. Detailed how-to instructions for this can be seen below.
  3. Atlassian Site: This is typically something like [company].atlassian.net and is reflective of the Jira cloud instance. 
Asana: Access to Asana and Admin access to seoClarity is required for integration Learn More

Asana Integration Fields
  1. Asana Email: This is the email address used to login to Asana.
  2. Asana Workspace: The name of the workspace that should be integrated. 
  3. Asana Personal Access Token: Create a new token via Asana Settings and enter it here.

Storage


seoClarity SFTP: Every domain in seoClarity has a corresponding FTP/SFTP location that you can connect to. This section also contains the login information for the domain specific SFTP location created by seoClarity. Learn More
Custom SFTP: The Custom FTP/SFTP setting allows for server locations to be added, which enables this server location to be an optional destination for dashboard reports. The table will displays any locations that have already been added. Existing locations can be deleted or edited via the actions dropdown and new locations can be added via the Add Server button. Learn More

      Custom SFTP Integration Fields
  1. Protocol: Choose either FTP or SFTP
  2. Destination Name: Provide a name to help identify the server location.
  3. Host: This is the domain where the server is located and is required.
  4. Port: SFTP server locations will require a port number, but FTP server locations might not.
  5. Username: This is the username required to access the server location
  6. Password: This is the password for the username required to access the server location.
  7. Folder: Use this optional setting if you'd like to specify a folder within the server location.

Amazon S3: Specify an Amazon S3 bucket for ease of exchange of data for bulk imports/exports by sharing the bucket policy file or providing S3 credentials. 
  1. Click on the Amazon S3 card. 
  2. Next in the right side window click on the Add button.
  3. Choose either Share S3 or Provide S3 Credentials.
      Share S3 Integration Fields
  1. Friendly Name: Provide a name for the S3 bucket. This is a required field. 
  2. Bucket: Enter the specific S3 bucket name. This is a required field. 
  3. Path: Enter the specific folder path within the bucket. This is a optional field.
  4. S3 policy snippet: Download the bucket policy and add it to the S3 bucket specified. View detailed tutorial
      Provide S3 Credentials
  1. Friendly Name: Enter a friendly name(Required)
  2. Access Key: Enter the access key(Required)
  3. Secret Key: Enter the secret key(Required)
  4. Bucket: Enter the bucket name(Required)
  5. Path: Enter the specific folder path within the bucket(Optional)
Google Cloud Storage: You can setup Google Cloud Storage as a storage endpoint for seoClarity data. Once the integration is setup, data will not automatically appear but can be requested to be sent there.

Google Cloud Integration Fields
  1. Friendly Name: Enter a friendly name. This is a required field.
  2. Bucket: Enter the bucket name. This is a required field.
  3. Path: Enter the specific folder path within the bucket (optional)

API

API Access: Get access to seoClarity's API for programmatic access to data and capabilities using your user and domain specific API Token.
  1. Generate a Token: Click on the API Access box to open the right side window where you can generate your own key.
    1. API keys are unique to the domain and the user, therefore you should not share this key.
Our Available APIs
  1. Platform Plugins that are accessible using your API key
    1. Google Docs Content Fusion Plugin
    2. Microsoft Word Content Fusion Plugin
    3. Microsoft Excel seoClarity Plugin
    4. Tableau Data Connector
    5. Google Looker Data Studio Integration
  2. Learn more about our Standard API
  3. Learn more about our Paid API
    1. Request a trial token for the Paid API from support@seoclarity.net or your CSM, and then try it out here


    Other

    Ahrefs: This integration allows for Ahrefs link data to be pulled into Link Profile in a streamlined fashion via the Ahrefs API Learn More. Once setup, the data is retrieved in bulk based on the API Subscription level (see table below for link availability). By default seoClarity will pull in 1% of the total monthly subscription on a weekly basis. You will need to have to the Ahrefs account open and the seoClarity Settings page. This integration requires an Ahrefs API subscription plan, which is a separate add-on from their regular membership.

          Ahrefs Integration Fields
    1. Ahrefs Email Address
    2. Ahrefs Password 
    3. Ahrefs API Access Token

    Cloudflare: Integrating seoClarity with CloudFlare allows for direct implementation of SEO fixes at the DNS level. A Cloudflare account is required to use the Cloudflare settings.

          Cloudflare Integration Fields
    1. API Token: Input the API token from the Cloudflare account. This can be found on the User Profile 'API Tokens' page.
    2. Account ID: Input the Account ID from the Cloudflare account. Once logged into Cloudflare for the domain to be integrated, this can be found via the API section of the Overview tab.
    3. Zone ID: Input the Zone ID from the Cloudflare account. Once logged into Cloudflare for the domain to be integrated, this can be found via the API section of the Overview tab. 
    Google Tag Manager: Integrating seoClarity with Google Tag Manager allows for direct implementation at the DNS level. A Google Account is required to use the Google Tag Manager settings.

          Google Tag Manager Integration Fields
    1. API Token: Input the API token from the  Google Account. This can be found on the Google API Console page.
    2. Activate the Tag Manager API in the Google API Console. (If the API isn't listed in the API Console, then skip this step.)
    3. When your application needs access to user data, it asks Google for a particular scope of access.
    4. Google displays a consent screen to the user, asking them to authorize your application to request some of their data.
    5. If the user approves, then Google gives your application a short-lived access token.
    6. Your application requests user data, attaching the access token to the request.
    7. If Google determines that your request and the token are valid, it returns the requested data.
    Google Business Profile: The Google Business Profile setting is for the enabled feature, Google Business Profile, that allows for integration of GBP from LocalClarity into seoClarity. A GBP account and LocalClarity subscription are needed to integrate GBP data.
    Google Business Profile Integration Fields
    1. Local Clarity Profile Name: Integrate GBP data by selecting your Local Clarity profile.
    2. Store Code: Displays the GBP store code for the specified location.
    3. Location Name: Displays the GBP name for the specified location.
    4. City: Displays the city for the specified location.
    5. State: Displays the state or region for the specified location.
    6. Country: Displays the country for the specified location.
    Google Ads: Authenticate and integrate Google Ads data securely for use in the PPC vs Organic report. Learn More
    Moz: Moz integration allows for metrics such as Page Authority and Moz Rank to be displayed within the platform. Integration requires Moz API credentials, which are different than Moz login credentials. Learn More
    Page Speed Integration: The Page Speed setting provides the ability to change the frequency of Page Speed retrieval for managed pages. How to generate a free Page Speed Insights API key can be found here.

          Page Speed Options
    1. Do not retrieve PageSpeed data: Selecting this option will stop the retrieval of Page Speed data for managed pages. 
    2. Retrieve PageSpeed for all tracked pages on Monthly basis: This is the default selection allows for the retrieval of Page Speed data for managed pages once per month. 
    3. Retrieve PageSpeed for select page tags on Weekly basis: Selecting this option requires a Google Page Speed API key is input and allows for the retrieval of Page Speed data for managed pages in the specified Page Tags once per week. Managed Pages that are not part of the Page specified Page Tags will not retrieve Page Speed data.
      1. Page Tag: The option to specify Page Tags for more frequent retrieval of Page Speed data will display when the weekly frequency option is selected.  
    Clarity360 Custom Data Source: Custom Data Source is a way to bring in URL level custom metrics. This feature adds columns for custom values Search Analytics. 
    Custom Data Source Integration Fields
    1. Storage Type: Choose whether to attach a file, or source from an S3 Bucket or SFTP Location.
      1. If attaching a file, upload file option will be available.
      1. If using an S3 Location, enter the S3 location and the full file path
      1. .
      2. If using SFTP, enter the full file path
    2. Friendly Name: Choose the display name for the file
    If you would like to enable this Custom Data Source feature, please contact support@seoclarity.net

    AI Search Indexer: Enable new pages are instantly indexed and available to AI search engines. Follow the steps below to enable instant indexation of any new pages discovered in AI and regular search engines via the ArcAI Indexer feature.
    AI Search Indexer Integration Steps
    Step 1: Download the Key file provided via the AI Search Indexer settings. 
    Step 2: Host the key file at the root of your website, i.e. https://www.example.com/[api-key].txt . This file must be uploaded as is. 





      • Related Articles

      • Wordpress Integration

        Wordpress Integration The default integration in our settings allows for Wordpress and allows web pages in Wordpress to be created or updated via Content Fusion. Once the Wordpress Integration has been set up, you will be able to use it. Best ...

      • Adobe Analytics Integration

        Overview For Adobe Analytics integration, this article outlines the steps needed to run through in order to grant seoClarity access to your account. Adobe eVars (Conversion Variables) are not needed for the Partner Exchange integration. In the Adobe ...

      • Google Search Console Integration

        Google Search Console Integration Overview The objective of this integration is to authenticate a Google Search Console account within seoClarity. This integration takes the place of the previous Google Webmaster Tools integration. Background & ...

      • Jira Integration

        Jira Integration The Workflow Integration setting allows for task management tools to be integrated into seoClarity tasks. This integration enables a two-way, real-time synch between seoClarity’s own task management system and the chosen third party ...

      • Security settings

        Security settings Overview The Security settings allows for additional custom measures to be enforced based on a user's IP address or email name. Enabling either setting will restrict users from logging in if there IP does not match the list provided ...