Pardot Knowledge Base

Integrating Twitter Lead Generation Cards

Last Updated: Apr 26, 2016 | Print this Article
Twitter's Lead Generation Cards allow Twitter users to subscribe to your offers or join your mailing lists right from within Twitter. We expect conversion rates to be very high as prospects will not need to fill out a form to convert. All of that data (Twitter handle, name, and email address) is transmitted to Pardot behind the scenes. Twitter Lead Generation Cards'

Prep work: create a field to hold Twitter handles

  1. Create a Custom Field called "Twitter Handle." The field ID (the name Pardot uses in its database) should be twitter_handle.

Prep work: create a form handler to which Twitter can post the data

  1. Create a new Form Handler.
  2. Enter your home page (choose specific URL) for the success location.
  3. Enter your home page (choose specific URL) for the error location.
  4. Set the form handler to "kiosk" mode (this setting is necessary because of the way Twitter sends us the data).
  5. Enter any appropriate completion actions (notify users, change scores, and so on).
  6. Map the external field name "email" to the Pardot email address field. Note: Field names are case-sensitive.
  7. Map the external field name "twitter_handle" to the custom Twitter Handle field that you created in the step above. Note: Field names are case-sensitive.
  8. Once you've saved the form handler, find the https URL (look at the post URL and click the https toggle.) You will use this in the following step.

Twitter Card Technical settings: URL mapping

  1. Add necessary details, including your Privacy Policy URL
  2. For Card Details (Fallback) URL, use a landing page related to your promotion. This is used when people access the lead generation card from a non-supported platform (like TweetDeck).
  3. Add your Form Handler Endpoint URL (https) to the 'Submit URL' field
  4. Set the HTTP method to 'POST'.
Twitter card URL mapping

Twitter Card Technical settings: field mapping

Note: Field names are case-sensitive.
  1. Map the email field to custom key name "email".
  2. Map "Screen name" to the custom key name "twitter_handle".
  3. Add any hidden fields you would like to pass in as well such as "source", which you could prefill with "twitter," as in the below example.
Twitter Card: Field Mapping

Need more? Start a conversation with other Pardot users in our Success Community