Tealium Learning Center

This article describes how to set up the Adform Segments connector. In this article: API Information This connector uses the following vendor API: API Name: Adform API API Version: v1 API Endpoint: https://api.adform.com/v1/dmp Documentation: Adform API Connector Actions Action Name AudienceStream EventStream Add User to Audience Segment ✓ ✓ Remove User from Audience Segment ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Client ID Required. Provide your Client ID. Client Secret Required. Provide your Client Secret. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Add User to Audience Segment Parameters Parameter Description Audience Segment ( sg ) Select Audience Segment or type Owner ID. Adform Partner ID (Required) The Adform Partner ID of your account. UID ( uid ) Adform ID Visitor Attribute GAID ( gaid ) Google Advertiser Visitor ID attribute IDFA ( idfa ) Apple Identifier for Advertisers First Party Data Source Text for the source or technology provider responsible for the included IDs. This should be a top-level domain. For example, netid.de First Party Agent Type An integer that identifies the type of user agent that the user identifier is from. Possible agent type values: 1 - Collected from a desktop device in a browser. 2 - Collected from an app (in-app) on a mobile device (for example, IDFA or AAID). 3 - A user-based ID, which is the same across multiple devices and applications. 500+ - Vendor-specific context and ID, vendor-specific codes. First Party ID An identifier for the first-party ID from the source provider. This might be a long string or a GUID. Action — Remove User from Audience Segment Parameters Parameter Description Audience Segment ( sg ) Select Audience Segment or type Owner ID. Adform Partner ID (Required) The Adform Partner ID of your account. UID ( uid ) Adform ID Visitor Attribute GAID ( gaid ) Google Advertiser Visitor ID attribute IDFA ( idfa ) Apple Identifier for Advertisers First Party Data Source Text for the source or technology provider responsible for the included IDs. This should be a top-level domain. For example, netid.de First Party Agent Type An integer that identifies the type of user agent that the user identifier is from. Possible agent type values: 1 - Collected from a desktop device in a browser. 2 - Collected from an app (in-app) on a mobile device (for example, IDFA or AAID). 3 - A user-based ID, which is the same across multiple devices and applications. 500+ - Vendor-specific context and ID, vendor-specific codes. First Party ID An identifier for the first-party ID from the source provider. This might be a long string or a GUID. ... View more

This article describes how to set up the AT Internet Piano Analytics connector. In this article: Batch Limits This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 100 Max time since oldest request: 5 minutes Max size of requests: 1 MB Connector Actions Action Name AudienceStream EventStream Send Event ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Collection Domain Required: The collection endpoint for your organization. Collection Path Required: The collection path. Site ID Required: The data source site ID. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. For more information about AT Internet Piano Analytics Connector parameters, see the Collection API documenation. Action — Send Event Parameters Parameter Description Event Type All Standard events are supported. To send a custom, non-standard event, select the Custom option and provide the Custom Event Type value in the Event Properties section. Date Formats Specify the date format when populating event property. Only milliseconds since epoch UTC (or CDH Date Attributes) are formattable, otherwise the action will fail. Map the following date formats: YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDTHH:mm:ssZ, UNIX. IP Address IP address of the client. Referer Address of the page sending the data. User Agent User agent of the client. If this field is not mapped, it will be auto-mapped to the User Agent attribute in Tealium EventStream API Hub and to the visitor’s last User Agent attribute in Tealium AudienceStream CDP. Visitor ID Unique identifier of the visitor. If this field is not mapped, it will be auto-mapped to the Tealium Visitor ID. Previous URL The previous page URL. If this field is not mapped, it will be auto-mapped to the Current URL attribute in EventStream and to the Entry URL attribute in AudienceStream. Device Timestamp UTC Device timestamp UTC in seconds. Date attributes are converted to UNIX timestamp. Event Collection Platform Collection platform used. Event Collection Version Version of the collection platform. Device Manufacturer Manufacturer of the device. Device Model Model of the device. Device Display Height Height of the viewport. Device Display Width Width of the viewport. Device Screen Height Height of the device screen. Device Screen Width Width of the device screen. Campaign Medium Required property for tracking marketing campaigns. Campaign Name Required property for tracking marketing campaigns. Campaign Creation The campaign creation. See the AT Internet Piano Analytics Connector Collection API documentation for usage examples. Campaign Variant The campaign variant. Campaign Format The campaign format. Campaign Type The campaign type. User ID Map this field to track authenticated users. User Category Map this field to track authenticated users. Goal Type Set Goal Type to track a conversion. ... View more

This article describes how to set up the DMD connector.  DMD, an IQVIA Business, is the only provider of healthcare data that is first-party sourced, 100% opted-in, and privacy and regulatory compliant. This DMD Email Connector allows users to send campaign emails to HCP/HCOs based off of CDP actions. In this article: Batch Limits This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met: Max number of requests: 100 Max time since oldest request: 15 minutes Max size of requests: 1 MB Connector Actions Action Name AudienceStream EventStream Trigger Custom Event ✓ ✗ Trigger Email Message ✓ ✗ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: API Username Username for the Oracle Responsys account. API Password Password for the specified user. Login Endpoint Select the login endpoint for the authentication. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Trigger Custom Event Parameters Parameter Description Event Name Required: Custom Event Name. Folder Name Required: Folder Name. Object Name Required: Profile List Name. Email Format Required: Email Format, either TEXT_FORMAT or HTML_FORMAT . Customer ID Customer ID. Mobile Number Mobile number, value can be NULL . Recipient ID Recipient's RIID, value can be NULL . Email Address Recipient's plain text email address. Email Address (already SHA256 hashed) Recipient's SHA256-hashed Email address. Email Address (apply SHA256 hash) Recipient's email address, which will receive a SHA256 hash. Email Address (already MD5 hashed) Recipient's MD5-hashed Email address. Email Address (apply MD5 hash) Recipient's email address, which will receive an MD5 hash. Number Data Mapping   Date Data Mapping   String Data Mapping   Optional Data Optional data containing name-value pairs. Action — Trigger Email Message Parameters Parameter Description Campaign Name Required: Name of the Campaign. Email Format Required: Email Format. Customer ID Customer ID Mobile Number Mobile number, value can be NULL . Recipient ID Recipient's RIID, value can be NULL . Email Address Recipient's plain text email address. Email Address (already SHA256 hashed) Recipient's SHA256-hashed Email address. Email Address (apply SHA256 hash) Recipient's email address, which will receive a SHA256 hash. Email Address (already MD5 hashed) Recipient's MD5-hashed Email address. Email Address (apply MD5 hash) Recipient's email address, which will receive an MD5 hash. Campaign Folder Name Optional: Campaign Folder Name. Object Name Optional: Profile List Name. Optional Data Optional data containing name-value pairs. ... View more

This article describes how to set up the Veeva CRM connector. In this article: Connector Actions Action Name AudienceStream EventStream Insert into Custom Object ✓ ✗ Update Custom Object ✓ ✗ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Endpoint URL Required: Provide the endpoint URL. Default URL is https://login.salesforce.com/services/oauth2/authorize Establish Connection Click Establish Connection to connect to your Salesforce account. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Insert into Custom Object Parameters Parameter Description Custom Object Name Name of custom object. Insert Data Map Insert data map configured in Salesforce. Action — Update Custom Object Parameters Parameter Description Custom Object Name Name of custom object. Lookup Data Map Select attribute to look up custom object by. Update Data Map Update data map configured in Salesforce. ... View more

