What is Snap Pixel?
The Snap Pixel tracks website events to optimize, attribute, and retarget Snapchat ads.
Review Snap's documentation to learn how to install your Pixel ID.
What does TurboVote track?
TurboVote's Snap Pixel integration tracks events across the user journey. Events fire whether you are embedding TurboVote on your website or linking to your destination site (e.g., example.turbovote.org).
TurboVote sends the following events to your Pixel:
| Action | Snap event | Parameters sent |
|---|---|---|
| Views a page | PAGE_VIEW (automatic) |
None |
| Completes a signup | SIGN_UP |
sign_up_method |
| Searches for their location | SEARCH |
search_method, search_string |
| Engages with Where to Vote info | VIEW_CONTENT |
item_category, item_ids |
| Starts a multi-step workflow | CUSTOM_EVENT_1 |
description, tv_workflow |
| Completes a multi-step workflow | CUSTOM_EVENT_2 |
description, tv_workflow |
Signups
TurboVote emits a SIGN_UP event when a user signs up. The event carries a sign_up_method parameter identifying which experience the user signed up through:
| Signup | sign_up_method |
|---|---|
| Register to Vote | registration-assistance |
| Check Your Registration | check-registration |
| Preregister to Vote | preregistration |
| Sample Ballot Signup | reminders-ballot |
| Request Absentee Ballot | ballot-request |
| Get Election Reminders | election-reminders |
Workflows
Some TurboVote experiences are workflows that a user moves through, distinct from a signup. To help you measure engagement with these experiences separately from signups, TurboVote emits two custom events:
CUSTOM_EVENT_1when a voter begins a workflowCUSTOM_EVENT_2when a voter finishes one
Both events carry a description parameter (TurboVoteWorkflowStarted or TurboVoteWorkflowCompleted) and a tv_workflow parameter identifying the workflow. Current tv_workflow values are:
tv_workflow |
Workflow | Events emitted |
|---|---|---|
ballot-request |
Request Absentee Ballot | CUSTOM_EVENT_1 and CUSTOM_EVENT_2 |
registration-assistance |
Register to Vote | CUSTOM_EVENT_1 and CUSTOM_EVENT_2 |
check-registration |
Check Your Registration | CUSTOM_EVENT_2 |
election-reminders |
Get Election Reminders | CUSTOM_EVENT_2 |
preregistration |
Preregister to Vote | CUSTOM_EVENT_2 |
reminders-ballot |
Sample Ballot Signup | CUSTOM_EVENT_2 |
Request Absentee Ballot and Register to Vote are multi-step workflows, so they emit both a start (CUSTOM_EVENT_1) event and a completion (CUSTOM_EVENT_2) event. The others complete in a single step and emit only the completion (CUSTOM_EVENT_2) event. As more experiences become multi-step, they will begin emitting a start event as well.
Search
When a visitor searches for their location through Election Search, Sample Ballot Search, or Where to Vote Search, TurboVote emits a SEARCH event with this parameter:
| Parameter | Description | Values |
|---|---|---|
search_method |
How the visitor entered their location | autocomplete_address (chose a suggested address), manual_address (typed a full address), campus_address (chose a campus address), or state (chose a state only) |
Where to Vote engagement
When a visitor interacts with the Where to Vote information (for example, expanding the early voting, vote-by-mail, or election-day sections, viewing drop-off locations, or getting directions), TurboVote emits a VIEW_CONTENT event with these parameters:
| Parameter | Description | Values |
|---|---|---|
item_category |
The kind of content viewed | Always where-to-vote-action |
item_ids |
The specific action the visitor took | A single-item list containing one of the values below |
The possible item_ids values, grouped by the section the visitor engaged with:
Early voting:
expanded-where-to-vote-early-sectionexpanded-where-to-vote-early-section-hoursexpanded-where-to-vote-early-section-hours-detailsviewed-where-to-vote-early-locationsviewed-directions-where-to-vote-early-location
Vote by mail:
expanded-where-to-vote-by-mail-sectionexpanded-where-to-vote-by-mail-section-hoursexpanded-where-to-vote-by-mail-section-hours-detailsviewed-where-to-vote-by-mail-drop-off-locationsviewed-directions-where-to-vote-drop-off-location
Election day:
expanded-where-to-vote-on-election-day-sectionexpanded-where-to-vote-on-election-day-section-hoursexpanded-where-to-vote-on-election-day-section-hours-detailsviewed-where-to-vote-on-election-day-locationsviewed-directions-where-to-vote-on-election-day-location
Voter ID:
expanded-where-to-vote-voter-id
Ballot troubleshooting links:
visited-election-office-site-troubleshoot-received-ballotvisited-election-office-site-check-received-ballot-addressvisited-election-office-site-check-received-ballot-change-addressviewed-usps-lookup
How can I add my Snap Pixel ID to my TurboVote site?
Share your Pixel ID with your TurboVote support manager to include it on your TurboVote site.
How can I confirm my Snap Pixel ID is connected to my TurboVote site?
If you're using Chrome, you can use the Snap Pixel Helper to check whether your Pixel is firing correctly on your page. Snap's Pixel Helper will show whether your Pixel is installed and enable you to pass test events.