Configuration: Postal Systems

Emplifi Agent integrates with several third-party utilities that allow for verification and cleaning of address information. They generally include the following features:

If you enter a street number and ZIP code, the system fills in city, state, and ZIP+4, if available.
Cleaning of street names and street types, including standardizing abbreviations for streets, roads, and avenues.

The software that is used for all U.S. addresses is called Mailers+4. Other supported systems include Mailers Canada and QCode (for Canadian addresses), and PostCode (for U.K. addresses).

Single line address lookup

Field	Description
Provider	Select the provider to use for the Single Line Address Lookup feature. Choose from: Melissa Google Loqate
API Key	Click the Edit button to enter or update the API Key. Click the Test button to verify the connection to the provider and return data for specific input element(s).
Result Count	Specify the maximum number of elements that will be displayed in the drop-down selection list.
Enable geolocation	Select the checkbox to allow geolocation tracking for address lookup.
Mapping Fields	Specify a custom map from the attributes returned by a provider to Agent address record columns.

Use the Test button for troubleshooting data mapping issues. Quickly view the raw data returned by the provider and see how it is mapped to Agent address categories.

Mapping Fields usage

Data elements are different for each service provide in general, but can also vary by country. Agent has a default map for each provider, but the Mapping Fields option allows the mapping to be updated for country-specific mapping and/or Provider-specific data elements.

Base/default mapping:

JSON

{
    address1: "Address1",
    address2: "Address2",
    city: "Locality",
    state: "AdministrativeArea",
    postal_code: "{PostalCode}{-{PostalCodeSecondary}}",
    county: "County"
}

The Mapping Field can be specify a new default map as well as country-specific mappings. The following example provides a specific mapping for the default and different mapping for Great Britain (GBR) using attributes form the Loqate data set.

It also demonstrates a compound mapping for company_name that will only add a comma between Company and Department if Department is provided: "company_name": "{Company}{, {Department}}}".

JSON

[
  {
    "country": [],
    "company_name": "{Company}{, {Department}}}",
    "address1": "Line1",
    "address2": "Line2",
    "address3": "Line3",
    "city": "City",
    "state": "Province",
    "postal_code": "PostalCode",
    "county": "AdminAreaName"
  },
  {
    "country": ["GBR"],
    "company_name": "{Company}{, {Department}}}",
    "address1": "Line1",
    "address2": "Line2",
    "address3": "AdminAreaName",
    "city": "City",
    "state": "Province",
    "postal_code": "PostalCode",
    "county": "County"
  }
]

Mailers

Field	Description
Provider	Select the provider to use for mailers. Choose from: COMPlus - utilizes the COM+ services WebService - utilizes a hosted Mailers web service Blank or DotNET - utilizes a DotNET mailers service
Web Account	Enter the Web Account number provided by Emplifi for the hosted Mailers Web service.
Web Password	Enter the password for the Web Account.
Data Path	This is the full path where the Mailers+4 data file is installed. It is a location on the Emplifi Agent Server. If this path is not filled in, the system assumes you are not using Mailers+4.
National Path Regional Path	Mailers+4 supports subsetting the data file by nation and by region. Theoretically, this can speed up searches if most of your customers are in the same geographic area, because less data has to be searched. From a practical standpoint, on most modern computers the search response time is already less than a second, so any performance increase gained is negligible, and not worth the effort of maintaining multiple files.
QCode (Canada)Installed	QCode is a third-party product that supports Canadian addresses.
Postcode (UK)Installed	Postcode is a third-party product that supports UK addresses.
QAS Endpoint URL	QAS is a third-party product that supports U.S. and international addresses, depending on the countries that are licensed. Currently, Emplifi supports QAS Pro Web version only. This must be licensed directly from Experian QAS. QAS Endpoint URL is used by QAS (Various).

Expiration of Mailers software

When the Mailers software expires, users receive a warning message. The message occurs the first time the user attempts to validate an address with the expired software.