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 (see this article for information on creating forms).
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:
Image may be NSFW.
Clik here to view.
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:
Image may be NSFW.
Clik here to view.
Next, click the Integration Details button. You will need to copy three pieces of information, highlighted in the screen shot below:
Image may be NSFW.
Clik here to view.
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:
Image may be NSFW.
Clik here to view.
Click on the Create New Card button in the right-hand corner:
Image may be NSFW.
Clik here to view.
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.
Image may be NSFW.
Clik here to view.
Place the Eloqua HTML field names in the Custom Key Name under User Information to be received:
Image may be NSFW.
Clik here to view.
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:
Image may be NSFW.
Clik here to view.
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.