This article describes how to set up the Twitter Conversions connector. In this article: API Information This connector uses the following vendor API: API Name: Twitter Ads API API Version: v10 API Endpoint: https://ads-api.twitter.com/ Connector Actions Action Name AudienceStream EventStream Send Conversion Event ✓ ✓ Configure Settings Twitter Conversions requires allowlisting on your Twitter account. For assistance with allowlisting, contact your Twitter representative.. Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Event Source ID The base-36 ID of a specific event, matching that of a pre-configured event contained within this ad account. This is called Website Tag ID in the Ads Manager, and Ads API and must be a Single Event Tag. This value can be created in the following ways: Within the Single-Event Website tag configuration. Log in to your ads account at ads.twitter.com and select Events Manager under Tools. Use the API. See Web Event Tags for more details. Contact your Twitter account manager. Ad Account ID Provide your Twitter ad account ID. Account ID appears in your account's URL when you are logged in. For example, if the URL is https://ads.twitter.com/accounts/1234abcd/ , then the account ID is 1234abcd . Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Conversion Event Parameters Parameter Description Account ID Override (required) The leveraged account's ID. Required for all Advertiser API requests, excluding GET accounts. This account must be associated with the authenticated user. Event Source ID Override (required) The base-36 ID of a specific event, matching that of a pre-configured event contained within this ad account. This is called Website Tag ID in the Ads Manager, and Ads API and must be a Single Event Tag. Conversion Time (required) The conversion event's date and time, in ISO 8601 format. If not available, defaults to the time of the event. Twitter Click ID (recommended) The Twitter Click ID, as parsed from the click-through URL. For example, 26l6412g5p4iyj65a2oic2ayg2 . Email Address (already SHA256 hashed, recommended) A hashed email address (SHA256) in lowercase format, and without trailing or leading spaces. Email Address (apply SHA256 hash) An email address in lowercase format and without trailing or leading spaces. Conversion Value When the conversion type is a purchase, the price of purchased items in the specified currency. Number of Items When the conversion type is a purchase, the number of items being purchased. Must be a positive integer greater than zero. Currency When the conversion type is a purchase, the currency in which to filter results by, in ISO-4217 format (for example, USD for US dollars). Event Source URL The URI-encoded URL source of the conversion event. For example:  https%3A%2F%2Fwww.twitter.com%2Fhome . ... View more

This article describes how to set up the Google Ads Enhanced Conversions for Leads connector. In this article: API Information This connector uses the following vendor API: API Name: Google Ads API API Version: v10 API Endpoint: https://googleads.googleapis.com/ Documentation: Google Ads API: Upload Enhanced Conversions For Leads Batch Limits This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met: Max number of requests: 2000 Max time since oldest request: 10 minutes Max size of requests: 2 MB Connector Actions Action Name AudienceStream EventStream Send Conversion ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Customer ID Required: Provide Ads account customer ID to manage. Manager Customer ID Optional: If you're accessing a client customer, the Manager Customer ID must be set. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Conversion Parameters Parameter Description Conversion Action Select existing conversion action with a type of UPLOAD_CLICKS and enhanced conversions enabled. For more information, see the Google Ads Enhanced Conversion Tracking article in the Google documentation. Email Address (already SHA256 hashed) Provide an email address which has been already whitespace trimmed, lowercased and SHA256 hashed. Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses before hashing. Email Address (apply SHA256 hash) Provide a plain text email address and the connector will remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses, whitespace trim, lowercase, and hash this value using SHA256 hash. Phone Number (already SHA256 hashed) Provide a phone number according to the E164 standard that has been already whitespace trimmed, lowercased and SHA256 hashed. Phone Number (apply SHA256 hash) Provide a plain text phone number and the connector will remove all non-digit symbols, prefix the number with a plus sign (+), whitespace trim, lowercase, and hash this value using SHA256 hash. gclid Google click ID (gclid) associated with the conversion. Note: If you provide gclid and user_identifiers (email/phone) for a conversion, Google Ads will ignore the user_identifiers . Conversion Value Monetary value of the conversion. Conversion Currency Currency code of the conversion. Conversion Time The date time at which the original conversion occurred. The timezone must be specified. The format is yyyy-mm-dd hh:mm:ss+|-hh:mm. For example, 2022-01-01 12:32:45-08:00. Default value is now. Order ID The order ID associated with the conversion. An order ID can only be used for one conversion per conversion action. Custom Variables The custom variables associated with this conversion. Map the value to the custom variable ID. The connector will send conversion_custom_variable field in the following format: customers/{customer_id}/conversionCustomVariables/{custom_variable_id}. Merchant ID The Merchant Center ID where the items are uploaded. Feed Country Code The country code associated with the feed where the items are uploaded. Feed Language Code The language code associated with the feed where the items are uploaded. Local Transaction Cost Sum of all transaction level discounts, such as free shipping and coupon discounts for the whole cart. Product ID The shopping ID of the item. Must be equal to the Merchant Center product identifier. Provide array type attribute to add multiple items. Array type attributes must be of equal length. Single value attributes can be used and will apply to each item. Quantity Number of items sold. Provide array type attribute to add multiple items. Array type attributes must be of equal length. Single value attributes can be used and will apply to each item. Unit Price Unit price excluding tax, shipping, and any transaction level discounts. Provide array type attribute to add multiple items. Array type attributes must be of equal length. Single value attributes can be used and will apply to each item. ... View more

This article describes how to set up the Basis Technologies DSP connector. In this article: Connector Actions Action Name AudienceStream EventStream Add User to Audience Segment ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Advertiser ID Required: Your Basis Technologies Advertiser ID. Audience Segment Optional: To create a new audience segment in Basis Technologies DSP, click New Audience Segment. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Add User to Audience Segment Parameters Parameter Description Audience Segment to Add User To Required. Select your audience segment or click New Audience Segment to create a new audience segment in Basis Technologies DSP. Basis Technologies Cookie ID Required. Basis Technologies Cookie ID. ... View more

This article describes how to set up the trbo connector.  Use trbo’s onsite personalization platform to address customers individually and personally in real time!  In this article: Connector Actions Action Name AudienceStream EventStream Send Visitor Profile ✓ ✗ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Shop ID The Shop ID of your trbo shop, which appears in the trbo interface. Client ID The Client ID of your trbo connection. App Secret The Secret key of your trbo connection. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Visitor Profile Parameters No parameters or options required. This connector sends the entire visitor JSON object. For more information, read the AudienceStore Data Guide. ... View more

This article describes how to set up the Selligent Marketing Cloud connector. In this article: Connector Actions Action Name AudienceStream EventStream Upsert To List ✓ ✓ Delete From List ✓ ✓ Add to Segment ✓ ✓ Delete from Segment ✓ ✓ Trigger Custom Journey ✓ ✓ Trigger Transactional Message ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Server URL Selligent Marketing Cloud (SMC) server address. For example, https://example.sIgnt.eu. Organization Your organization. Must match the organization in the upper right corner of the SMC Admin Configuration screen. API Key Generated form SMC Admin Configuration > Apps. API Secret Generated form SMC Admin Configuration > Apps. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Upsert To List Parameters Parameter Description List Select a Selligent Marketing Cloud list. Data Map values for each required field. Action — Delete From List Parameters Parameter Description List Select a Selligent Marketing Cloud list. Data Map values for each required field. Action — Add to Segment Parameters Parameter Description List Select a Selligent Marketing Cloud list. Segment Select a segment. Provides only Static segments. Data Map values for each required field. Action — Delete from Segment Parameters Parameter Description List Select a Selligent Marketing Cloud list. Segment Select a segment. Provides only Static segments. Data Map values for each required field. Action — Trigger Custom Journey Parameters Parameter Description Journey Select a Selligent Marketing Cloud custom journey. Journey Entry Point Select a journey entry point. User ID The ID of the user for whom the campaign is triggered. Action — Trigger Transactional Message Parameters Parameter Description Transactional Journey Select a Selligent Marketing Cloud transactional journey. Recipient (Required) The recipient to whom the content should be sent. Language (Required) The language in which the email should be sent. ... View more

