Articles in this section

Scope of ClickDimensions Support and Product Consulting

Avatar
Rhys Saraceni
  • Edited

Defining what is included in ClickDimensions support

For the ClickDimensions integration to function properly, the customer must provide a healthy, performant and accessible Dynamics CRM system. When an issue is encountered, the first task is to identify whether the source of the issue is ClickDimensions or the CRM system. This can require some initial investigation and troubleshooting. When this investigation is completed, it should be possible to draw a clear line as to whether ClickDimensions is responsible for the issue resolution, or the customer is responsible for addressing the cause within the CRM system.

To assist with drawing this line, the following table defines the various components of ClickDimensions and the scope of what ClickDimensions is responsible for supporting. Note that our entire application hosted within Azure is fully supported/in-scope. The below table only discusses the solution that is installed within the CRM system.

Note: While there are some articles included in the ClickDimensions help site/blog intended to assist customers in extending default ClickDimensions functionality, ClickDimensions is generally unable to support or advise on custom code or additions made to the ClickDimensions solution. Such cases are noted within the articles themselves and may be referenced by ClickDimensions Support.

Table of Contents

ClickDimensions Support

Supported and Out-of-Scope Components within Dynamics Solution

Component

In-Scope

Out-of-Scope

Solution – Initial Import and update

Errors encountered that are related to misconfiguration of the XML and other objects contained in the .zip file and for which ClickDimensions has the ability to specify definitions/configurations.

Examples of support issues:

  • Missing required components
  • Incompatible attributes or views in ClickDimensions entities (when previous version of ClickDimensions is already installed)

Errors encountered due to CRM platform issues.

Examples of out-of-scope issues:

  • Errors upon import due to reporting services
  • Errors upon import due to inability to register plugins
  • Errors upon import due to customized relationships in target environment
  • Time-outs during solution import
  • Hung solution imports with no timeout error produced
  • Errors caused by exporting ClickDimensions components from one environment as part of a customer-generated solution and importing into another

Updating ClickDimensions

Assisting with updating the ClickDimensions solution via the recommended methods, and/or troubleshooting errors that occur while properly updating the Clickdimensions solution.

 Assisting with issues and/or errors caused by using unsupported methods (i.e. selecting Upgrade/Stage for Upgrade/etc.) when importing the ClickDimensions solution.

Solution – Uninstall

N/A

The Dynamics platform is responsible for uninstallation operations. There is nothing within the code or customizations that ClickDimensions provides that can be modified or tweaked to change the outcome of an uninstallation attempt. In some environments, the installation of a managed solution and subsequent customization of the environment can produce dependencies that prevent uninstallation. In these cases, the customer is responsible for removing dependencies.

Solution Layers

Identification of issues related to solution layering or solutions created by the utilization of the 'Upgrade' option during the solution import process.  

Removal of additional solution layers created by not properly importing the ClickDimensions solution, and/or any solution layers not created by the default ClickDimensions functionality.

Entities (including entity settings, fields, forms, views and relationships)

Issues encountered with the entities as configured in the ClickDimensions solution .zip file.

Issues encountered due to customer’s customization of entities or entity components, whether default system entities or ClickDimensions custom entities.

Web Resources

Issues encountered with the web resources as configured in the ClickDimensions solution .zip file.

Examples include:

  • I-framed components rendering improperly
  • JavaScript on forms executing improperly

Issues encountered due to customer’s customization of web resources.

Workflows (Processes)

Issues resulting from a misconfiguration of the workflow process as delivered by ClickDimensions.

Issues encountered as a result of the CRM system not properly executing the workflow.

Plugin Assemblies and SDK Message Processing Steps

Issues resulting from a code error within the compiled plugin, how it is registered, or the security privileges the plugin requires as defined in ClickDimensions security roles in the solution as delivered by ClickDimensions.

Issues encountered as a result of the CRM system failing to properly execute the plugin.

Examples of out-of-scope issues:

  • Problems with the CRM Sandbox Processing Service
  • Problems related to timeouts due to CRM database performance

Dynamics CRM Dashboards and Charts

Issues encountered as a result of improperly configured dashboards and charts as delivered in the ClickDimensions solution .zip file.

Issues encountered as a result of the CRM system failing to properly render the dashboard or query the underlying data or with custom built charts/dashboards.

Reports

Issues encountered as a result of improperly configured RDL files as delivered in the ClickDimensions solution .zip file.

Issues encountered as a result of the CRM system failing to properly render the report or query the underlying data.

Security Roles

Issues encountered as a result of missing or improperly configured privileges as delivered in the ClickDimensions solution .zip file.

