Reference
About credentials¶
Use the Credentials page to view and manage credentials for data sources and destinations. Any credential that you add from the Sources or Destinations page is available from the Credentials page. You may also define credentials directly from this tab.
The credentials list shows the name, type, and description of each credential, the number of couriers and destinations that use it, and the date and time each credential was last updated. Credentials are specific to an external service. Any courier, destination, campaign, or Audience Monetization connection that uses the same service can use the same credential. For example, a single set of Braze credentials can be used by a destination that sends audience data, a courier that pulls data back, and a campaign.
To add credentials
|
From the Settings page, select the Credentials tab, and then click the Add credential button. |
|
In the Credentials settings dialog box, do the following: From the Plugin dropdown, select the name of application for which credentials are configired. Assign the credential a name and description that ensures other users of Amperity can recognize when to use this destination. |
|
The settings that are available for a credential vary by credential type. For the selected credential type, configure settings, and then click Save. OAuth credentials only A refresh token is generated by the OAuth process and authorizes Amperity to send data to the name of application for which credentials are configired. The value for the refresh token is automatically updated. |
How-tos¶
Tasks related to managing credentials in Amperity:
Note
Managing credentials requires the DataGrid Operator or DataGrid Administrator policy.
Add credential¶
Use the Add credential button to add a new set of credentials to Amperity.
To add a credential
Open the Settings page, and then select the Credentials tab.
Click Add credential.
From the Plugin dropdown, select the credential type.
Enter a name and description for the credential.
Enter the required credential settings.
Click Save.
Delete credential¶
A credential can only be deleted when it is not in use. The delete button is disabled when the Couriers or Destinations column shows a non-zero count. Remove the credential from all couriers, destinations, and campaigns that use it before attempting to delete it.
To delete a credential
Open the Settings page, and then select the Credentials tab.
From the row actions menu for a credential, select Delete.
Click Delete to confirm.
Edit credential¶
Use the Edit option to update the settings for an existing credential. For example, when an API key is rotated or a password changes.
To edit a credential
Open the Settings page, and then select the Credentials tab.
From the row actions menu for a credential, select Edit.
Make your changes.
Click Save.
Filter credentials¶
Use the credential type filter to narrow the credentials list to a specific type.
To filter credentials by type
Open the Settings page, and then select the Credentials tab.
Click Filters to expand the filter panel.
Select one or more credential types from the Credential type picklist.
Click Reset to clear all active filters.
Search credentials¶
Use the search bar to filter the credentials list by name or description.
To search credentials
Open the Settings page, and then select the Credentials tab.
Enter a search term in the Search credentials field. The list updates as you type.
View credential¶
Use the View option to open the settings for a credential without making changes.
To view a credential
Open the Settings page, and then select the Credentials tab.
Click the name of a credential, or open the row actions menu and select View.
Credentials by plugin¶
The following sections list the credentials for each of the destinations that are available in Amperity.
ActiveCampaign¶
ActiveCampaign is an automation platform for e-commerce, business-to-consumer, and business-to-business that helps you use email and SMS marketing to reach, nurture, convert, and grow your customer base.
ActiveCampaign requires the following credentials:
API key
The API key for your the name of application for which credentials are configired account.
Base URL
The base URL
for your the name of application for which credentials are configired account. For example: https://<your-account>.api-us1.com/api/3/.
Amazon S3¶
Amazon Simple Storage Service, more commonly referred to as Amazon S3, stores customer data files of any size in any file formats.
Amazon S3 supports the following credential types:
IAM role-to-role credentials require the name of the Amazon S3 bucket and the target role ARN. Amperity provides the values for the Amperity role ARN and the external ID.
IAM credentials require the name of the Amazon S3 bucket, the IAM access key, and the IAM secret key. An IAM role ARN is optional.
Acxiom¶
Acxiom collects, analyzes, and sells information about customers and businesses for use with targeted advertising campaigns.
Adobe Campaign¶
Adobe Campaign is a cloud-based service that manages direct marketing campaigns, leads, resources, customer data, and analytics.
Adobe Customer Attributes¶
Adobe Customer Attributes is a part of Adobe Experience Cloud. Upload visitor information as a set of customer attributes, and then make those attributes available to Adobe Target and Adobe Analytics.
Adobe Experience Platform¶
Adobe Experience Platform is a part of Adobe Experience Cloud that transforms data into robust customer profiles. Use updated customer profiles to optimize customer experiences across every channel.
Adobe Marketo¶
Adobe Marketo is marketing automation software that streamlines, automates, and measures marketing tasks and workflows.
Adobe Marketo requires the following credentials:
Client ID and client secret
A client ID is a unique identifier. A client secret is a unique string. Together they generate an access token that authorizes access to the Adobe Marketo REST API.
Custom services within the name of application for which credentials are configired give the client ID and secret .
Subdomain
The subdomain in the name of application for which credentials are configired in which Amperity manages audiences.
Adobe Target¶
Adobe Target is a set of tools for personalizing and optimizing customer experiences across digital channels, including websites, mobile apps, and social media platforms.
Adobe Target requires the following credentials:
API key
The authentication token is created from the the name of application for which credentials are configired user interface or from the Adobe Target Admin API .
Client code
The name of the the name of application for which credentials are configired client. The client code is located in the URL for your instance of the name of application for which credentials are configired. For example, “socktown” is the client code in the socktown.tt.omtrdc.net URL.
Airship¶
Airship is a customer engagement platform that helps marketers connect with their customers across every stage of the customer lifecycle.
Amazon Ads¶
Amazon Ads is an online advertising platform that helps brands meet their audiences where they shop, read, listen, and watch.
Attentive¶
Attentive is an automation platform for email and SMS marketing. Uses the Bulk attribute endpoint to extend customer profiles in Attentive with customer attributes from Amperity.
Use the subscriber segment upload process to manage lists of customers.
The API key must be associated with a custom app that has Custom Attributes and Subscribers set to Write. See Create and manage custom apps for details on updating app permissions.
Attentive requires the following credentials:
API key
The API key for your the name of application for which credentials are configired account.
Azure Blob Storage¶
Azure Blob Storage is an object storage solution for the cloud that stores massive amounts of unstructured data.
Azure Blob Storage supports the following credential types:
Connection string credentials a connection string and the name of the Azure Blob Storage container.
Shared access signature credentials require the account name, a shared access signature, and the name of the Azure Blob Storage container.
Storage URI credentials require a storage URI and the name of the Azure Blob Storage container.
BazaarVoice¶
Bazaarvoice allows retailers to manage user-generated content on their website.
Bluecore¶
Bluecore is a marketing technology company that intelligently connects casual shoppers to products with the goal of transforming those casual shoppers into lifetime customers.
Braze¶
Braze is a leading marketing automation platform for creating custom experiences based on sophisticated customer attributes and segments, and then mapping those experiences to campaigns.
Braze requires the following credentials:
API key
Required. The API key for your the name of application for which credentials are configired account.
Camelot SMM¶
Camelot SMM offers marketing strategies and media services to top brands of all sizes, leveraging data, technology, and industry-leading experience.
Cordial¶
Cordial is a cross-channel marketing and data platform that collects customer data into one platform for use with audience segments, trends, and automated customer experiences.
Cordial requires the following credentials:
API key
Required. The API key for your the name of application for which credentials are configired account.
API URL
Required. The API URL of your the name of application for which credentials are configired account. May be one of the following: https://api.cordial.io/, https://api.use1.cordial.io/, or https://api.usw2.cordial.io/.
Criteo¶
Send first-party audiences to your Commerce Growth seat at Criteo. Connect with relevant audiences actively in-market for products and services, retain customers with personalized ads and seamless omnichannel experiences that drive repeat purchases and long-term value, and personalize advertising to visitors who leave your website without making a purchase.
Cross Country Computer¶
Cross Country Computer specializes in strategic solutions for companies that are seeking to evolve their marketing methods around acquiring, retaining, and developing valuable customers.
Cheetah Digital¶
Cheetah Digital by Zeta is a customer engagement platform that helps marketers deliver personalized experiences, create effective cross-channel messaging, and increase customer loyalty.
Cheetah Digital requires the following credentials:
Username and password
The username and password for Cheetah Digital API authentication.
Databricks¶
Databricks offers a unified platform for data and AI that supports large-scale processing for batch and streaming workloads, standardized machine learning lifecycles, and accelerated data science workflows for large datasets.
Databricks requires the following credentials:
Server hostname and HTTP path
The cluster server hostname and HTTP path for the Databricks workspace.
Personal access token
A personal access token generated from the Databricks workspace.
Dotdigital¶
Dotdigital is a cross-channel marketing platform for building customer connections and personalized campaigns across channels.
Dotdigital requires the following credentials:
API username
The username for the API user with permission to access the name of application for which credentials are configired. The API user must have permission to access account information, create and update contacts, manage address books, and manage data fields.
API password
The password for the API user.
Dynamics 365 Marketing¶
Dynamics 365 Marketing helps you build personalized journeys for real-time and outbound marketing, along with event management capabilities.
Dynamics 365 Marketing requires the following credentials:
Azure tenant ID
The Microsoft Azure tenant ID for your instance of the name of application for which credentials are configired.
Azure client ID and client secret
A client ID and client secret for Microsoft Azure that has permission to access your instance of the name of application for which credentials are configired.
Emarsys¶
Emarsys is a customer engagement platform that helps marketers deliver personalized engagement across channels.
Emarsys requires the following credentials:
Client ID and client secret
The OAuth2 client ID and client secret for Emarsys API access.
Epsilon Abacus¶
Epsilon Abacus offers data and analytic expertise to help improve your marketing activities and deliver a greater return on your marketing investment.
Epsilon Conversant¶
Epsilon Conversant offers services to help marketers recognize and measure the value of personalization solutions.
Epsilon Targeting¶
Epsilon Targeting offers market intelligence solutions for understanding multi-channel buying patterns and habits, and then following-up with personalized messages for better marketing campaign results.
Experian¶
Experian offers credit reporting services and scores to businesses and consumers to help protect them from fraud and identity theft.
Google Cloud Storage¶
Google Cloud Storage is an online file storage web service for storing and accessing data on Google Cloud Platform infrastructure.
Google Cloud Storage credentials require the name of the storage bucket and the service account key.
Google Ads¶
Google Ads is search-based advertising that runs across the Google advertising network. Use search-based advertising to promote your brand, help sell products or services, raise awareness, and increase traffic to your website or stores.
Google Customer Match¶
Google Customer Match uses first-party data that your customers have shared with you to enable advertising across Google–including search (Google Ads) and display advertising (Display & Video 360), the Shopping tab, Gmail, and YouTube–to your customers and to similar audiences.
HubSpot¶
HubSpot is a CRM platform built around dedicated hubs for marketing, sales, services, content management, and operations.
Infutor¶
Infutor is a consumer identity management platform that helps brands understand their consumers and make informed marketing decisions. Infutor offers a secure, privacy compliant foundation that improves inbound engagements and outbound marketing reach and minimizes fraud and collections risk.
Insider One¶
Insider One is a growth management platform (GMP) for marketers. Personalize user experiences across web, app, web push, email, and SMS. Use advanced segmentation, behavioral insights, product recommendations and active communication widgets to boost customer engagement and conversions.
Insider One requires the following credentials:
Partner name
The Insider One partner name (must be lowercase). Found at InOne > InOne Settings > Account Preferences.
API token
The API authentication token. Found at InOne > InOne Settings > Integration Settings.
Iterable¶
Iterable enables brands to create, execute and optimize campaigns across email, push, SMS, in-app and more with unparalleled data flexibility.
Iterable requires the following credentials:
API key
A server-side API key from Iterable (Integrations > API Keys).
Base URL
The Iterable data center URL. Use https://api.iterable.com for US or https://api.eu.iterable.com for EU.
Kibo¶
Kibo offers solutions for customer segmentation and targeting, campaign testing and optimization, 1:1 personalization, audience insights, and customer recommendations.
See SFTP. Previously known as Monetate.
Klaviyo¶
Klaviyo is an email platform for targeting, personalizing, measuring, and optimizing email and Facebook campaigns.
Klaviyo supports the following credential types:
API key
Required. The API key for your the name of application for which credentials are configired account.
OAuth
Use OAuth to authorize Amperity to send data to the name of application for which credentials are configired. A refresh token is generated by the OAuth process that authorizes Amperity to send data to the name of application for which credentials are configired.
Koupon Media¶
Koupon Media provides a platform that enables brands and retailers to launch data-driven campaigns that combine loyalty programs and mobile offers for their most valuable customers.
LinkedIn DMP¶
LinkedIn DMP aggregates LinkedIn advertiser data to enable business-to-business (B2B) marketers to identify and reach target audiences across different platforms and ad exchanges.
LinkedIn DMP requires the following credentials:
Refresh token
An OAuth2 refresh token for LinkedIn DMP API access.
Listrak Email¶
Listrak enables personalized cross-channel interactions that help automate campaigns, build customer loyalty, and increase conversion rates.
Listrak requires the following credentials:
Email client ID and client secret
A client ID and secret for an email integration that is already set up in the name of application for which credentials are configired.
Tip
The client ID and client secret are available from the Integrations menu in the name of application for which credentials are configired. Open the Integrations menu, select Integrations Management, and then from the Integrations page choose an integration. The client ID and client secret are on the Setup tab.
Listrak SMS¶
the name of application for which credentials are configired is an automation platform for audience activation through mobile messaging campaigns and personalized SMS marketing.
Listrak SMS requires the following credentials:
SMS client ID and client secret
A client ID and secret for an SMS integration that is already set up in the name of application for which credentials are configired.
Tip
The client ID and client secret are available from the Integrations menu in the name of application for which credentials are configired. Open the Integrations menu, select Integrations Management, and then from the Integrations page choose an integration. The client ID and client secret are on the Setup tab.
LiveRamp¶
LiveRamp allows clients to combine customer data from various online and offline sources, centering around the use of web cookies that allow websites to remember visitors.
Mailchimp¶
Mailchimp is a cloud-based marketing automation platform and an email marketing service with an API that integrates third-party systems and a web UI that manages email contacts, templates, and lists.
Mailchimp requires the following credentials:
API key
Required. The API key for your the name of application for which credentials are configired account.
Meta Ads Manager¶
Meta Ads Manager is a unified ad creation tool that your brand can use to create and publish ads to Facebook, Messenger, Instagram and the Meta Audience Network.
Microsoft Advertising¶
Microsoft Advertising is a pay-per-click advertising platform that displays ads based on keywords in a user’s search query.
Microsoft Dataverse¶
Microsoft Dataverse is secure, cloud-based table storage for business applications. For example: Microsoft 365, Microsoft Azure, Dynamics 365, and the Microsoft Power Platform: Power BI, Power Apps, Power Automate, Power Virtual Agents, and Power Pages.
Microsoft Dataverse requires the following credentials:
Azure tenant ID
The Microsoft Azure tenant ID for your instance of the name of application for which credentials are configired.
Azure client ID and client secret
A client ID and client secret for Microsoft Azure that has permission to access your instance of the name of application for which credentials are configired.
Microsoft Dynamics¶
Microsoft Dynamics CRM is a customer relationship management (CRM) software application that supports sales, marketing, and services. It is part of the Microsoft Dynamics family of business applications.
Microsoft Dynamics requires the following credentials:
Client ID and client secret
A client ID and client secret with permission to access your instance of the name of application for which credentials are configired.
Neustar¶
Neustar–a TransUnion company–provides real-time information and analytics for the Internet, risk, digital performance, and defense, telecommunications, entertainment, and marketing industries. Neustar also provides clearinghouse and directory services to the global communications and Internet industries.
OAuth¶
OAuth is an open standard for access delegation, commonly used to grant websites or applications access to information on other websites.
A refresh token is generated by the OAuth process and authorizes Amperity to send data to the name of application for which credentials are configired. The value for the refresh token is automatically updated.
Oracle Data Cloud¶
Oracle Data Cloud is a set of solutions that enable agencies, brands, media platforms, and publishers to use data to drive better business outcomes.
Oracle Eloqua¶
Oracle Eloqua is a marketing automation platform that helps your brand design and manage cross-channel marketing campaigns.
Oracle Eloqua requires the following credentials:
Username
Required. A username with access to the application for which credentials are being configured. This username must have appropriate permissions for the configured remote folder.
Password
The password associated with the the name of application for which credentials are configired username.
Company name
The name of your company, as used within your the name of application for which credentials are configired account.
Oracle Responsys¶
Oracle Responsys is an email marketing product that helps improve conversions, strengthen customer relationships, and dramatically lessen messaging fragmentation.
Panda Printing¶
Panda Printing creates high-quality print and promotional products for businesses of all sizes. If you can think of it, they can print it.
PebblePost¶
PebblePost offers a full-stack solution that leverages scaled proprietary data, algorithmic optimization, advanced measurement and analytics, along with a print and mail logistics network.
Persado¶
Persado is an AI-driven content generation platform that uses segment data to personalize words, concepts, and ideas. Use Persado to increase purchases, loyalty registrations, automatic payment sign-ups, and self-service enrollments.
Pinterest¶
Pinterest is a visual discovery engine on which your brand can engage with your customers. Send a list of products that are in your product catalog to Pinterest to enable pins, and then send a list of customers with whom your brand wants to engage.
PowerReviews¶
PowerReviews is a user-generated content vendor that helps brands and retailers grow their business. Better quality customer product ratings lead to improved product quality and customer experiences.
Quad¶
Quad is a marketing solutions provider that combines a strong print foundation with an integrated marketing platform to help marketers improve spend efficiency across offline and online media channels.
Reddit¶
Reddit requires the following credentials:
Refresh token
An OAuth2 refresh token, auto-populated when you connect to Reddit using the Connect with Reddit button during credential setup.
RR Donnelly¶
RR Donnelly provides marketing and business communications, commercial printing, and related services.
Sailthru¶
Sailthru by Zeta is a cross-channel marketing platform built to deliver personalized experiences for consumers across email, web, and mobile channels.
Sailthru requires the following credentials:
API key
The API key for your the name of application for which credentials are configired account.
API secret
The API secret for your the name of application for which credentials are configired account.
You can find the API key and secret after you log in to the name of application for which credentials are configired and authenticate to the Sailthru API. The API key and API secret are available on the “Setup – API & Postbacks” page.
Salesforce Marketing Cloud¶
Salesforce Marketing Cloud is a provider of digital marketing automation and analytics software and services.
Salesforce Marketing Cloud requires the following credentials:
API client ID and client secret
The client ID and client secret for your brand’s instance of the Marketing Cloud REST API.
API authentication subdomain
The authentication subdomain for your brand’s instance of the Marketing Cloud REST API.
SFTP hostname
Required. The host name for the application for which credentials are being configured. For example: “sftp.acme.com”.
SFTP passphrase
Required. The passphrase associated with the username.
SFTP username
Required. A username with access to the application for which credentials are being configured. This username must have appropriate permissions for the configured remote folder.
Salesforce Sales Cloud¶
SalesForce Sales Cloud brings customer information together into an integrated platform, and then provides access to thousands of applications through the AppExchange.
Salesforce Sales Cloud requires the following credentials:
Username and password
The username and password of a Salesforce account configured for API access.
Security token
The Salesforce security token associated with the username. This setting is not required when configuring IP range policies from the Salesforce administrator console.
SFTP¶
Secure File Transfer Protocol (SFTP) is a network protocol that provides file access, file transfer, and file management over any reliable data stream.
SFTP sites require the following credentials, which can vary by SFTP site:
Hostname
Required. The host name for the application for which credentials are being configured. For example: “sftp.acme.com”.
Port
The port number for the application for which credentials are being configured. Use this setting only when the SFTP site uses a non-default port value.
Username
Required. A username with access to the application for which credentials are being configured. This username must have appropriate permissions for the configured remote folder.
Host public key
The host public key for the application for which credentials are being configured.
Private key
A private key for SSH authentication to the application for which credentials are being configured.
This setting is required by the “private-key” credential type.
Passphrase
Required. The passphrase associated with the username.
SMG¶
Service Management Group (SMG) helps brands boost loyalty and improve business performance by combining technology and differentiated, strategic services to collect, analyze, and share feedback and behavioral data.
Snapchat¶
Snapchat is a social media platform for accessing pictures and messages for a short time. Snapchat offers a self-serve platform from which brands can manage ads and advertising campaigns.
Snowflake¶
Snowflake is an analytic data warehouse that is fast and flexible. Snowflake uses a SQL database engine designed for the cloud.
Snowflake running in Amazon AWS requires the following credentials:
Username
A username with permission to access the name of application for which credentials are configired.
Password
The password for the username.
IAM access key
Required. The IAM access key, along with the secret key, that allows Amperity to authenticate to Snowflake.
IAM secret key
Required. The IAM secret key, along with the access key, that allows Amperity to authenticate to Snowflake.
IAM role ARN
The IAM role ARN used by Amperity to access Snowflake.
Snowflake running in Microsoft Azure requires the following credentials:
Username
A username with permission to access the name of application for which credentials are configired.
Password
The password for the username.
Account name
The unique name of an account that exists within your brand’s the name of application for which credentials are configired organization.
Shared access signature
The shared access signature that allows access to a Microsoft Azure Blob Storage container.
SoundCommerce¶
SoundCommerce is a data platform for consumer brands and retailers that spans marketing, merchandising, supply, fulfillment, delivery, and customer service.
TikTok Ads¶
TikTok is the world’s leading destination for short-form mobile videos. TikTok’s mission is to capture and present the world’s creativity, knowledge, and moments that matter in everyday life.
The Trade Desk¶
The Trade Desk is a platform for wide internet advertising and enables the use of UID 2.0 for first-party paid media advertising. You can send offline measurement data to The Trade Desk, and then use that data for attribution and targeting. Monetize your brand’s ID-based audiences by making third-party audiences available to advertisers for more granular targeting.
Your brand must have a UID 2.0 agreement in-place with The Trade Desk before configuring these destinations.
The Trade Desk requires the following credentials:
Advertiser ID
The advertiser ID for an account with the name of application for which credentials are configired.
Advertiser secret
The advertiser secret for an account with the name of application for which credentials are configired.
You can find the advertiser ID and secret key from the management console within the name of application for which credentials are configired. Open “Preferences”, and then “First Party Data Credentials” to view the advertiser ID and secret key.
Provider ID (third-party only)
The provider ID for your account with The Trade Desk. Ask your The Trade Desk representative for details.
Platform API token (third-party only)
A long-lived token that allows access to The Trade Desk Platform API.
Vibes¶
Vibes offers a variety of mobile marketing products and services, such as text message marketing (SMS or MMS), mobile wallet marketing, push notifications, and mobile web experiences.
Yahoo DSP¶
Yahoo DSP is a demand-side platform (DSP) to which you can send audiences. Advertise across the Yahoo brand ecosystem, including Yahoo, Yahoo Mail, TechCrunch, Yahoo Finance, Yahoo Sports, and Yahoo News.
Yahoo DSP requires the following credentials:
Seat MDM ID
Required. The “Seat MDM ID” is the value of your brand’s Master Data Management (MDM) ID in the name of application for which credentials are configired. This is a unique advertiser ID that assigns your brand a specific location within the the name of application for which credentials are configired taxonomy.
Zendesk¶
Zendesk is a service-first customer relationship management (CRM) application. Companies use Zendesk to improve customer relationships by providing support, chat, and community services that span channels.
Zendesk requires the following credentials:
API token
Required. Your brand’s Zendesk API token.
Email address
Required. The email address for the Zendesk API user.