This article describes how to set up the Epsilon Event API connector. Epsilon is the leader in outcome-based marketing with a rich 50-year heritage in helping marketers anticipate, activate, and prove measurable business outcomes. Use the Epsilon Event API to pass information to Epsilon regarding what customers view and purchase on your website. In this article: Connector Actions Action Name AudienceStream EventStream Send Browsing Event ✗ ✓ Send Transaction Event ✗ ✓ Send Action Conversion Event ✗ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Company ID Company ID to identify your calls. Secondary Company ID Separate identifier to confirm company ID. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Browsing Event Parameters Parameter Description Form ID (Required) Promo ID (Required) URL (Required) IP Address (Required) User ID (Required) Brand   Canonical URL   Category   Customer ID   Department   Email (apply SHA256 hash)   Email (already SHA256 hashed)   GDPR consent   Manufacturer Model Part Number   Manufacturer UPC   Product ID   Referring URL   Subcategory   User Agent   Action — Send Transaction Event Parameters Parameter Description Form ID (Required) Promo ID (Required) URL (Required) IP Address (Required) User ID (Required) Brand   Canonical URL   Category   Customer ID   Department   Email (apply SHA256 hash)   Email (already SHA256 hashed)   GDPR consent   Manufacturer Model Part Number   Manufacturer UPC   Product ID   Referring URL   Subcategory   User Agent   Transaction ID (Required) Order Subtotal (Required) Conversion Type   Currency Code   Store Location   Item IDs (Required) Item Prices (Required) Item Quantities (Required) Item Discounts (Required) Action — Send Action Conversion Event Parameters Parameter Description Form ID (Required) Promo ID (Required) URL (Required) IP Address (Required) User ID (Required) Brand   Canonical URL   Category   Customer ID   Department   Email (apply SHA256 hash)   Email (already SHA256 hashed)   GDPR consent   Manufacturer Model Part Number   Manufacturer UPC   Product ID   Referring URL   Subcategory   User Agent   ... View more

This article describes how to set up the Amazon Advertising DSP connector. In this article: Connector Actions Action Name AudienceStream EventStream Add Hashed Record ✓ ✗ Add to Audience ✓ ✗ Remove from Audience ✓ ✗ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. When you add this connector you are prompted to accept the vendor's data platform policy. After adding the connector, configure the following settings: Api Base URLs Select your Api Base URL. Amazon Advertiser ID Enter your Amazon Advertising account ID. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Add Hashed Record Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 5000 Max time since oldest request: 10 minutes Max size of requests: 5 MB Parameters Parameter Description External ID The external identifier for this record. This can be any ID unique to the record in the caller's own identity space. This identifier will be matched to hashed records in Amazon Ads and can then be used to add users to audiences. Email Address (already SHA256 hashed) Email address. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value  which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  Email Address (apply SHA256 hash) Email address. Must be SHA256 Hashed. Use Apply SHA256 Hash option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash.  First Name (already SHA256 hashed) First Name. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  First Name (apply SHA256 hash) First Name. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. Last Name (already SHA256 hashed) Last Name. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  Last Name (apply SHA256 hash) Last Name. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. Street Address (already SHA256 hashed) Street Address. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  Street Address (apply SHA256 hash) Street Address. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. Phone Number (already SHA256 hashed) Phone Number. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  Phone Number (apply SHA256 hash) Phone Number. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. City (already SHA256 hashed) City. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  City (apply SHA256 hash) City. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. Postal Code (already SHA256 hashed) Postal Code. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  Postal Code (apply SHA256 hash) Postal Code. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. State (already SHA256 hashed) State. Must be SHA256 Hashed.  If already hashed, use Already SHA256 Hashed option. Provide a value which has been whitespace trimmed, lowercased and hashed using SHA256 hash.  State (apply SHA256 hash) State. Must be SHA256 Hashed. Use  Apply SHA256 Hash  option with plain text value, the connector will whitespace trim, lowercase and hash this value using SHA256 hash. Action — Add to Audience Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 2000 Max time since oldest request: 10 minutes Max size of requests: 1 MB Parameters Parameter Description Audience ID Click “Create Audience” to create a new Amazon Ads audience. To use an existing Tealium-created Amazon audience, enter its ID and click “Verify Audience ID” to verify that the audience is correct. External ID An External ID previously sent to Amazon via hashed matching. MAID Mobile advertising identifier. Amazon Cookie Cookie obtained via a cookie sync. Action — Remove from Audience Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 2000 Max time since oldest request: 10 minutes Max size of requests: 1 MB Parameters Parameter Description Audience ID To use an existing Tealium-created Amazon audience, enter its ID and click “Verify Audience ID” to verify that the audience is correct. You can copy the audience ID created in the "Add to Audience" action configuration. External ID An External ID previously sent to Amazon via hashed matching. MAID Mobile advertising identifier. Amazon Cookie Cookie obtained via a cookie sync. ... View more

This article describes how to set up the MediaMath connector. In this article: API Information This connector uses the following vendor API: API Name: MediaMath Ingest API API Version: v1 API Endpoint:   https://ingest-default.prod.octane.mediamath.com Connector Actions ACTION NAME AUDIENCESTREAM EVENTSTREAM Send Custom Data ✓ ✗ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the   About Connectors   article. After selecting your audience and trigger, click Continue and then Add Connector. Enter a name for the connector and configure the following settings: MediaMath Advertiser ID Required: Your MediaMath Advertiser ID. Click   Done   when you are finished configuring the connector. Action Settings — Parameters and Options Click   Continue   to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. You can map Tealium attributes to MediaMath custom attributes to pass data as key/value pairs. Custom attributes need to be created and whitelisted in MediaMath prior to sending. Action — Send Custom Data Parameters PARAMETER DESCRIPTION Mapping ID (Required)  Mapping ID supplied by MediaMath. MediaMath User ID (Required) The MediaMath identifier of the visitor. Implement the MediaMath Cookie Matching tag in   Tealium iQ Tag Management to have the MediaMath Unique User ID (UUID) of the visitor sent to Tealium EventStream API Hub as   mediamathid . ... View more

This article describes how to use the Airship data source to create a webhook in your Airship account and send actionable events to Tealium EventStream. In this article: Prerequisites Tealium EventStream and/or Tealium AudienceStream Airship account How It Works To connect Airship with Tealium EventStream or Tealium AudienceStream, use the Airship Webhook API   to send outgoing requests to the custom Airship data source endpoint in your Tealium account. After you configure the webhook, you can create subscriptions based on topics and receive related push notifications to automate use cases, stay informed, and increase productivity. Airship Data Source Adding the Airship data source to your Tealium Customer Data Hub profile generates a unique URL to use in your webhook configuration in following format: https : //collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY To add the Airship data source to your Tealium Customer Data Hub profile, see   Data Sources. After adding and connecting the data source, save and publish your profile.  Airship Setup After you connect Airship to your Tealium Customer Data Hub profile, configure the webhook using the following steps:  Log in to your Airship account and navigate to Settings > Project Configuration and click Manage to configure your Real-Time Data Streaming integrations. Under Real-Time Data Streaming, click Tealium. Previously configured integrations are listed under Enabled Integrations. Enter a name and description. Enter the custom endpoint URL created by adding the Airship data source to your Tealium profile. For example,  https : //collect-us-east-1.tealiumiq.com/integration/event/{account}/{profile}/{data_source_key} Select whether to send anonymous visitors to Tealium. Select the event types to send to Tealium. Click Save. Events and Attributes All incoming Airship event attributes are prefixed with   airship_ . For example, for the   id attribute, Airship will send the matching EventStream event attribute   airship_id   (all lowercase). The Airship webhook API sends flattened JSON  objects to Tealium as shown in the following example of an Airship Email Subscription event:   { "airship_id": "62f3b7ac-4048-4f22-a0b5-22c01ef172a9", "airship_offset": "1000022265027", "airship_occurred": "2021-10-01T16:52:07.131Z", "airship_processed": "2019-04-01T13:00:23.456Z", "airship_device_channel": "6b46c724-494b-4491-9fe7-1b903d266110", "airship_device_device_type": "EMAIL", "airship_device_named_user_id": "Tealium", "airship_device_delivery_address": "test1@tealium.com", "airship_body_event_type": "registration", "airship_body_identifiers_address": "new.subscription@emaildomain.com", "airship_body_properties_commercial_opted_in": "2019-01-04T20:56:00.000Z", "airship_body_properties_transactional_opted_in": "2019-01-04T20:56:00.000Z", "airship_type": "SUBSCRIPTION", "tealium_timestamp_epoch": 1634740696399, "tealium_event": "airship_subscription" }   For a full list of webhook events and attributes generated by Airship, see the   Airship Events Documentation. Vendor Documentation Airship Real-Time Data Streaming Documentation Airship Events Documentation ... View more