Issues encountered as a result of customizations to the ClickDimensions security roles or custom security roles created by customer.

 

Custom Code Policy

ClickDimensions cannot guarantee the behavior of customizations and modifications to elements that are added into our solution. Any custom code sections provided by our solution are intended for advanced users who are familiar with coding. If you would like to make changes to the existing ClickDimensions components, we recommend making and editing copies of these components within a separate solution to maintain default functionality and so they will not be overwritten by updates to the ClickDimensions solution.  The following are examples of things that our Support Team will not be able to advise on or troubleshoot:

  • HTML/CSS design in emails and web content
  • JavaScript design in web content
  • Building templates using the Custom HTML Editor
  • Programmatic Form Capture (the programmatic portion/non-ClickDimensions elements of the setup process)
  • Building custom CRM fields for the Lead/Contact/Account entity forms
  • Building custom sub-grids to display data on the Lead/Contact/Account entity
  • Advanced FreeMarker creation and/or troubleshooting
  • HTML/CSS/JavaScript not created by the ClickDimensions solution

 

Supported and Out-of-Scope Items Related to Connectivity

It is the customer’s responsibility to provide a working connection to their deployment of Dynamics 365/CRM if they are not using Dynamics 365 Online hosted by Microsoft. For on-premises or partner-hosted deployments, ClickDimensions recommends following Microsoft’s Internet-Facing Deployment (IFD) methodology. ClickDimensions does not provide support for configuring or troubleshooting IFD or other means of making the Dynamics 365/CRM deployment accessible from the internet.

NOTE: this excludes on-premises customers using the ClickDimensions SBRC proxy for connectivity. See SBRC documentation for support terms.

 

Customer Responsibilities for Dynamics Operability and Performance

It is the customer’s responsibility to provide a working, performant deployment of Microsoft Dynamics 365/CRM. Customer is responsible for maintaining and optimizing the functionality and performance of the Dynamics deployment. The ClickDimensions application relies on a well-performing Dynamics deployment to function properly. As such, ClickDimensions support requires:

  • Customers with on-premises or partner-hosted deployments of Dynamics must have a SQL maintenance plan in place that regularly updates indexes, recalculates index statistics, and releases free database space.
  • Customers with all deployment methods must implement a data-retention strategy to determine how long marketing data is retained for business needs. The data retention strategy should implement Dynamics bulk delete jobs that run on a regular schedule to remove aged data in order to maintain table size and control database growth.
  • Customer is responsible for resolving Dynamics performance issues, including long-running queries that exceed Microsoft timeout settings or breech limits such as the aggregate query record limit.
  • ClickDimensions does not support adding plugins or workflows that execute on the creation or update of ClickDimensions custom entities that are created by the ClickDimensions application. This includes such entities as Email Events, Sent Emails, Posted Forms, Posted Fields, Posted Surveys, and Posted Answers. Customers who implement plugins or workflows on these entities do so at their own risk.
  • ClickDimensions does not support customer modifications to the components in the ClickDimensions solution, including but not limited to javascript web resources, forms, security roles, or custom entities.
  • Dependencies created by customer’s customizations of ClickDimensions entities or solution components are not supported. Such dependencies may be encountered when attempting to remove or uninstall the ClickDimensions solution and are the responsibility of the customer.
  • The ClickDimensions solution requires the proper functioning of all elements of the Dynamics deployment, including the Sandbox Processing Service, SQL Reporting Services Report Server, Web Front-End/Application server, and Back-end Server and services. ClickDimensions does not provide technical support for the proper functioning of the components of the Dynamics deployment.

Supported and Out-of-Scope Items Related to Chat Support

Chat support is available to assist with quick, specific questions about the product or our documentation. These are some examples of what we are able to do on chat:
  • Provide documentation to assist with specific functionality.
  • Provide answers to specific questions about the product. NOTE: We are not able to provide training on the product or consulting services on a chat.
  • Provide basic troubleshooting steps or workarounds for known issues and use cases.

We intend chat to facilitate quick answers to basic questions. However, if something requires an investigation or if our documentation does not adequately address your use case, we will need to create a ticket. The chat agent will assess if creating a ticket is necessary as the chat approaches 15 minutes. We appreciate your patience and understanding if ticket creation is necessary.

Supported and Out-of-Scope Items Related to Deliverability

ClickDimensions has a Deliverability Team that can assist customers with certain configurations and practices related to email deliverability.The customer is primarily responsible for implementing changes related to their DNS. ClickDimensions does support some configuration changes on a per account basis as follows.

