Manage connections manage-connections
Once you have created or edited one or more connections, you can manage them in Connections. The Connections interface let you:
- View all your connections at a glance, including the owner, the sandbox, and when the connections were created and modified.
- Edit a connection.
- Delete a connection.
- Create a data view from a connection.
- View all datasets in a connection.
- Check the status of your connection’s datasets and the status of the ingestion process. For example, when is your data available so that you can start with reporting and analysis in Analysis Workspace.
- Identify any data discrepancies due to misconfiguration. Are you missing any rows? If so, what rows are missing and why? Did you misconfigure connections and cause missing data in Customer Journey Analytics?
- Get insights on the usage of ingested and reportable rows across all your connections.
Connections has two interfaces: List and Usage.
List
The List interface is the default interface for Connections. If not selected, select the List tab to access the interface.
The List interface shows a table of all connections available. You can quickly search for a connection using the Search
The following columns or icons are available in the table.
To view information about Datasets included, Sandbox, Owner, and more, select
A popup window displays details about the dataset.
Select
Connection type
One or more links to the datasets that are part of the connection. You can select the dataset hyperlink to view the dataset in the connection. If more datasets are part of the selected connection, select +x more to show a Datasets included panel. This panel shows links to all datasets and an option to
Select a dataset name to open the dataset in the Experience Platform interface in a new tab.
The status of importing new data for datasets:
The status for backfill data across datasets.
To configure which columns to display in the table, select
Edit a connection
To edit a connection:
- Select
- Select
Alternatively, you can:
-
Select the connection row.
-
Select
See Create or edit a connection for more information.
Delete a connection connections-delete
To delete a connection:
- Select
- Select
Alternatively, you can:
-
Select the connection row.
-
Select
When you delete a connection, a Delete connection panel indicates which data views are deleted and which workspace projects are affected.
-
In ➊ Info, the implications of the deletion of the connection are shown.
Select Continue to confirm the deletion.
-
In âž‹ Confirmation, enter the name of the connection in Type connection name, and select Delete to delete the connection. Select Cancel to cancel.
See Deletion implications for more information about deleting a connection.
Create a data view for a connection
To create a data view for a connection:
- Select
- Select
Alternatively, you can:
-
Select the connection row.
-
Select
See Create or edit a data view for more information.
Map a connection
To view a connection map that details the relationships between the datasets that are part of a connection:
- Select
- Select
Connection details connection-detail
To go to the details for a connection, select a hyperlinked connection name in the connections table.
The Connections details interface provides a detailed view of the status of a connection. You can:
- Check the status of your connection’s datasets and of the ingestion process.
- Identify configuration problems that can cause skipped or deleted records.
- See when the data is available for reporting.
Summarize the event, lookup, profile and summary dataset records that are added, skipped, and deleted, and the number of batches added. These metrics are based on the dataset and date range that you have selected.
Select Check detail to show the Check skipped detail popup. The popup lists the number of skipped records and the reason for all event datasets or selected dataset.
Select
A visualization to indicate how many rows were skipped in the selected time period, for the dataset and date range you have selected. Reasons for skipping records include: missing timestamps, missing or invalid Person ID or Account ID [B2B Edition]{class="badge informative" title="Customer Journey Analytics B2B Edition"}, and so forth. Updates every 10 minutes.
Invalid IDs (such as undefined
, or 00000000
, or any combination of numbers and letters in a Person ID that appear in an event more than 1 million times in a given month) are IDs that cannot be attributed to any specific user or person. These rows cannot be ingested into the system and result in error-prone ingestion and reporting. To fix invalid Person IDs or Account IDs [B2B Edition]{class="badge informative" title="Customer Journey Analytics B2B Edition"}, you have 3 options:
- Use Stitching to populate the undefined or all-zero user IDs with valid user IDs.
- Blank out user IDs, which are then skipped during ingestion (preferable to invalid or all-zero user IDs).
- Fix any invalid user IDs in your system before ingesting the data.
A visualization to indicate how many rows were deleted in the selected time period, for the dataset and date range you have selected. Someone might have deleted a dataset in Experience Platform, for example. Updates every 10 minutes.
In some scenarios, this value can also include records replaced, as with stitching or some lookup dataset updates. Consider this example:
- You upload one record to an XDM Individual Profile dataset, which Customer Journey Analytics is configured to ingest as profile lookup data. In the connection details, this dataset would display 1 record added.
- You upload a duplicate of the original record into the same AEP dataset, which now contains two records. Customer Journey Analytics ingests the additional record from the profile or account [B2B Edition]{class="badge informative" title="Customer Journey Analytics B2B Edition"} lookup dataset. Seeing that a profile or account record is already ingested in the connection for that Person ID or Account ID [B2B Edition]{class="badge informative" title="Customer Journey Analytics B2B Edition"}, Customer Journey Analytics deletes its earlier version and adds the new profile data. In the connection details, this action would represent 1 record added and 1 record deleted, because Customer Journey Analytics only retains the most recent profile lookup data for any ingested Person ID or Account ID [B2B Edition]{class="badge informative" title="Customer Journey Analytics B2B Edition"}.
- In total, the AEP dataset contains two records that happen to be identical. Separately, the Customer Journey Analytics connection details display the status of its ingested data: 2 records added and 1 record deleted for this profile dataset.
The datasets table displays the following columns for each dataset:
The status of importing new data for the dataset:
The transformation status of applicable B2B lookup datasets. See Transform datasets for B2B lookups for more information.
N/A for all other datasets, not applicable for transformation.
The status of backfill data for the dataset.
Connection panel
When no individual dataset is selected in the datasets table, the right panel shows connection options and details.