This article describes how to set up the Google Analytics 4 Measurement Protocol connector. In this article: Validation The Google Analytics 4 Measurement Protocol supplies the following endpoint for validating events: https://google-analytics.com/debug/mp/collect? . The Tealium Google Analytics 4 Measurement Protocol connector uses this endpoint during Trace, giving you insights into the validation of the event data. You can view Google Analytics 4 Measurement Protocol validation messages in the HTTP Response Content of the API call within Trace. The Google Analytics 4 Measurement Protocol always returns a 2xx status code if the HTTP request was received. The Protocol does not return an error code if the payload data was not formed correctly, the data in the payload was incorrect, or the payload data was not processed by Google Analytics. Limitations Google lists the following limitations when using the Google Analytics 4 Measurement Protocol: If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. Session data is not supported. Requests, events, user property names and values, parameter names and values, and the post body all have limitations in the Google Analytics 4 Measurement Protocol. For a list of limitations, see the Limitations section in the Google documentation. Connector Actions Action Name AudienceStream EventStream Send PageView Event (gtag.js) ✓ ✓ Send Event (gtag.js) ✓ ✓ Send Firebase Event ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: API Secret Required: An API Secret generated in the Google Analytics UI. To create a new secret, navigate to Admin > Data Streams > Choose a Platform in the Google Analytics UI. Set up your Data Stream and select Measurement Protocol API secrets from the Additional Settings section of the Web stream details window. Measurement ID The measurement ID associated with a stream located in the Google Analytics UI. After setting up your Data Stream, navigate to Admin > Data Streams and select your stream. Your measurement ID is available in the Web stream details window. Firebase App ID The identifier for a Firebase app. To find the Firebase app ID navigate to Project Settings > General > Your apps > App ID in the Firebase console. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send PageView Event (gtag.js) Parameters Parameter Description Client ID (Required) A unique identifier for a client. API Secret Override Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. Measurement ID Override The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. User ID If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. Timestamp Micros A Unix timestamp (in microseconds) for the time to associate with the event. Non Personalized Ads Set to true to indicate these events should not be used for personalized ads. Page Title   Page Location (Required) The full URL to the page. User Properties User properties describe segments of user base, such as language preference or geographic location. Could be configured into the section "Templates". Item ID Either Item ID or Item Name is required. Item Name Either Item ID or Item Name is required. Affiliation   Coupon   Currency   Discount (number)   Index (number)   Item Brand   Item Category   Item Category 2   Item Category 3   Item Category 4   Item Category 5   Item List ID   Item List Name   Item Variant   Location ID   Price (number)   Quantity (number)   Template Variables Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). Action — Send Event (gtag.js) Parameters Parameter Description Client ID (Required) API Secret Override Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. Measurement ID Override The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. User ID If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. Timestamp Micros A Unix timestamp (in microseconds) for the time to associate with the event. Non Personalized Ads Set to true to indicate these events should not be used for personalized ads. Event Type Select Event Type. For more information and a list of available events, see Events. Achievement ID   Affiliation   Character   Content Type   Coupon   Creative Name   Creative Slot   Currency   Custom Event Type   Group ID   Item ID   Item List ID   Item List Name   Item Name   Level (number)   Location ID   Method   Payment Type   Promotion ID   Promotion Name   Score (number)   Search Term   Shipping (number)   Shipping Tier   Tax (number)   Transaction ID   Value (number)   Virtual Currency Name   User Properties User properties describe segments of user base, such as language preference or geographic location. Could be configured into the section "Templates". Item ID Either Item ID or Item Name is required. Item Name Either Item ID or Item Name is required. Affiliation   Coupon   Currency    Discount (number)   Index (number)   Item Brand   Item Category   Item Category 2   Item Category 3   Item Category 4   Item Category 5   Item List ID   Item List Name   Item Variant   Location ID   Price (number)   Quantity (number)   Template Variables Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). Action — Send Firebase Event Parameters Parameter Description Client ID (Required) API Secret Override Measurement Protocol API Secret for the Data Stream. This setting overrides API Secret used in the configuration section. Measurement ID Override The identifier for a Data Stream. This setting overrides Measurement ID used in the configuration section. User ID If you include user_id in your Google Analytics 4 Measurement Protocol events you must also include it in the client-side events. Timestamp Micros A Unix timestamp (in microseconds) for the time to associate with the event. Non Personalized Ads Set to true to indicate these events should not be used for personalized ads. Event Type Select Event Type. For more information and a list of available events, see Events. Achievement ID   Affiliation   Character   Content Type   Coupon   Creative Name   Creative Slot   Currency   Custom Event Type   Group ID   Item ID   Item List ID   Item List Name   Item Name   Level (number)   Location ID   Method   Payment Type   Promotion ID   Promotion Name   Score (number)   Search Term   Shipping (number)   Shipping Tier   Tax (number)   Transaction ID   Value (number)   Virtual Currency Name   User Properties User properties describe segments of user base, such as language preference or geographic location. Could be configured into the section "Templates". Item ID Either Item ID or Item Name is required. Item Name Either Item ID or Item Name is required. Affiliation   Coupon   Currency    Discount (number)   Index (number)   Item Brand   Item Category   Item Category 2   Item Category 3   Item Category 4   Item Category 5   Item List ID   Item List Name   Item Variant   Location ID   Price (number)   Quantity (number)   Template Variables Provide template variables as data input for templates (see: Template Variables Guide). Name nested template variables with the dot notation (For example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in User Properties (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). ... View more

This article describes how to set up the AWS Kinesis Streams (Tealium-Provided Credentials) connector. In this article: Connector Actions Action Name AudienceStream EventStream Send Event Data to Kinesis Stream ✗ ✓ Send Visitor Data to Kinesis Stream ✓ ✗ Send Customized Data to Kinesis Stream (Advanced) ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: Region Required: select region Assume Role: ARN Optional: provide Amazon Resource Name (ARN) of role to assume Example: arn:aws:iam::222222222222:role/myrole See: Switching to an IAM Role Assume Role: Session Name Required: provide identifier for assumed role session. Length Constraints: Minimum length of 2. Maximum length of 64. Assume Role: External ID Optional: provide external identifier See: How to Use an External ID Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Event Data to Kinesis Stream Parameters Parameter Description Stream Name Select stream to send data to If your IAM policy does not grant 'kinesis:ListStreams' permission, you will need to manually enter a Custom Value Partition Key (Required) Sequence Number For Ordering   Explicit Hash Key   Print Attribute Names If attribute names get updated, the names in the payload will reflect the update. Action — Send Visitor Data to Kinesis Stream Parameters Parameter Description Stream Name Select stream to send data to If your IAM policy does not grant 'kinesis:ListStreams' permission, you will need to manually enter a Custom Value Partition Key (Required) Sequence Number For Ordering   Explicit Hash Key   Include Current Visit Data   Print Attribute Names If attribute names get updated, the names in the payload will reflect the update. Action — Send Customized Data to Kinesis Stream (Advanced) Parameters Parameter Description Stream Name Select stream to send data to If your IAM policy does not grant 'kinesis:ListStreams' permission, you will need to manually enter a Custom Value Partition Key (Required) Sequence Number For Ordering   Explicit Hash Key   Custom Message Definition   Template Variables Optional Provide template variables as data input for templates (see: Template Variables Guide) Name nested template variables with the dot notation (Example: items.name) Nested template variables are typically built from data layer list attributes Templates Optional Provide templates to be referenced in message data (see: Templates Guide) Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}) ... View more

