Districtor

Getting Started With Districtor

Guides, Tips, and Snippets to help make the most out of Districtor

Updating Fields

You can log back into Districtor at any time to add or remove fields as you need them or as we continue to bring you new insights into your advocates. The reason it doesn’t always make sense to have every single field checked is that Mailchimp has a limit of 50 custom merge fields that can be added to your contacts at a time. That includes anything you added yourself before using Districtor. Do not worry though because you can add and remove them as you need for specific mailings and management is very easy. Once you log in you simply select new fields you would like to add, and uncheck those you can remove. If a check cannot be removed it means it’s required by another field and must stay there. When you are done simply click update and we will get working on updating your data. Remember especially for large lists it can take a little while to get everything all synchronized!

Working With the Data

So you’ve got all this fantastic new actionable information in your contact list, but now it's time to it’s time to put it to use!

NOTE: When you are viewing a contact list in mailchimp you must click the “toggle columns” dropdown and select the Districtor data you’d like to view.

Start by logging into your mailchimp account and selecting the list that you’re syncing with Districtor.

There are two ways of working with this data. The first is 'segmenting' who you are sending to based on your needs such as which state you’d like to send the action alert to or the political party of the politician. The second is including the contacts political data within the email itself so they can take action with a single click!

REMEMBER to always send to the “Districtor Enabled” segment or to a segment with the filter of “D_Dist is not empty” to send to only your districted contacts. This segment stays up to date as people engage and join your list.

Segmenting Your Data

Go to create new segment in mailchimp and build a filter to target just the constituents you are targeting to advocate for you. You can select from any of the districted fields youd like to filter by. For example, if you wanted to target only your subscribers living in a California district you would select field “Federal Voting District” set the modifier to ‘contains’ and the data field to CA. It is important to use ‘contains’ because the voting districts have more information than just the state abbreviations and if you pick is then it wont work.

Once you have made your filters you can save the segment and name it as you’d like. These districts will continue to update as new subscribers are added or the contacts move locations or update their zip codes.

Designing Actionable Emails

One of the most powerful parts of Districtor is that you can include the name, social media, and contact information of a contacts politician right within their email. This is done simply by including the ‘merge tags’ that districtor created when you synced for the first time. These tags can be used within a sentence or as a part of a link to somewhere like a twitter or facebook page. Mailchimp has a great writeup on using general merge tags. The list of districtor merge tags can be found below as well as some custom code snippets to make things like little politicians contact cards or customized tweet links.

Once you have finished designing your email you can enter into preview mode and type in a contact to see how the email will look customized to them. Remember this contact must be one that has been “districted” or it will not work.

Sending to the World

Once you are happy with your email and all the merge tags have been added it is time to send. Remember to always send to either the “districtor enabled” segment if sending to everyone we have information for or to a segment you’ve created that filters using a districtor field.

Link Tracking and Reporting

One nice feature of mailchimp is that it can track the links people click so you can build reports within mailchimp to show how many people took the action of sending an email or tweeting to the politician. To see more about this you can refer to mailchimp's reports documentation.One of the most powerful parts of Districtor is that you can include the name, social media, and contact information of a contacts politician right within their email. This is done simply by including the 'merge tags' that districtor created when you synced for the first time. These tags can be used within a sentence or as a part of a link to somewhere like a twitter or facebook page. Mailchimp has a great writeup on using general merge tags. The list of districtor merge tags can be found below as well as some custom code snippets to make things like little politicians contact cards or customized tweet links.

Updating Incorrect Data

Districtor uses either your existing contacts Zip Code or determines the location based on the history of where they read your emails the most, but what about if people have moved or the data is incorrect? In the rare event this occurs there is a super simple way for your contacts to update their new location simply by using mailchimp existing “Update Profile” link in the email. If a user sees the information is incorrect they can click on the link and be brought to a page where they enter their Zip Code. This zip is then added to the system and Districtor will update the records.

Political Action Widgets

You can use Districtor's merge fields right within the body of your email, but you can also create action widgets showing the contact's local representatives and how to contact them right within your email. Here are some examples to get you started!

Required Fields: Name, Email, Social, and Phone Number for each politician you are adding a widget of.


Senator 1 (Example):

Code (Copy & Paste into a MailChimp code block):

<table border="0" cellpadding="5" cellspacing="0" width="100%" id="callToActionWidget">
    <tr>
        <td align="center" valign="top">
            <img src="https://twitter.com/*|SEN1_TWIT|*/profile_image?size=bigger" width="62px" height="62px" style="border-radius: 50%;">
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <h3 style="margin: 0 auto;font-size: 22px;font-weight: bold;text-align: center;">*|SEN1_NAME|*</h3>
            <p style="margin: 0 auto;font-size: 18px;">senator &middot *|SEN1_PARTY|*</p>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <a href="tel:*|SEN1_PHONE|*" target="_blank" style="color: #FFF;background-color: #3869D4;display: block;width: 80%;margin-bottom: 15px;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Call <span style="margin-left: 5px;font-weight: normal;">*|SEN1_PHONE|*</span></a>
            <a href="https://twitter.com/intent/tweet?status=&#64;*|SEN1_TWIT|*%20" target="_blank" style="color: #3869D4;background-color: #FFF;display: block;width: 80%;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Tweet <span style="margin-left: 5px;font-weight: normal;">&#64;*|SEN1_TWIT|*</span></a>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <p>Email <a href="mailto:*|SEN1_EMAIL|*?Subject=Fight%20for%20the%20net">*|SEN1_EMAIL|*</a>.</p>
        </td>
    </tr>
