This article describes how to set up the Snapchat Conversions connector.

In this article:

About

This product is behind a beta allowlist. To gain access, contact your Snapchat sales representative. If you do not have a sales representative, use the following form and Snapchat personnel will contact you: Conversions API Allowlist Request.

  • We highly recommend passing data in real time.
  • Conversions API requests are tied to unique identifiers that link server events back to your Snapchat ad account. We use your Pixel ID for web and offline events and your Snapchat App ID for app events.
  • To unlock campaign optimization, we recommend that you send events as soon as they occur, ideally within an hour of the event occurring.

Prerequisites

  • After adding the connector, you must invite "asintegrations@tealium.com" to your Snapchat Business manager with the "Member" role and assign to applicable Ad Account with the "Data Manager" role.

    This step may take up to three (3) working days for approval. You can confirm whether the invitation has been accepted by viewing the users in your Snapchat Ads account.

    For additional information, see: Manage Members and Roles.

API Information

This connector uses the following vendor 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 (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

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:

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 Conversion

Parameters

Parameter Description
Event Type
  • Select event type from drop-down list.
Event Conversion Type
  • Select event conversion type from drop-down list.
Pixel ID
  • The Pixel ID associated with your Ad Account.
App ID
  • The unique ID assigned for a given application.
  • Numeric for iOS.
  • Google Advertising ID (GAID) for Android.
Snap App ID
  • The Snap App ID associated with your app (a unique code generated in Ads Manager and included in your MMP dashboard).
Event Tag
  • Custom event set label.
  • Example: in-store, weekend sales, back-to-school campaign
  • May be used for future tagging and audience targeting.
Timestamp
  • The Epoch timestamp for the conversion happening.
  • If this field is not mapped, it will be initialized with the current timestamp.
Description
  • A string description for additional information.
Number Items
  • Number of items (integer, singular value).
  • If this field is mapped to array, it will be converted to the sum of array elements.
Currency
  • Standard ISO 4217 code.
  • Example: EUR, USD, JPY.
Transaction ID
  • Transaction ID or order ID tied to the conversion event.
Level
  • Represents a level in the context of a game.
Client Dedup ID
  • ID that is used to identify this single request.
  • Used to differentiate this request from other requests in the same batch.

    This is an advanced feature; first ensure that you are confident with your approach if using this as a deduplication key.

Data Use
  • For iOS 14.5 and above users, indicate if we should treat the event as opt-in or opt-out.
  • For OPT_OUT user events, value is a list with only the value of lmu.
Search String
  • The text that was searched for.
Page Url
  • The URL of the web page where the event took place.
  • Must include protocol.
Sign Up Method
  • A string indicating the sign up method, such as Facebook, Email, or Twitter.
Item Category
  • Category of item(s).
Item ID
  • International Article Number (EAN), when applicable, or other product or category identifier.
  • Map array and list values to keys to be passed to Snapchat.
  • All arrays and lists should be of equal length.
  • Single value attribute will be converted to array containing single value.
Price
  • Price of the item.
Email Address (apply SHA256 hashed)
  • Provide a plain text email address and the connector will hash this value in the format Snapchat expects.
Email Address (already SHA256 hash)
  • Provide an email address that has been SHA256 hashed.
Mobile Ad ID (already SHA256 hashed)
  • Provide a mobile ad ID.
  • Example: iOS IDFA or GAID, that has been SHA256 hashed.
Mobile Ad ID (apply SHA256 hash)
  • Provide a plain text mobile ad ID.
  • Example: iOS IDFA or GAID and the connector will hash this value in the format Snapchat expects.
Phone Number (already SHA256 hashed)
  • Provide a phone number that has been SHA256 hashed.
Phone Number (apply SHA256 hash)
  • Provide a plain text phone number and the connector will hash this value in the format Snapchat expects.
IP Address (already SHA256 hashed)
  • Provide a IP address that has been SHA256 hashed.
IP Address (apply SHA256 hash)
  • Provide a plain text IP address and the connector will hash this value in the format Snapchat expects.
  • Use the Client IP attribute (recommended).
Vendor Identifier (already SHA256 hashed)
  • Provide a vendor identifier that has been SHA256 hashed.
Vendor Identifier (apply SHA256 hash)
  • Provide a plain text vendor identifier and the connector will hash this value in the format Snapchat expects.
User Agent
  • Use the User Agent attribute.
  • If this field is not mapped in EventStream, it will be auto-mapped to the attribute User Agent.
  • If this field is not mapped in AudienceStream, it will be auto-mapped to the visitor's last User Agent.
Public