This article describes how to set up the ROKT Events connector. In this article: API Information This connector uses the following vendor API: API Name: ROKT API API Version: 2020-05-21 API Endpoint: https://api.rokt.com Documentation: ROKT Event API Batch Limits This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three thresholds is met: Max number of requests: 100 Max time since oldest request: 10 minutes Max size of requests: 1 MB Connector Actions Action Name AudienceStream EventStream Send Conversion ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors. After adding the connector, configure the following settings: Client ID Required: provide your App ID. See: Generating App ID and Secret. Client Secret Required: provide your App Secret. Account ID Required: your ROKT Account ID. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Conversion Parameters Parameter Description Event Type (Required) Type of event. Event ID An identifier used to uniquely identify an event. Event Time Time of the event in UTC. Email Email passed as plain text, lowercase and without trailing spaces. Email - emailsha256 (already SHA256 hashed) SHA-256 hash of email address, already hashed. Email - emailsha256 (apply SHA256 hash) SHA-256 hash of email address. Tealium will hash. Rokt Tracking ID A Rokt-generated ID used to match conversion events to the originating click. Conversion Amount Transaction amount Currency Code Currency code Quantity The quantity (integer) of item within the specific conversion. Conversion Type Used to differentiate between different conversion events. Product Names The name of the product(s) purchased. Product SKUs The identifier of the product purchased (Note: Only accepts one SKU) Payment Type The payment method used during the transaction Credit Сard BIN Credit card BIN of converting payment Margin Profit margin of conversion Transaction ID Transaction ID, used to identify a unique transaction. Confirmation Reference ID Confirmation reference ID. Customer First Name Customer's first name Customer First Name (already SHA256 hashed) SHA-256 hash of first name, already hashed. Customer First Name (apply SHA256 hash) SHA-256 hash of first name. Tealium to hash. Customer Last Name Customer's last name Customer Last Name (already SHA256 hashed) SHA-256 hash of last name, already hashed. Customer Last Name (apply SHA256 hash) SHA-256 hash of last name. Tealium to hash. Mobile Phone Number Mobile phone number of converting customer. Mobile Phone Number (already SHA256 hashed) SHA-256 hash of phone number, already hashed. Mobile Phone Number (apply SHA256 hash) SHA-256 hash of phone number. Tealium to hash. Customer IP Address Customer's IP address Customer IP Address (already SHA256 hashed) SHA-256 hash of customer's IP address, already hashed. Customer IP Address (apply SHA256 hash) SHA-256 hash of customer's IP address. Tealium to hash. User Agent Browser user agent of converting customer Device Type Type of device Device Operating System Device operating system OS Version Operating system version Browser Browser Browser Version Browser version Customer Title Title of the customer Customer Gender Gender of the customer Customer Date of Birth In the format  yyyymmdd Customer Age Age of the customer Language Language associated with the purchase Unit Number Unit number associated with address Address 1 First line of street address Address 2 Second line of street address Customer Postal Code Customer postal code Customer City Customer city Customer State Customer state Customer Country Customer country Meta Data Non-business critical information about the event. ... View more

This article describes how to set up the TikTok Events connector. In this article: API Information This connector uses the following vendor API: API Name: TikTok HTTP API API Version: v1.2 API Endpoint: https://business-api.tiktok.com/open_api/v1.2 Documentation: TikTok Events API Batch Limits This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 50 Max time since oldest request: 5 minutes Max size of requests: 1 MB Connector Actions Action Name AudienceStream EventStream Send Web Event ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. Read the About Connectors article for general instructions on how to add a connector. After selecting your source, click Continue and then Add Connector. Enter a name for the connector and configure the following settings: App ID Required if Access Token is not provided. Mobile App ID. Examples: In the Apple App Store, the App ID is A1B2C3D4E5.com.domainname.applicationname . In the Google Play store, if the URL for the app is https://play.google.com/store/apps/details?id=<package_name> , <package_name> is your App ID. If you are using an Android app not in the Google Play store, use the package name. Access Token Required if App ID and Secret are not provided. An authorized Access Token configured in TikTok. For more information, see TikTok Events API. If Access Token is provided there is no need to Establish Connection to initiate the oAuth flow. Secret Required if Access Token is not provided. The private key of the developer app. Pixel ID If you already have a TikTok Pixel integrated on the website, you can use the existing Pixel code. You can find the pixel_code by logging in your TikTok Ads Manager Account. TikTok recommends using one pixel per website. TikTok App ID A unique code that is generated in the TikTok Ads Manager. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following sections describe how to set up parameters and options for each action. Action — Send Web Event Parameters Parameter Description Event Type (Required). Conversion event name. Custom Event Name (Required). App event name. Pixel ID Override (Required). Pixel ID that can be found in the TikTok Events Manager. This setting overrides Pixel ID used in the Configuration section. Event ID Any hashed ID that can identify a unique user or session. Example: SessionID_RandomNumber . If you set Generate Event ID in the TikTok Pixel tag to True, this ID will be automatically generated for every TikTok tracking event. IP IP address of the browser. It should be the public IP and not hashed. To increase the probability of matching website visitor events with TikTok ads, we recommend sending both IP and User Agent. User Agent Non-hashed user agent from the user's device. To increase the probability of matching website visitor events with TikTok ads, we recommend sending both IP and User Agent. Test Event Code To test event tracking, use this field to specify a test code. If the event is received in TikTok, this test code will display in the Test Events tab of the Pixel in TikTok Ads Manager. Timestamp Timestamp that the event took place. Timestamp with ISO 8601 format 'YYYY-MM-DDThh:mm:ssZ. If no timestamp is provided, the current timestamp will be used. Callback The value of ttclid used to match website visitor events with TikTok ads. Referrer Page referrer. URL Page URL when event happened. User External ID (apply SHA256 hash) (Recommended). The external user ID. It must be hashed with SHA256. Use Apply SHA256 Hash option prior to sending. If already hashed, use Already SHA256 Hashed option. User External ID (already SHA256 hashed) (Recommended). The external user ID. It must be hashed with SHA256. Use Apply SHA256 Hash option prior to sending. If already hashed, use Already SHA256 Hashed option. User Phone Number (apply SHA256 hash) (Recommended). User's phone number. It must be hashed with SHA256. Include country code with '+' and remove any other characters (spaces, '-') between numbers (Example for US: +12133734253). If the country code is 86, do not include country code (Example: 13800000000). Use Apply SHA256 Hash if unhashed. If already hashed, use Already SHA256 Hashed option. User Phone Number (already SHA256 hashed) (Recommended). User's phone number. It must be hashed with SHA256. Include country code with '+' and remove any other characters (spaces, '-') between numbers (Example for US: +12133734253). If the country code is 86, do not include country code (Example: 13800000000). Use Apply SHA256 Hash if unhashed. If already hashed, use Already SHA256 Hashed option. User Email (apply SHA256 hash) (Recommended). Email address. Must be 256 Hashed. Use Apply SHA256 Hash option prior to sending. If already hashed, use Already SHA256 Hashed option. User Email (already SHA256 hashed) (Recommended). Email address. Must be 256 Hashed. Use Apply SHA256 Hash option prior to sending. If already hashed, use Already SHA256 Hashed option. Content Price Price of the item. Supports number data type. Content Type A description of the product item (Example: being purchased). Content Quantity Number of items. Supports number data type. Content ID Product ID in your system. Description A description of the app event. Currency 3 Digit ISO-4217 code. Examples: “EUR”, “USD”, “JPY”. Value Total value of the order or items sold. Query The text used in a search query. ... View more

