Snapchat
Platform Summary
Snapchat conversion and matching contracts.
Scope
Primary execution surface: hybrid.
Developer Source Map
| Source | Reason |
|---|---|
| Snap Conversions API Parameters | Event Contracts; Transport / Payload Rules; User Data Contracts |
| Snap Conversions API Using The API | Event Contracts; Transport / Payload Rules |
| Snap Pixel API | Transport / Payload Rules; events, user data, payload |
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|---|---|
snapchat_conversion | Discovery lead | source |
snapchat_custom_audience | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
conversion_event | action_source | server | string | Required | Required source of event. Use one of WEB, OFFLINE, MOBILE_APP. | Not clearly specified | Do not hash | - | Documented in Conversions API Parameters > Server Parameters. | Snap Conversions API Parameters | Verified | High |
conversion_event | event_name | server | string | Required | Required event type for web and app events. Allowed values include PURCHASE, SAVE, START_CHECKOUT, ADD_CART, VIEW_CONTENT, ADD_BILLING, SIGN_UP, SEARCH, PAGE_VIEW, SUBSCRIBE, AD_CLICK, AD_VIEW, COMPLETE_TUTORIAL, LEVEL_COMPLETE, INVITE, LOGIN, SHARE, RESERVE, ACHIEVEMENT_UNLOCKED, ADD_TO_WISHLIST, SPENT_CREDITS, RATE, START_TRIAL, LIST_VIEW, APP_INSTALL, APP_OPEN, CUSTOM_EVENT_1, CUSTOM_EVENT_2, CUSTOM_EVENT_3, CUSTOM_EVENT_4, CUSTOM_EVENT_5. | Not clearly specified | Do not hash | Purchase | Documented in Conversions API Parameters > Server Parameters. | Snap Conversions API Parameters | Verified | High |
conversion_event | event_time | server | integer | Required | Required epoch timestamp. Seconds or milliseconds accepted. event_time cannot be more than 7 days in the past. | Not clearly specified | Do not hash | - | Documented in Conversions API Parameters > Server Parameters. | Snap Conversions API Parameters | Verified | High |
deduplication | event_id | server | string | Recommended | Recommended unique identifier for deduplication across Pixel and CAPI. If using Snap Pixel, event_id must match client_dedup_id for matching event. | Not clearly specified | Do not hash | evt-12345 | Using The API: send event_id on all integrations; deduplication uses event_id and timestamp within 48-hour window. | Snap Conversions API Using The API | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
user_data | client_ip_address | server | string | Optional | IP address of the device (not server). Supports IPv4 and IPv6 for web and app. | Not clearly specified | Do not hash | - | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
user_data | em | server | string or list[string] | Conditional | Trim extra characters (for example spaces) and lowercase before hashing. | lowercase; trim whitespace | SHA-256 required | <sha256(alice@example.com)> | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
user_data | external_id | server | string | Optional | Unique first-party identifier (for example loyalty id or first-party cookie id). | Not clearly specified | SHA-256 recommended | - | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
user_data | fn | server | string or list[string] | Conditional | Use lowercase letters only. Remove punctuation. Encode special characters with UTF-8 before hashing. | lowercase | SHA-256 required | <sha256(alice)> | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
user_data | ln | server | string or list[string] | Conditional | Use lowercase letters only. Remove punctuation. Encode special characters with UTF-8 before hashing. | lowercase | SHA-256 required | <sha256(smith)> | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
user_data | ph | server | string or list[string] | Conditional | Include country code. Remove double 00 prefix before country code. If number begins with 0 remove it. Exclude non-numeric characters including whitespace, parentheses, + and -. | include country code | SHA-256 required | 16505551234 | User Data Parameters. | Snap Conversions API Parameters | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
conversion_event | event_source_url | server | string | Conditional | Required when website events are sent via Conversions API. Must include protocol (http or https). | Not clearly specified | Do not hash | - | Also used for automatic ScCid click_id extraction in CAPI. | Snap Conversions API Parameters | Verified | High |
request_body | data[] | server | array[object] | Required | Send all events in JSON body. Main body contains data array; each event can include user_data, custom_data, and app_data. | Not clearly specified | Not applicable | - | Using The API > Structure of JSON Body. | Snap Conversions API Using The API | Verified | High |
snap_pixel | pixel_id | hybrid | string | Required | Snap Pixel uses pixel entity id for web event collection and CAPI web endpoint path. | Not clearly specified | Do not hash | - | Snap Pixel API entity reference. | Snap Pixel API | Verified | High |
web_endpoint | POST /v3/{PIXEL_ID}/events | hybrid | string | Required | Web endpoint for sending CAPI events using Pixel ID and access token. | Not clearly specified | Not applicable | - | Using The API > The Basics. | Snap Conversions API Using The API | Verified | High |
Candidate / Needs Review Items
No candidate rows currently tracked.
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-30