Twitter Lead Generation Cards

Version 1

    Twitter recently announced an addition to their suite of Twitter Cards called Lead Generation Cards. This is interesting new functionality that allows you easily embed a call to action inside a tweet. When this call to action is clicked, Twitter can fire information (such as Twitter handle and Email address) directly into an Eloqua Form, where you can take that information and process it just like any other Form submission.

     

    For more information, see this blog post from Twitter:

    Twitter Advertising: Capture user interest with the Lead Generation Card

    Setting up the form integration with Eloqua is very simple.

     

    1.  Create Form in Eloqua

     

    In Eloqua, create a Form. Twitter has the ability to send in the following standard fields:
    - Twitter Handle

    - Name

    - Email address

     

    As well, you can create certain custom fields, such as "Campaign ID" or "Lead Source", if those are required for your process. Create the field that you would like to map. Create the appropriate processing step The specified item was not found..

     

    For each field you create, you will need the HTML name. To obtain that name, select the field in the Form. The HTML name is displayed at the bottom of the right-hand pane as shown in the following screenshot.  Write down that value for every Field:

     

    Form 3.png

     

    You will also need a few more pieces of information, which are available in the Form Integration Details area. To access that area, click on the Gear icon, and select View Form HTML:

    Form1.png

    Next, click the Integration Details button. You will need to copy three pieces of information, highlighted in the screen shot below:

    Form2.png

    The fields are:

    Action

    elqFormName
    ElqSiteID

     

     

    2. Create the Lead Gen card in Twitter

    In order to use this functionality, you must have a Twitter advertising account and it must be enabled.  To enable the account, speak to your Twitter account representative.

     

    Beging by navigating to ads.twitter.com and login to your account.

    Click the Advertising button, and select Cards:

    Cards1.png

    Click on the Create New Card button in the right-hand corner:

    card2.png

     

    There are several pieces of information you need to provide:

    Upload Card Image - Maximum image size is 1 MB, and the minimum required width is 600 px.  In addition, a minimum aspect ratio of 4:1 is required.

    Short Description - This is the Tweet of the offer, maximum 80 characters in length.

    Call to Action - What do you want the button to say

     

    Technical Settings:
    Submit URL - Remove the http(s):// from the Action indicated in the previous step, then copy and paste it into the Submit URL screen.
    Fallback URL- Enter your website address.
    Privacy Policy - Place a link to the privacy Policy on your website.

    cards3.png

     

    Place the Eloqua HTML field names in the Custom Key Name under User Information to be received:
    card4.png

    Under Custom Hidden Data Values click Add Another Hidden Field twice.

    Enter elqFormName in the first box, and the appropriate value that was copied earlier in the field to its right.

    Enter elqSiteID in the next box, and the appropriate value that was copied earlier in the field to its right:

    card5.png

     

    Enter a Card name, and then you are ready to use it!

     

     

    EDIT - As a note, this does work in E9 and E10. The documentation above outlines the E10 process.