This article describes how to set up the Iterable connector. In this article: Connector Actions Action Name AudienceStream EventStream Track Event (Batched) ✗ ✓ Upsert User (Batched) ✓ ✓ Forget a User in Compliance with GDPR ✓ ✓ Send SMS Notification to User ✓ ✓ Send an Email to an Email Address ✓ ✓ Trigger Workflow ✓ ✓ Subscribe a User (AS Only) ✓ ✗ Unsubscribe a User (AS Only) ✓ ✗ Subscribe User to List ✓ ✗ Unsubscribe User from List ✓ ✗ Update User Email ✓ ✓ Update Shopping Cart ✓ ✓ Track Purchase ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector. After adding the connector, configure the following settings: API Key You can find your API Key by navigating to Integrations > API Keys in Iterable Connector menu. Click  Done  when you are finished configuring the connector. Action Settings — Parameters and Options Click  Continue  to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Track Event (Batched) Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 1000 Max time since oldest request: 10 minutes Max size of requests: 4 MB Parameters Parameter Description Event Name (Required).  Name of event. Created At Time event happened. Set to the time event was received if unspecified. Expects a Unix timestamp. If this field is not mapped, it will be initialized with the current timestamp. Email Either Email or User ID must be entered to identify the user. If both are entered, Email takes precedence. Event ID If an event exists with the entered ID, the event will be updated. If no Event ID is specified, a new ID will automatically be generated and returned. Note that this ID cannot be longer than 512 bytes. User ID User ID that was passed into the updateUser call. Campaign Campaign tied to conversion. See Introduction to Campaigns for more information about campaigns. Project Template Template ID. See Introduction to Templates for more information about templates. Data Fields Additional data associated with the event (Example: item amount or item quantity). For events of the same name, identically named data fields must be of the same type. Template Variables Provide template variables as data input (See Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Upsert User (Batched) Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 1000 Max time since oldest request: 10 minutes Max size of requests: 4 MB Parameters Parameter Description Email An email must be set unless a profile already exists with a user ID set. If a profile already exists, a lookup from the User ID to Email is performed. Merge Nested Objects Merge top level objects instead of overwriting (Default: False). For example, if user profile has data: {mySettings:{mobile:true}} and change contact field has data: {mySettings:{email:true}} , the resulting profile: {mySettings:{mobile:true,email:true}} . Prefer User ID Create a new user with the specified User ID if the user does not exist yet. User ID Typically your database generated ID. Either Email or User ID must be specified. Data Fields Data fields to store in the user profile. Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (See: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}  ). Action — Forget a User in Compliance with GDPR Parameters Parameter Description Email Provide user email if you want to delete the specified user's data from the Iterable project and prevent future data collection about them. Action — Send SMS Notification to User Parameters Parameter Description Campaign Campaign ID. See Introduction to Campaigns for more information about campaigns. Allow Repeat Marketing Sends Defaults to True. Recipient Email Either Email or User ID must be entered to identify the user. If both are entered, Email takes precedence. Recipient User ID User ID that was passed into the updateUser call. Send At Schedule the message for up to 365 days in the future. If set in the past, the message is sent immediately. Expected format is 'YYYY-MM-DD HH:MM:SS '. Ensure data is properly formatted. If attribute of the   Date   type is provided, the connector will convert the value to the appropriate date format, shown above. Data Fields Fields to merge into template. Template Variables Provide template variables as data input (See: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Send an Email to an Email Address Parameters Parameter Description Campaign Campaign ID. See Introduction to Campaigns for more information about campaigns. Allow Repeat Marketing Sends Defaults to True. Recipient Email Either Email or User ID must be entered to identify the user. If both are entered, Email takes precedence. Recipient User ID User ID that was passed into the updateUser call. Send At Schedule the message for up to 365 days in the future. If set in the past, the message is sent immediately. Expected format is 'YYYY-MM-DD HH:MM:SS '. Ensure data is properly formatted. If attribute of the   Date   type is provided, the connector will convert the value to the appropriate date format, shown above. Data Fields Fields to merge into email template. Metadata Metadata to pass back via webhooks. Not used for rendering. Template Variables Provide template variables as data input (See: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Trigger Workflow Parameters Parameter Description Workflow ID ID of workflow to trigger. See Introduction to Workflows for more information about workflows. List Trigger the workflow for all users in a list. Email Trigger workflow for given email address. Trigger only with Email or List. Data Fields Additional data associated triggering event. Template Variables Provide template variables as data input (See: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (See: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Subscribe a User (AS Only) Parameters Parameter Description Subscription Group Select Subscription Group. Subscription Group ID Provide the ID of the message channel, message type or email list to which you are subscribing the user. Email Provide the email address of the user for which you'd like to create a subscription. User ID Provide user ID of the user for which you'd like to create a subscription. Either Email or User ID must be specified. Action — Unsubscribe a User (AS Only) Parameters Parameter Description Subscription Group Select Subscription Group. Subscription Group ID Provide the ID of the message channel, message type or email list from which you are unsubscribing the user. Email Provide the email address of the user from which you are unsubscribing the user. User ID Provide user ID of the user from which you are unsubscribing the user. Either Email or User ID must be specified. Action — Subscribe User to List Parameters Parameter Description List Select list to subscribe user to. Email An email must be set unless a profile already exists with a user ID set. In which case, a lookup from User ID to Email is performed. Merge Nested Objects Merge top level objects instead of overwriting (Default: False). For example, if user profile has data: {mySettings:{mobile:true}} and change contact field has data: {mySettings:{email:true}} , the resulting profile: {mySettings:{mobile:true,email:true}} . Prefer User ID Create a new user with the specified user ID if the user does not exist yet. User ID Typically your database generated ID. Either Email or User ID must be specified. Data Fields Data fields to store in the user profile. Template Variables Provide template variables as data input (See: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (See: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Unsubscribe User from List Parameters Parameter Description List Select list to unsubscribe user from. Email User email. User ID Typically your database generated ID. Either Email or User ID must be specified. Campaign Attribute unsubscribe to a campaign. See Introduction to Campaigns for more information about campaigns. Channel Unsubscribe Unsubscribe email from list's associated channel. Action — Update User Email Parameters Parameter Description New Email New user email. (Required) Current Email Current user email. Current User ID Typically your database generated ID. Either Email or User ID must be specified. Action — Update Shopping Cart Parameters Parameter Description Email User email. Merge Nested Objects Merge top level objects instead of overwriting (Default: False). For example, if user profile has data:  {mySettings:{mobile:true}}  and change contact field has data:  {mySettings:{email:true}} , the resulting profile:  {mySettings:{mobile:true,email:true}} . Prefer User ID Create a new user with the specified User ID if the user does not exist yet. User ID Typically your database generated ID. Either   Email   or   User ID   must be specified. User Data Fields Data fields to store in the user profile. User Data Fields Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name). Nested template variables are typically built from data layer list attributes. User Data Fields Templates Provide templates to be referenced in User Data Fields (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). Item ID Product item ID. SKU Product SKU. Name Product name. Description Product description. Category Product category. Subcategory Product subcategory. Price Product price. Quantity Product quantity. Image URL URL for product image. URL URL for product page. Items Data Fields Additional item properties. Provide Array type attributes to add multiple items. Array type attributes must be of equal length. Items Data Fields arrays and Items Attributes arrays must be of equal length. Single value attributes can be used and will apply to each item. Items Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name). Nested template variables are typically built from data layer list attributes. Items Template If you need nested objects support, use this section to define a template. The template expects a JSON array format. When template is defined, then configuration from the Items Attributes section will be ignored. Either Items Template or Items Attributes must be specified. More information about templates (see: Templates Guide). Action — Track Purchase Parameters Parameter Description Total (Required) Purchase ID ID of purchase transaction. Created At Time event happened. Set to the time event was received if unspecified. Expects a Unix timestamp. If this field is not mapped, it will be initialized with the current timestamp. Email Either   Email   or   User ID   must be entered to identify the user. If both are entered,   Email   takes precedence. Merge Nested Objects Merge top level objects instead of overwriting (Default: False). For example, if user profile has data:  {mySettings:{mobile:true}}  and change contact field has data:  {mySettings:{email:true}} , the resulting profile:  {mySettings:{mobile:true,email:true}} . Prefer User ID Create a new user with the specified User ID if the user does not exist yet. User ID Typically your database generated ID. Either   Email   or   User ID   must be specified. Campaign Campaign ID. See Introduction to Campaigns for more information about campaigns. Project Template Template ID. See Introduction to Templates for more information about templates. Data Fields Additional fields to be tracked. User Data Fields Data fields to store in the user profile. Data Fields Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name). Nested template variables are typically built from data layer list attributes. Data Fields Templates Provide templates to be referenced in Data Fields and User Data Fields (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}}). Item ID Product item ID. SKU Product SKU. Name Product name. Description Product description. Category Product category. Subcategory Product subcategory. Price Product price. Quantity Quantity of product purchased. Image URL URL for product image. URL URL for product page. Items Data Fields Additional item properties. Provide Array type attributes to add multiple items. Array type attributes must be of equal length. Items Data Fields arrays and Items Attributes arrays must be of equal length. Single value attributes can be used and will apply to each item. Items Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name). Nested template variables are typically built from data layer list attributes. Items Template If you need nested objects support, use this section to define a template. The template expects a JSON array format. When template is defined, then configuration from the Items Attributes section will be ignored. Either Items Template or Items Attributes must be specified. More information about templates (see: Templates Guide). ... View more

