Summary
Introduction
If you're new to Funnel or just never have had the need for a Custom Connector before, here's an introduction.
The main difference between a Custom Connector and Funnels Core Connector library is that a Custom Connector is built for you and your specific use case, which means they are not readily available for any user to just connect and reconfigure on their own.
If you need to make any changes to an existing integration using a Custom Connector, be it an already connected data source or the whole connector type, a new Custom Connector request is required. This is also the case whenever you want a new data source connected to a Funnel workspace.
Custom Connector Request Process
The steps needed to request new data in Funnel can be found in this article. Please include as much information with your request as possible! The more we know, the better we can help you. It’s always helpful to include an example report with your Custom connector request. This is true even for cases where the Custom Connector already has been built.
IMPORTANT: In cases where you are sending the data to Funnel, making changes to the report being sent before the data source is reconfigured may cause the data source to break. Once the data source breaks, an Integration Engineer will need to resolve the issue before future files can be ingested. For some common troubleshooting tips, go here.
Edit Configuration/Schema Change
When a Custom Connector type needs to be reconfigured to ingest a report with new or different fields, the Integration Engineers will need to know the following:
What changes need to be applied?
Attaching an example of the updated report(s) that will be sent is the easiest way to understand the necessary changes. If the data source is instead using a query to get the data, then please provide the updated query instead of/in addition to the report.
Which source(s) do these changes need to be applied to?
An easy way to identify a source is by its Data Source ID. You can find this information as a Dimension in the Funnel Data Explorer, underneath the Data Source drop-down menu.
Additional Data Sources of Existing Custom Connector Source Type
If additional sources of an existing custom source type are needed, then a Custom Connector Request is necessary to start the process. The Integration Engineers will need to know the following information:
What existing source type do you need additional sources of?
The easiest way to identify a source type is by its Data Source Type. This can be found as a Dimension in the Funnel Data Explorer, underneath the Data Source drop-down menu.
The number of sources required; in cases where it’s more than 1.
In which Funnel workspace the new data source(s) should be connected.
NOTE: If unspecified, by default the Integration Engineers will connect any new sources in the same Funnel workspace you submitted the Custom Connector Request from.