In Scope

  • Update DKIM signature
  • Update Sending Domain/White-labeling
  • Guidance on CNAME set up
  • Set up Dedicated IP
  • Investigate blocks (IP, domain, etc) + unblock
  • Investigate blacklisted IPs + delist
  • Investigate emails going to junk folder
  • Investigate technical issues related to email platforms
  • Recommendations on deliverability best practices including keeping data clean, CAN-SPAM and similar regulatory compliance questions, and inbox placement
  • Please be aware that support for delivery to organization specific domains is available, but limited.

Out-of-Scope

  • Update SPF record parts that are not related to CD
  • Update DMARC record
  • Adjusting spam filter settings outside of whitelisting IPs/domains
  • Interpreting Bounce Messages for isolated Email Events not related to an ongoing trend.
  • Creating, updating, or deleting of DNS resource records in the customer's namespace.

 

Product Consulting

NOTE: If you are interested in Product Consulting appointment services, contact your ClickDimensions Customer Success Manager for details.

Supported and Out-of-Scope Items Related to Product Consulting

Product Consulting is a paid appointment-based training service conducted by the ClickDimensions Product Consulting team. Appointments are one hour remote sessions where you will become an expert at achieving your business goals using the ClickDimensions software.

Product Consultants provide customers with personalized training and "do it with me" assistance on features within the ClickDimensions solution to execute marketing strategies. From the creation and technical setup of ClickDimensions content, as well as the reporting on ClickDimensions data, customers will obtain the knowledge and skills to get the most out of the product.

There are four types of assistance a Product Consultant can provide on ClickDimensions features:

In-depth Training, Content Creation, Technical Setup, or Reporting.

  • In-depth Training: Overview and detailed how-to instruction on ClickDimensions features
  • Content Creation: Assistance in building ClickDimensions content
  • Technical Setup: Assistance in setting up the more technical ClickDimensions features
  • Reporting: Training on ClickDimensions reports or analyzing ClickDimensions data

 

In Scope:

In-depth Training, Content Creation, or Reporting appointment topics include:

  • Building Email Templates (Drag & Drop, Block and Freestyle Editors)
  • Training and Consulting on FreeMarker in Email Templates (personalization tool, custom entities and one variable conditional statements)
  • Training on sending ClickDimensions emails (individual or bulk Email Sends, InboxCast, or Quick Sends)
  • Email Statistics (Sent Email Send, Sent Emails, Email Events, Excluded Recipients/Emails)
  • Training on unblocking email addresses
  • Building ClickDimensions Forms
  • Building ClickDimensions Surveys
  • Building ClickDimensions Landing Pages
  • Building Subscription Management (building Subscription Lists, attaching Subscription Lists to Marketing Lists, setting up Subscription Management Page or Form, setting up double opt-in process)
  • Building Campaign Automations
  • Training on CNAME and Domain records in CRM
  • Lead Scoring
  • Training on using and analyzing Event and Event Participation records
  • Building SMS Messaging (how to send individual and bulk text messages)
  • Training on the ClickDimensions Import Tool
  • Web Tracking
  • Analyzing Web Analytics
  • Training on Event Connectors and their data (GoToWebinar/Eventbrite/WebEx/Cvent)
  • Training on RSS to Email connector
  • Building and posting Social Posts
  • Incorporating multiple elements together (ex: Form leading to a Campaign Automation launch)
  • Leveraging the Social Engagement portal (Oktopost)

Technical Setup appointment topics include:

  • Assist with lead scoring setup
  • Assist with ClickDimensions web tracking setup (main and optional Tracking Scripts)
  • Assist in importing records using the ClickDimensions Import Tool
  • Assist in connecting third party forms to ClickDimensions via Form Capture setup
  • Setting up event connectors (GoToWebinar/Eventbrite/WebEx/Cvent)
  • Setting up other connectors (Social Posting, RSS to Email, SMS Messaging)
  • Setting up Domain and CNAME records in CRM

 

Out-of-Scope:

The following list details the specific topics Product Consulting appointments cannot cover:

  • Custom CRM Charts/Dashboards
  • HTML/CSS design in emails and web content
  • JavaScript design in web content
  • Building templates using the Custom HTML Editor
  • Programmatic Form Capture (the programmatic portion/non-ClickDimensions elements of the setup process)
  • Building custom CRM fields for the Lead/Contact/Account entity forms
  • Building custom sub-grids to display data on the Lead/Contact/Account entity
  • Advanced FreeMarker creation and/or troubleshooting
Was this article helpful?
10 out of 19 found this helpful

Related articles