This article describes how to set up the Airship connector. In this article: Connector Actions Action Name AudienceStream EventStream Create Custom Event ✓ ✓ Add Tags ✓ ✓ Remove Tags ✓ ✓ Set Attributes ✓ ✓ Remove Attributes ✓ ✓ Configure Settings Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector. After adding the connector, configure the following settings: Region Required: Select the region associated with your Airship project. Access Token Required: Access Token is used to make API calls. App Key App Key is used to make API calls for the action "Create Custom Event". Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. Action - Create Custom Event Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met: Max number of requests: 100 Max time since oldest request: 5 minutes Max size of requests: 1 MB Parameters Parameter Description Named User Id (Required)  The named user associated with the event. Event Name (Required)  The name for the event. Interaction Id The identifier defining where the event occurred. In a traditional website, which would be the path and query string from the URL. In a single page app that uses hash routing, it would be the path, query string, and fragment identifier. Interaction Type Describes the type of interaction that triggered the event. For example: ‘url’, ‘social’, ‘email’. This should almost always be ‘url’ for web events. Airship can separate events with the same name by interaction_type, providing greater insight into custom events. Occurred The timestamp the event happened for the user in ISO 8601 UTC format 'YYYY-MM-DDThh:mm:ss'. If no Timestamp is provided, the current timestamp will be used. Session Id The user session during which the event occurred. Transaction If the event is one in a series representing a single transaction, use the transaction field to tie events together. Value The Value field respects six digits of precision to the right of the decimal point. Properties Map properties as key-value pairs for top-level attributes. Map and use a template for more complex data structures. Template Variables Optional: provide template variables for Properties object data. For more information, see: Template Variables Guide. Name nested template variables with the dot notation (Example: items.name). Nested template variables are typically built from data layer list attributes. Templates Optional: provide template for properties object. (see: Templates Guide) Map template name, wrapped in double curly braces, to Properties in Event Data mapping above (Example: {{SomeTemplateName}}) Action - Add Tags Parameters Parameter Description Named User Id The named user to associate tags with. Tags The list of tags to add to the named user. If the tags are already present, they are not modified. Map an array of tag values when adding multiple tags to the same tag group. Action - Remove Tags Parameters Parameter Description Named User Id The named user to disassociate tags with. Tags The list of tags to remove from the named user. If the tags are not currently present, nothing happens. Map an array of tag values when removing multiple tags from the same tag group. Action - Set Attributes Parameters Parameter Description Named User Id The named user to set attributes on. Title Map to Airship predefined or custom attributes. Custom attributes must be added in the Airship UI before they can be mapped. First Name Last Name Full Name Gender Zipcode City Region Country Birthdate Age Mobile Phone Home Phone Work Phone Loyalty Tier Company Username Account Creation Email Address Altitude Latitude Longitude Advertising ID (IDFA) Action - Remove Attributes Parameters Parameter Description Named User Id The named user to remove attributes from. Attributes The list of attributes to remove from the named user. ... View more

This article describes how to set up the Amplitude connector. In this article: API Information This connector uses the following vendor API: API Name: Amplitude HTTP API API Version: v2 API Endpoint: https://api2.amplitude.com/2/httpapi Documentation: Amplitude HTTP API Connector Actions Action Name AudienceStream EventStream Send Event ✓ ✓ Send Event (Non-Batched) ✓ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article. After adding the connector, configure the following settings: API Key Located under Settings -> Projects. Server Endpoint Please provide the Amplitude endpoint. Supported endpoints: Standard Server: https://api2.amplitude.com/2/httpapi EU Residency Server: https://api.eu.amplitude.com/2/httpapi If not provided Standard Server endpoint will be used by default. Click Done when you are finished configuring the connector. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Event Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following thresholds is met: Max number of requests: 2000 Max time since oldest request: 10 minutes Max size of requests: 1 MB Parameters Parameter Description Event Type (Required) API Key Override   Server Endpoint Override   Android ID   App Version   Carrier   City   Country   Designated Market Area   Device Brand   Device ID   Device IP Address   Device Manufacturer   Device Model   Event ID   Google Play Services Advertising ID   iOS Identifier for Advertiser   iOS Identifier for Vendor   Insert ID   Language   Location Latitude   Location Longitude   OS Name   OS Version   Platform   Price   Product ID   Quantity   Region   Revenue   Revenue Type   Session ID   Time   User ID   Event Properties A dictionary of key-value pairs that represent additional data to be sent along with the event. Empty values are skipped and not included. User Properties A dictionary of key-value pairs that represent additional data tied to the user. Each distinct value will show up as a user segment on the Amplitude dashboard. Empty values are skipped and not included. Groups Enterprise only. A dictionary of key-value pairs that represent groups of users. See this excerpt in our Javascript SDK for more information on groups. Empty values are skipped and not included. Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ). Action — Send Event (Non-Batched) Parameters Parameter Description Event Type (Required) API Key Override   Server Endpoint Override   Android ID   App Version   Carrier   City   Country   Designated Market Area   Device Brand   Device ID   Device IP Address   Device Manufacturer   Device Model   Event ID   Google Play Services Advertising ID   iOS Identifier for Advertiser   iOS Identifier for Vendor   Insert ID   Language   Location Latitude   Location Longitude   OS Name   OS Version   Platform   Price   Product ID   Quantity   Region   Revenue   Revenue Type   Session ID   Time   User ID   Event Properties A dictionary of key-value pairs that represent additional data to be sent along with the event. Empty values are skipped and not included. User Properties A dictionary of key-value pairs that represent additional data tied to the user. Each distinct value will show up as a user segment on the Amplitude dashboard. Empty values are skipped and not included. Groups Enterprise only. A dictionary of key-value pairs that represent groups of users. See this excerpt in our Javascript SDK for more information on groups. Empty values are skipped and not included. Template Variables Provide template variables as data input (see: Template Variables Guide). Name nested template variables with the dot notation (Example: items.name ). Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data (see: Templates Guide). Templates are injected by name with double curly braces into supported fields (Example: {{SomeTemplateName}} ;). ... View more

