This document will outline how to add a Buyer Contract and explain Delivery Method.
The Posting Document your Buyer has provided you will be implemented in the Delivery Method Tab in the Buyer Contract.
CAKE Basic supports several posting methods including Email Delivery, POST, GET and XML. CAKE Basic also supports custom headers, if necessary.
Email Delivery: CAKE Basic supports 1 or multiple email addresses for the purpose of delivering leads. Custom lead email templates can be made in Setup > Email Templates. To add an address to receive lead emails, simply click the Add button and enter the one you want to use. Click Update when finished and you'll see the address added. Repeat this process for as many addresses as is necessary.
Post Method: The Post Method is the most common form of posting leads to a Buyer. You will know when to use the Post Method because the Posting Document you receive from the Buyer will specify to use this method. If the Buyer allows multiple methods, CAKE Basic would suggest using the Post Method.
Post URL: The Post URL is the URL that your Buyer has provided to you as the destination for the leads. The Post URL will be placed in the Post URL field.
Username and Password: The Buyer may require specific credentials to be used to access their server. This is NOT where you hard code a field such as Affiliate ID or a specific password that would be used as identification.
Once the Post URL and credentials (if applicable) have been placed, click “Save”.
The Post Fields section is where you will input the fields specified on the Posting Document your Buyer has provided to you. Each field will map to a CAKE Basic Vertical Field.
To add a field, click “Add”.
Query: This check box will only be used if the Buyer has specified they need to be posted leads using the GET Method.
Parameter: The Buyer-specific field name found on the Posting Document will be placed in the Parameter. For example, the Buyer may receive a user’s address as “address”.
Field: This drop down will contain all Basic Fields and Vertical-specific fields. Choose the corresponding field from the Vertical that matches your Buyer’s field.
Condition Formula: Please consult with your trainer for more advanced methods.
Once the field has been added, click “Update”.
The Buyer may ask that a field should be hard coded, or static.
You can accomplish this in CAKE Basic by typing the field name found on your Buyer’s Posting Document followed by an “=” followed by the value.
For example, your Buyer may require an Affiliate ID to be submitted with each lead.
Every Post will contain affiliate_id=777. Nothing will be specified in the Field drop down.
Static fields for your Buyer do NOT have to be collecting on the incoming post from your Affiliate.
You can have multiple static fields.
Situations arise where the Buyer expects the data to be sent differently than how it was received in CAKE Basic.
CAKE Basic can handle this by using a Vertical Field that is using a List Data Type.
Lists allow data to be received as one value and to be submitted to the Buyer as a completely different value.
The Field Name will turn into a hyperlink if the Data Type is “List”.
Clicking the name of the field will open a Mapped Values Card.
In our example above, CAKE Basic receives the lead as either “Female” or “Male” but the Buyer receives the data as either “1” or “2”.
Responses: Responses allow CAKE Basic to interpret the various messages the Buyer will send back to CAKE Basic once a lead is submitted.
Text: The Text field allows you to type in a string of characters that can be expected from the Buyer after a lead is submitted. Responses usually include a “Success” message, an “Error” or possibly a “Duplicate” message.
Interpret As: This is a drop down that contains values that can be mapped to the Text field. This includes “Success”, “General Failure”, “Duplicate” and others.
*** A LEAD WILL NEVER SELL TO A BUYER UNLESS CAKE IS INTERPRETING A RESPONSE AS “SUCCESS” ***
Response Tokens: The Buyer has the ability of passing back specific values in the response if the lead was successfully sold. CAKE Basic can use Regular Expression (regex) to determine the exact value being passed in the response. These values include
- Price
- Redirect URL
- Lead ID
Price Token: The Price Token allows a Buyer Contract to receive a dynamic price as opposed to a predetermined price.
Redirect URL Token: The Redirect URL Token allows a Buyer to send a specific URL of where they would like to redirect the user. This is used in very specific situations when using the Host-n-Post Offer.
Lead ID Token: The Lead ID Token allows the Buyer to pass back a Lead ID from their system. This is similar to the Transaction ID on a 3rd Party Offer.
*** The syntax used in the image below are just examples. Every Buyer is different in their response ***
Note: Responses must be mapped and a success received in order for tokens to be captured.
Get Method: The Get Method is very similar to the Post Method. You will use the Get Method when the Buyer specifies this method on the Posting Document. Technically, the lead will be sent in the query string of the Post URL and therefore CAKE Basic will automatically add a “?” to the end of the Post URL.
Post URL: The process for placing the Post URL is the same as the Post Method. It does not matter if there is a “?” at the end of the Post URL as CAKE Basic will handle the URL appropriately.
Field data will be added to the Post Field section just like we did for the Post Method.
Query: The Query check box will need to be checked for the Get Method to function. You can verify that the check box has been checked when the dot turns from red to green.
The rest of the process is identical to the Post Method.
XML Post Method: The XML Post Method is yet another method of posting lead data to your Buyer. Again, the Buyer will specify this method on the Posting Document.
Post URL: The XML Post Method also requires a Post URL. The process is the same as the Post and Get Methods.
XML Post: Unlike the Post and Get Methods, the Buyer-specific fields will be mapped in XML format. (XML is a variation of HTML)
The Posting Document usually outlines an example of the exact XML Post the Buyer is expecting. This example should be pasted into the XML Post field.
Often times the example will include sample data such as the image below.
Fields can be hard coded, or made static. The static value needs to be placed between the XML fields such as <first_name>JOHN</first_name>. Every lead will contain JOHN as the first name.
Similar to the Post and Get Methods, XML Fields will need to be mapped to a CAKE Basic Vertical Field.
This task is accomplished through the use of Lead Tokens.
Lead Tokens: Lead Tokens accomplish the same thing as selecting the Vertical field from the drop down on a Post or Get. The Tokens will be placed between the XML Fields.
Example: <address>#address#</address>
CAKE Basic can handle the mapping of List values as exemplified on the Post Method when using the XML Post Method.
Using the example of “Gender”, place the Gender lead token between the gender XML fields.
In the Post Fields Tab, type the name of the XML Field in the Parameter (excluding the brackets). Map this field to the correct Vertical field in the Field drop down. Click the name of the field and map the fields to the value your Buyer is expecting.
The Responses will need to be mapped in the same way we did on the Post and Get Methods.
Similarly, the Response Tokens are mapped the same way.
* CAKE Basic can also accommodate a JSON post.