</table>

Senator 2 (Example):

Code (Copy & Paste into a MailChimp code block):

<table border="0" cellpadding="5" cellspacing="0" width="100%" id="callToActionWidget">
    <tr>
        <td align="center" valign="top">
            <img src="https://twitter.com/*|SEN2_TWIT|*/profile_image?size=bigger" width="62px" height="62px" style="border-radius: 50%;">
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <h3 style="margin: 0 auto;font-size: 22px;font-weight: bold;text-align: center;">*|SEN2_NAME|*</h3>
            <p style="margin: 0 auto;font-size: 18px;">senator &middot *|SEN2_PARTY|*</p>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <a href="tel:*|SEN2_PHONE|*" target="_blank" style="color: #FFF;background-color: #3869D4;display: block;width: 80%;margin-bottom: 15px;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Call <span style="margin-left: 5px;font-weight: normal;">*|SEN2_PHONE|*</span></a>
            <a href="https://twitter.com/intent/tweet?status=&#64;*|SEN2_TWIT|*%20" target="_blank" style="color: #3869D4;background-color: #FFF;display: block;width: 80%;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Tweet <span style="margin-left: 5px;font-weight: normal;">&#64;*|SEN2_TWIT|*</span></a>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <p>Email <a href="mailto:*|SEN2_EMAIL|*?Subject=Fight%20for%20the%20net">*|SEN2_EMAIL|*</a>.</p>
        </td>
    </tr>
</table>

Representative (Example):

Code (Copy & Paste into a MailChimp code block):

<table border="0" cellpadding="5" cellspacing="0" width="100%" id="callToActionWidget">
    <tr>
        <td align="center" valign="top">
            <img src="https://twitter.com/*|REP_TWIT|*/profile_image?size=bigger" width="62px" height="62px" style="border-radius: 50%;">
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <h3 style="margin: 0 auto;font-size: 22px;font-weight: bold;text-align: center;">*|REP_NAME|*</h3>
            <p style="margin: 0 auto;font-size: 18px;">representative &middot *|REP_PARTY|*</p>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <a href="tel:*|REP_PHONE|*" target="_blank" style="color: #FFF;background-color: #3869D4;display: block;width: 80%;margin-bottom: 15px;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Call <span style="margin-left: 5px;font-weight: normal;">*|REP_PHONE|*</span></a>
            <a href="https://twitter.com/intent/tweet?status=&#64;*|REP_TWIT|*%20" target="_blank" style="color: #3869D4;background-color: #FFF;display: block;width: 80%;text-align: center;font-weight: bold;padding: 14px;text-decoration: none;border-radius: 3px;box-shadow: 0 2px 3px rgba(0, 0, 0, 0.16);">Tweet <span style="margin-left: 5px;font-weight: normal;">&#64;*|REP_TWIT|*</span></a>
        </td>
    </tr>
    <tr>
        <td align="center" valign="top">
            <p>Email <a href="mailto:*|REP_EMAIL|*?Subject=Fight%20for%20the%20net">*|REP_EMAIL|*</a>.</p>
        </td>
    </tr>
</table>

Updating/Correcting Location Data

Advocates locations change all the time so give people a way to update their zip code in an instant. This can be done easily by using the *|UPDATE_PROFILE|* tag built into mailchimp. Here is that code used in an easy way to add into your email template.

This isn’t your politician? Update your profile with your new zip code!

<p style="text-align: center;"><a href="*|UPDATE_PROFILE|*" target="_blank" style="color: #43404D;">(Not your reps?)</a></p>

Merge Tag Cheat Sheet

Federal

Districtor Label Merge Tag
Federal Voting District *|D_DIST|*
Senator 1 Name *|D_SEN1_N|*
Senator 2 Name *|D_SEN2_N|*
Senator 1 Party *|D_SEN1_PA|*
Senator 2 Party *|D_SEN2_PA|*
Senator 1 Phone *|D_SEN1_P|*
Senator 2 Phone *|D_SEN2_P|*
Senator 1 Email *|D_SEN1_E|*
Senator 2 Email *|D_SEN2_E|*
Senator 1 Twitter *|D_SEN1_T|*
Senator 2 Twitter *|D_SEN2_T|*
Senator 1 Facebook ID *|D_SEN1_F|*
Senator 2 Facebook ID *|D_SEN2_F|*
House Representative's Name *|D_REP_N|*
House Representative's Party *|D_REP_PA|*
House Representative's Phone *|D_REP_P|*
House Representative's Email *|D_REP_E|*
House Representative's Twitter *|D_REP_T|*
House Representative's Facebook ID *|D_REP_F|*

State/Local

Districtor Label Merge Tag
State Senator's Name *|D_SSEN_N|*
State Senator's Party *|D_SSEN_PA|*
State Senator's Phone *|D_SSEN_P|*
State Senator's Email *|D_SSEN_E|*
State Senator's Twitter *|D_SSEN_T|*
State Senator's Facebook ID *|D_SSEN_F|*
State Representative's Name *|D_SSREP_N|*
State Representative's Party *|D_SSREP_PA|*
State Representative's Phone *|D_SSREP_P|*
State Representative's Email *|D_SSREP_E|*
State Representative's Twitter *|D_SSREP_T|*
State Representative's Facebook ID *|D_SSREP_F|*