This article describes how to set up the Kochava connector. In this article: Connector Actions Action Name AudienceStream EventStream Send Install Event ✗ ✓ Send Post-Install Event ✗ ✓ Configure Settings Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors. Action Settings — Parameters and Options Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu. The following section describes how to set up parameters and options for each action. Action — Send Install Event Parameters Parameter Description Kochava App ID This is the unique application ID used to represent the App. Reference the following API documentation for more info App Version A string representation of the application version number. IP Address The IP address of the device on install. Device Version A string representation of the device make, model and OS. The syntax is as follows: 'device'-'os_name'-'os_version' where each value is separated by a hyphen. Reference the following API documentation for more info Device User Agent A string representation of the device user agent as provided by the client. Please ensure that this is URL-encoded. This string is useful when campaigns require fingerprint attribution. IDFA You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. IDFV You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. IMEI You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. ADID You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. Android ID You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. iAd Org Name   iAd Conversion Date   iAd LineItem Name   iAd Campaign ID   iAd Attribution   iAd AdGroup Name   iAd Click Date   iAd Campaign Name   iAd LineItem ID   iAd Keyword   iAd AdGroup ID   Action — Send Post-Install Event Parameters Parameter Description Kochava App ID This is the unique application ID used to represent the App. Reference the following API documentation for more info App Version A string representation of the application version number. IP Address The IP address of the device on install. Event Name Name of the event to track. Event Data Data points related to the event tracked. Device Version A string representation of the device make, model and OS. The syntax is as follows: 'device'-'os_name'-'os_version' where each value is separated by a hyphen. Reference the following API documentation for more info Device User Agent A string representation of the device user agent as provided by the client. Please ensure that this is URL-encoded. This string is useful when campaigns require fingerprint attribution. IDFA You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. IDFV You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. IMEI You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. ADID You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. Android ID You must include one or more of the following device IDs in the appropriate fields: IDFA, IMEI, Android ID, MAC address or a custom variant. ... View more

This article describes how to set up the Criteo connector. In this article: Connector Actions Action Name AudienceStream EventStream Send Event ✓ ✓ Configure Settings Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector. After adding the connector, configure the following settings: Client Account ID Required: This is the Client ID in Criteo. Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. Action - Send Event Parameters Parameter Description Event Type The standard web, travel, or store event to send. For more information, see Criteo Server to Server - Event Payloads. Account The partner ID of the account you are sending the data to. It can be filled on the connector configuration screen or on the action screen. The value on the action screen has higher priority than on the connector configuration screen. Email Raw The user's raw email address. Will use the first non-empty value of email. Email MD5 (apply MD5 hash) The user's unhashed email address. Email MD5 (already MD5 hashed) The user's email address hashed with MD5. Email SHA256 (apply SHA256 hash) The user's unhashed email address. Email SHA256 (already SHA256 hashed) The user's email address hashed with SHA256. Email SHA256 MD5 (apply SHA256 MD5 hash) The user's unhashed email address. Email SHA256 MD5 (already SHA256 MD5 hashed) The user's email address hashed with MD5 and SHA256. GAID Google's advertising identifier. IDFA Apple's identifier for Advertisers unique identifier. IP IP address Mapped User Id (Required) T he Criteo salted user ID (GUM ID) returned by the GUM call. See:  Criteo Server to Server - Criteo GUM Call . Mapping Key The unique Criteo S2S key for the partner. Site Type The device type (or site version) used for browsing. Default option is "desktop". Available values are  d  (for Desktop),  t  (for Tablet),  m  (for Mobile). Useragent The user-agent of the browser or device. ... View more

This article describes how to set up the Adjust Events API connector. In this article: Connector Actions Action Name AudienceStream EventStream Send Event ✗ ✓ Configure Settings Go to the Connector Marketplace and add a new connector. See the Connector Overview for general instructions on how to add a connector. After adding the connector, configure the following settings: Authentication Token With Adjust's S2S Security feature, you can guarantee the security of your S2S events and protect against spoofed requests. After you set up S2S authentication, each incoming request must carry a token generated in your Adjust dashboard. See Server-to-server (S2S) Security for more details. Leave the field empty if you haven't set up S2S authentication. Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. Action - Send Event Parameters Parameter Description Event Token Adjust event token from the dashboard. App Token Adjust app token from the dashboard. Android ID Android ID See Accepted device identifiers. Open Advertising ID Platform-dependent Open Advertising ID. See Accepted device identifiers. Raw Amazon Fire Advertising ID Platform-dependent Raw Amazon Fire Advertising ID. See Accepted device identifiers. Raw IDFA iOS only. Raw IDFA Identifier. See Accepted device identifiers. Raw IDFV Raw IDFV Identifier. See Accepted device identifiers. Raw Google Advertising ID Raw Google Advertising ID Identifier. See Accepted device identifiers. Adjust Device ID Identifying LAT users on iOS without idfa information. Created At Timestamp (Formatted) Telling the exact moment an event occurred. The connector encodes the value. Example: 2017-01-02T15:04:05.000+0000 becomes 2017-01-02T15%3A04%3A05.000%2B0000 Created At Timestamp (Unix) Telling the exact moment an event occurred. Can be specified using either seconds or milliseconds. IP Address Event linking to third-parties, such as Google and including location-related information, such as city and postal_code ) in your callbacks. The ip_address parameter only accepts IPv4. IPv6 is not yet supported. Currency Revenue event See currency code. Environment Environment to post the data t. Example: environment=sandbox or environment=production If this parameter is not included, the event will be pushed to the production environment. Revenue Revenue event value in full currency units (149.99 = $149.99). Adjust accepts a minimum value of 0.001 for this parameter. Template Variables Provide template variables as data input. See Template Variables Guide. Name nested template variables with the dot notation. Example: items.name Nested template variables are typically built from data layer list attributes. Templates Provide templates to be referenced in Body Data. See Templates Guide. Templates are injected by name with double curly braces into supported fields. Example: {{SomeTemplateName}} ... View more

This article describes how to set up the SendGrid connector. In this article: Connector Actions Action Name AudienceStream EventStream Upsert Contact ✓ ✗ Remove Contact ✓ ✗ Send Email ✓ ✗ Configure Settings Go to the Connector Marketplace and add a new connector. See the Connector Overview for general instructions on how to add a connector. After adding the connector, configure the following settings: API Key API Key for SendGrid Connector to use. This connector requires Marketing Campaigns 'Full Access', Mail Send 'Full Access', and Template Engine 'Read Access' for the API Key. For more information on SendGrid API Keys please view the following documentation: SendGrid API Keys. Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. Action - Upsert Contact Parameters Parameter Description Address Line 1   Address Line 2   Alternate Emails   City   Country   Email (Required) First Name   Last Name   Postal Code   State Province Region   Contact List Ids Optional: List Ids. An array of List ID strings that this contact will be added to. Action - Remove Contact Parameters Parameter Description Contact Id   Email   Action - Send Email Parameters Parameter Description Name (Required) Send At   Send To All   Custom Unsubscribe Url   Editor   Generate Plain Content   HTML Content   Ip Pool   Plain Content   Subject   Categories Optional: Categories. The categories to associate with this Single Send. Max items 10. Contact List Ids Optional: Contact List Ids. The recipient List IDs that will receive the Single Send. Max items 10. Segments Optional: Segments. The recipient Segment IDs that will receive the Single Send. Max items 10. Design Id Optional: Design Id. A Design Id can be used in place of Html Content, Plain Content, and/or subject. Sender Id Optional: Sender Id. The ID of the verified Sender. Suppression Group Id Optional: Suppression Group Id. The ID of the Suppression Group to allow recipients to unsubscribe — you must provide this or the Custom Unsubscribe Url. ... View more