Administrators and Managers with Account-management permission can create a connection between Claravine and another account or platform. An Account will use an API connection to pull data into Claravine or push data from Claravine.
What is the difference between inbound and outbound?
- Inbound can pull in fields of data from an external solution which prepopulates information for review, modification and enrichment that the user would otherwise need to add manually
- Outbound can send out fields of data to an external solution to replace or enrich data.
Examples of account types:
|
Inbound |
Outbound |
Adobe Analytics |
Import classifications, not fields of data |
|
Adobe Experience Manager |
Coming Soon |
|
Adobe Workfront |
||
Amazon Web Services (AWS) S3 |
||
Bitly |
Outbound | |
Box |
||
Branch |
Outbound | |
Meta Ads Manager (includes Instagram) |
Outbound URL | |
Google Ads (formerly AdWords) |
||
Google Analytics |
Import dimensions, not fields of data |
Outbound |
Google Campaign Manager 360 (formerly DoubleClick) |
Outbound URL | |
Google Cloud Storage |
||
Microsoft Azure Blob Storage |
||
|
|
|
QRCode Monkey |
||
SFTP (not FTP) |
||
Snapchat |
|
|
TikTok Ads Manager |
|
Integration availability varies by contract. Please reach out to your CSM and/or Account Executive for more details.
View an Account
To view an account, navigate to Settings → Accounts. The Accounts page displays.
You can view the following information about Accounts:
- Name
- Type
- Description
- Date Added
The sort feature is available for all columns. You can sort all columns in ascending or descending order.
-
Create an Account
To create an Account:
- In the Accounts page, click the plus (+) sign to create a new account.
The Edit New Account menu displays. - Enter the following information for the Account:
- Name
- Description
- Select one of the following account types:
Account Types Required Account Information Adobe Analytics Company Name
Username
API Shared SecretAdobe Experience Manager Company Name
Username
Hosted URLAdobe Workfront General Claravine API access AWS S3 AWS Key
AWS Secret
User permission either s3:ListAllMyBuckets or enter bucket manually on each template
(How To Article: Applying Custom Permissions for AWS Accounts)Azure Blob Storage Azure Account Name
Storage KeyBitly Auth0 - Log in to authorize Claravine access Box Auth0 - Log in to authorize Claravine access Branch
1 Account per AppBranch Key
Branch SecretCampaign Manager 360 Service Account Key JSON File
Profile ID
Connected Email AddressAds Manager (Meta) Auth0 - Log in to authorize Claravine access Google Ads Customer ID
Manager Account IDGoogle Analytics Auth0 - Log in to authorize Claravine access Google Cloud Storage Service Account Key JSON File
(How to Article: Applying Custom Permissions for Google Cloud Accounts)Pinterest Auth0 - Log in to authorize Claravine access QRCode Monkey API Key SFTP Host
(Note: Do not include "sftp://" at the front of the host URL)
Username
Password
PortSnapchat Client ID
Client Secret
(How to Article: Applying Custom Permissions for Google Cloud Accounts)Secrets are securely stored and never viewable.
- Click Save.
Watch the Video
- In the Accounts page, click the plus (+) sign to create a new account.
-
Edit an Account
To edit an Account:
- On the Account page, click the name of the Account you want to modify.
The Edit Account menu displays. - You must enter the Required Account Information to make any changes to the Account.
- Click Save.
- On the Account page, click the name of the Account you want to modify.
-
Custom Field Mapping
All integrations come with a standard set of fields to map data from or to depending upon which type of integration you select. In many cases, this set of fields allows you to sync the majority of data you’d like. However, some products allow you to extend their standard set of fields through additional custom fields or properties — particularly enterprise applications. It’s also common that critical metadata is contained in those custom fields and should be standardized to ensure optimal results.
In order to target data in these custom fields via an integration, you can use custom field mappings to extend the base set of fields our integrations offer.
Supported Integrations
Custom field mappings are available for any integrations where the product allows custom fields or properties to be created. Currently, you can add custom field mappings to the Branch and Adobe Experience Manager integrations.
- For more on Branch key-value pairs, see their documentation.
- For more on Adobe Experience Manager custom properties, see their documentation.
If you have data in a custom field you’d like to sync through an integration other than those listed above, please contact your CSM.
Set Up Custom Mappings
Custom mappings are linked to each connected account you set up. To learn more about how to set up a connected account, see the Accounts Overview article.
Below is a video example of adding Custom Field Mapping to an AEM account.
To set up custom field mappings on a connected account:
- Navigate to Settings > Integrations > Accounts.
- Click the Account Name to open and edit a current configuration or the blue plus sign in the top right to add a new Account.
- Enter Username and Password credentials.
- Click Custom Field Mappings to expand the section at the bottom.
- Enter the API-friendly name of the field in the Remote Entity field (if you’re unsure, please contact the admin for that system at your organization or your CSM).
- Enter a user-friendly name in the Field Label field. This is only used for display when mapping fields on a template.
Add "custom" at the end of the user-friendly name to make it clear it is a custom field. - Click the Add New button to add multiple custom mappings.
- Click Save to save the connected account.
All done! Now, these custom fields will be available as field mappings when you configure an integration using this connected account.
Use Custom Mappings in an Integration
Once you have custom field mappings setup, you can access them while you setup mappings on an integration.
Below is a video example of adding the AEM Custom Field Mapping into an AEM Template.
To map data to a newly configured custom field, you will need to:
- Navigate to an existing template or create a new template. Read the Create a Template Start to Finish walk-through article.
- Navigate to Step 3 - Connect.
- Open an existing integration or click the plus sign (+) to add a new Inbound or Outbound integration, depending on if you are bringing data in or sending data out, to add a new Integration.
- Click to Add New Mapping.
- In the Map from {integration} drop-down list, type-search or scroll through the list to select a new custom field. In the Map to Claravine drop-down list, type-search or scroll select the field in the template to map to.
Only fields that have been added in Step 2 - Define and Govern will be available to map to. - Click Save to save your template.
After the save completes, the next scheduled sync will either sync data to/from the custom field depending on what integration you are using.
Remove Custom Mappings
To remove a custom field mapping, you will need to:
- Navigate to the connected Account.
- Click to edit its configuration in the sidebar.
- Click to expand the Custom Field Mappings section at the bottom of the edit menu.
- Click the delete button next to any of the custom mappings.
- Click Save to save the connected account.
Important Note: Removing custom field mappings will impact any syncs that use a custom field mapping. Please be sure to remove any field mappings to the custom field on all integrations prior to deleting the field mapping itself.
What's next?
- Read the Claravine + AEM Integration article
- Read the Claravine + Branch Integration article
-
Delete an Account
To delete an Account:
- On the Account page, click the name of the Account you want to remove.
- Click the Delete button.
A confirmation message displays. - Click Confirm.
- On the Account page, click the name of the Account you want to remove.
Learn More
Training in Claravine Academy:
Read the inbound and outbound template configuration Knowledge Base articles:
- AWS S3 Inbound Configuration
- SFTP Inbound Configuration
- Google Campaign Manager 360 Inbound Integration
- Workfront Inbound Configuration
- Ads Manager (Meta) Inbound Integration
- Adobe Experience Manager Inbound Integration
- Google Ads Inbound Integration
- AWS S3 Outbound Configuration
- Azure Blob Outbound Configuration
- Bitly Outbound Configuration
- Box Outbound Configuration
- Campaign Manager Outbound Configuration
- Meta Outbound Configuration
- Google Cloud Outbound Configuration
- QR Code Monkey Outbound Configuration
- SFTP Outbound Configuration
- Workfront Outbound Configuration
- Google Analytics Data Import Outbound Configuration
Comments
0 comments
Article is closed for comments.