Accessing interaction data

To see how people are using your buttons, start from the My Buttons menu. Here, you can scroll through your buttons and view metrics that can help you understand how your widgets are resonating with your audience and identify areas for improvement:

Widget Views: The number of times a widget has been viewed by a user. This metric is helpful for understanding how many people are seeing your widgets.
Widget Completions: The number of times a widget has been completed by a user. This metric is helpful for understanding how many people are taking action on your widgets.
Widget Conversion Rate: The percentage of people who viewed a widget and then completed it. This metric is helpful for understanding how effective your widgets are at converting viewers into action-takers.

Click on any of your buttons to see additional metrics on your buttons: how people answered your poll, which lawmakers have been messaged, who's signed your petition, and more.

Tracking metrics for direct advocacy actions

For active "Contact Your Lawmaker" or "Custom Email Target" buttons, you’ll find a table displaying detailed metrics. These metrics include:

The specific recipients of your advocacy efforts (e.g., lawmakers or other key decision-makers)
The total number of messages each recipient has received
Their district and state/province, if applicable

These metrics allow you to track your outreach efforts more precisely, helping you adjust your campaigns based on real-time data.

Exporting button and user data

If you have a paid plan, you can also download this data from the 1) Account Profile menu option. Once there, click the 2) Data tab to download .CSV files with 3):

Aggregate Information: Lists all actions created and shared in your ActionButton account, along with top-line action completion and opt-in numbers
Personally Identifiable Information: Lists contact details for anyone who completed an action that collects contact information (Petition, Custom Email Targets, Contact Your Lawmakers, Check Registration, Signup, and Opinion)

Here are the fields that are included in each .CSV download ...

Aggregate Information

WidgetRequestId: button ID used in share/embed links, e.g. SPK-R0ZDRQ==
WidgetName: The title of your button
ActionId: The numeric identifier for the individual action. If your button includes multiple sequenced actions, each step will have it's own row in the export.
ActionType: Petition, SentimentPoll, Opinion, etc
Completed: Total count of people who completed the action
OptedIn: Total count of people who checked the box to share their personal contact info with you. This will be null if the action type doesn't include this option.

Personally Identifiable Information

ButtonId: button ID used in share/embed links, e.g. SPK-R0ZDRQ==
ButtonName: The title of your button
ActionId: The numeric identifier for the action that collects contact information within your button
ActionType: Signup, CheckRegistration, Opinion, etc.
Prefix: The action-taker's prefix, e.g., Mr., Mrs.
FirstName: The action-taker's first name
MiddleName: The action-taker's middle name
LastName: The action-taker's last name
FullName: FirstName + MiddleName + LastName
Email: The action-taker's email address
PhoneNumber: The action-taker's phone number
DateOfBirth: The action-taker's date of birth
Country: The country the action-taker lives in
State: The state the action-taker lives in
City: The city the action-taker lives in
ZipCode: The action-taker's postal code
Street: The street the action-taker lives on
StreetNo: The address number the action-taker lives at

Integrate ActionButton with NationBuilder

Manage your account settings

Create and manage buttons

Understanding action types

Creating a Contact Your Lawmakers button