Step 2: Map inputs

The simple view is on by default. If you need to switch from advanced to a simple view, click Off for Advanced Code View. The simple view is rarely used because advanced view provides much more features for complex mapping.

To switch to an advanced view, click On for Advanced Code View. This view allows selecting the following format types according to buyer specification (click the format to open the corresponding document):

• XML;
• HTTP (as default);
• JSON;
• SOAP.

Click the appropriate format type to select it.

Map Your Ping API Fields & Inputs block consists of two parts:

• Template Editor with HTTP formatting as default, where all information from the buyer specification is entered;
• Mapping Panel on the right, which contains PX options that should be mapped to options from the buyer’s specification.

When any field is mapped, it is marked with a green tick:

To start mapping, you need the following:

• PX specification for a particular vertical (the list of all vertical specifications is available here).
• Buyer specification, containing a list of mandatory fields and their options, which should be mapped to appropriate PX fields.

The general flow of mapping fields between buyer and PX sides is the following:

1. Map the names of the fields.
2. Lead the fields mapped to a common format.
3. Select Encoding Type for a particular field if it is required by a Buyer’s spec (None, URL or XML).
4. Map the options of the fields.
5. Enter a Test Value for the field mapped.
6. Hardcode test values.

The mapping procedure varies according to the format type selected (HTTP, XML, JSON, SOAP). Let’s take a closer look at each of them, using the following as examples:

1. PX specification for Auto Insurance Vertical;
2. Simplified Buyer Specification Example.

To undo the field mapping, delete the corresponding line from the Template Editor, and all mappings created for this field will be deleted as well.

There is a very convenient way to use the same fields and inputs that were mapped on the ping stage. To copy all the fields and inputs mapped from the ping to the post template editor, click Copy Ping Fields.

As soon as everything is copied, perform the following:

1. Delete irrelevant field mappings (if there are any, according to the иuyer specification).

2. Add and map the fields that are required in post request by the buyer specification. There are the following parameters that should be added to the post request:

• Contact data (first and last names, physical address, email address and phone numbers);
• Ping ID;
• Response ID (if necessary);
• Payout (if necessary).

Click Save to save all the settings or click Save and continue to save and proceed to the next step of API configuration.