Personator Consumer:Notice: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
{{CustomTOC}}
{{CustomTOC}}


==Personator 2017 Update==
==Personator 2018 Update==
''Released 02/17/2017''
''Released 03/01/2018''


The new version of Personator can now be consumed using the following endpoint:
The new version of Personator with structural changes to the WSDL that can now be consumed using the following endpoint:


:;rcpersonator.melissadata.net
:;rcpersonator.melissadata.net


Personator continues to grow with demand for new demographic information and input properties to help track a specific target. The 2017 update includes the addition of new elements in the Request/Response Strucutre which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.
Personator continues to grow with demand for new IP Address information and input properties to help track a specific target. The 2018 update includes the addition of new elements in the Request/Response Structure which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.
 


===Timeline===
===Timeline===
The official Personator Endpoint (personator.melissadata.net) will be updated to the new version on April 3rd, 2017. The rcpersonator endpoint will continue to be online until May 17th, 2017, after which it will be taken offline.
The official Personator Endpoint (personator.melissadata.net) will be updated to the new version on <insert update date>. The rcpersonator endpoint will continue to be online until '''06/01/2018''', after which it will be taken offline.
 
Here is the official timeline:
Here is the official timeline:


Line 18: Line 20:
|-
|-
|
|
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''02/17/2017'''
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''03/01/2018'''
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''04/03/2017'''
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''04/18/2018'''
|style="background-color:#0070c0; color:white; padding:5px;"|'''05/17/2017'''
|style="background-color:#0070c0; color:white; padding:5px;"|'''06/01/2018'''
|- style="border-right:10px solid red;"
|- style="border-right:10px solid red;"
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''Release Candidate Endpoint'''<br>(rcpersonator.melissadata.net)
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''Release Candidate Endpoint'''<br>(rcpersonator.melissadata.net)
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Release: Version 5
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Release: Version 5.2
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 5
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 5.2
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Offline
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Offline
|-
|-
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|'''Official Endpoint'''<br>(personator.melissadata.net)
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|'''Official Endpoint'''<br>(personator.melissadata.net)
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 4
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 5.1.31
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Update: Version 5
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Update: Version 5.2
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Version 5
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Version 5.2
|}
|}


Line 37: Line 39:
Clients whose Web Service Integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:
Clients whose Web Service Integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:


#All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before April 3rd, 2017.
#All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before '''04/18/2018'''.
#Come April 3, we will be updating the Official Endpoint with Version 5 of Personator. At this time, all applications must be switched back to use the Official Endpoint before May 17th, 2017 when the Release Candidate endpoint goes offline.
#Come '''04/18/2018''', we will be updating the Official Endpoint with Version 5.2 of Personator. At this time, all applications must be switched back to use the Official Endpoint before '''06/01/2018''' when the Release Candidate endpoint goes offline.


Clients whose Web Service Integrations support structure/WSDL additions are still strongly encouraged to follow this update procedure, but are not required to.
''Clients whose Web Service Integrations support structure/WSDL additions are still strongly encouraged to follow this update procedure, but are not required to.''




===Version 5 Changes===
===Version 5 Changes===
The following elements have been added as a request field:
====Input Structure====
:The following elements have been added as a request field:


{|class="alternate01" cellspacing="0"
:{|class="alternate01" cellspacing="0"
!Input Field
!Input Field
|-
|-
|SocialSecurity
|IPAddress
|-
|BirthDay
|-
|BirthMonth
|-
|BirthYear
|}
|}


:;Please Note
::The BirthDay, BirthMonth and BirthYear Inputs are only place holders for the web service. They currently do not provide any functionality. A separate announcement will be sent for the activation of these new fields and features at a future time.


The following elements have been added as part of the default response structure:
::The IP Address Input however, allows for retrieving IP Address Information. The new output fields for IP Address, are defined below.


{|class="alternate01" cellspacing="0"
!Default Output Field
|-
|MelissaAddressKeyBase
|}


====Output Structure====
:The following elements have been added as part of the response structure.


The following elements have been added as part of the response structure:
:It is now possible to retrieve these fields when entering an input IP Address and requesting for the columns from the GrpIPAddress:


{|class="alternate01" cellspacing="0"
:{|class="alternate01" cellspacing="0"
!Additional Output Fields
!Column Name!!Column Group
|-
|DistanceAddressToIP||rowspan="17"|GrpIPAddress
|-
|IPAddress
|-
|IPCity
|-
|-
|MoveDate
|IPConnectionSpeed
|-
|-
|HouseholdSize
|IPConnectionType
|-
|-
|CreditCardUser
|IPContinent
|-
|-
|PresenceOfSenior
|IPCountryAbbreviation
|-
|-
|ChildrenAgeRange
|IPCountryName
|-
|-
|Education
|IPDomainName
|-
|-
|PoliticalParty
|IPISPName
|-
|-
|TypeOfVehicles
|IPLatitude
|-
|IPLongitude
|-
|IPPostalCode
|-
|IPProxyDescription
|-
|IPProxyType
|-
|IPRegion
|-
|IPUTC
|}
|}




In order to retrieve these new elements in the Response, you may enumerate each field in the Columns Request:
:The new IP Address output fields and their definitions can be found here: [[Personator:Response#IPAddress|Personator Response IP Address]].
 
:There is also a new EstimatedHomeValue column. It currently does not output any data/values. A separate announcement will be sent for the activation of this new field and its features at a future time.
 
:{|class="alternate01" cellspacing="0"
!Column Name!!Column Group
|-
|EstimatedHomeValue||None
|}
 
 
In order to retrieve these new elements in the Response, you may enumerate each field in the Columns Request or request for the GrpIPAddress column:


<pre>
<pre>
<Columns>MoveDate,HouseholdSize,CreditCardUser,PresenceOfSenior,ChildrenAgeRange,Education,PoliticalParty,TypeOfVehicles</Columns>
<Columns>EstimatedHomeValue,DistanceAddressToIP,IPAddress,IPCity,IPConnectionSpeed,IPConnectionType,IPContinent,IPCountryAbbreviation,IPCountryName,IPDomainName,IPISPName,IPLatitude,IPLongitude,IPPostalCode,IPProxyDescription,IPProxyType,IPREgion,IPUTC</Columns>
</pre>
</pre>
;Please Note:
:These new columns are only placeholders for the web service structure. They currently do not output any data/values. A separate announcement will be sent for the activation of these new fields and features at a future time.




[[Category:Personator]]
[[Category:Personator]]

Revision as of 23:54, 28 February 2018

← Personator


Personator 2018 Update

Released 03/01/2018

The new version of Personator with structural changes to the WSDL that can now be consumed using the following endpoint:

rcpersonator.melissadata.net

Personator continues to grow with demand for new IP Address information and input properties to help track a specific target. The 2018 update includes the addition of new elements in the Request/Response Structure which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.


Timeline

The official Personator Endpoint (personator.melissadata.net) will be updated to the new version on <insert update date>. The rcpersonator endpoint will continue to be online until 06/01/2018, after which it will be taken offline.

Here is the official timeline:

03/01/2018 04/18/2018 06/01/2018
Release Candidate Endpoint
(rcpersonator.melissadata.net)
Release: Version 5.2 Version 5.2 Offline
Official Endpoint
(personator.melissadata.net)
Version 5.1.31 Update: Version 5.2 Version 5.2


Update Procedures

Clients whose Web Service Integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:

  1. All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before 04/18/2018.
  2. Come 04/18/2018, we will be updating the Official Endpoint with Version 5.2 of Personator. At this time, all applications must be switched back to use the Official Endpoint before 06/01/2018 when the Release Candidate endpoint goes offline.

Clients whose Web Service Integrations support structure/WSDL additions are still strongly encouraged to follow this update procedure, but are not required to.


Version 5 Changes

Input Structure

The following elements have been added as a request field:
Input Field
IPAddress
BirthDay
BirthMonth
BirthYear
Please Note
The BirthDay, BirthMonth and BirthYear Inputs are only place holders for the web service. They currently do not provide any functionality. A separate announcement will be sent for the activation of these new fields and features at a future time.
The IP Address Input however, allows for retrieving IP Address Information. The new output fields for IP Address, are defined below.


Output Structure

The following elements have been added as part of the response structure.
It is now possible to retrieve these fields when entering an input IP Address and requesting for the columns from the GrpIPAddress:
Column Name Column Group
DistanceAddressToIP GrpIPAddress
IPAddress
IPCity
IPConnectionSpeed
IPConnectionType
IPContinent
IPCountryAbbreviation
IPCountryName
IPDomainName
IPISPName
IPLatitude
IPLongitude
IPPostalCode
IPProxyDescription
IPProxyType
IPRegion
IPUTC


The new IP Address output fields and their definitions can be found here: Personator Response IP Address.
There is also a new EstimatedHomeValue column. It currently does not output any data/values. A separate announcement will be sent for the activation of this new field and its features at a future time.
Column Name Column Group
EstimatedHomeValue None


In order to retrieve these new elements in the Response, you may enumerate each field in the Columns Request or request for the GrpIPAddress column:

<Columns>EstimatedHomeValue,DistanceAddressToIP,IPAddress,IPCity,IPConnectionSpeed,IPConnectionType,IPContinent,IPCountryAbbreviation,IPCountryName,IPDomainName,IPISPName,IPLatitude,IPLongitude,IPPostalCode,IPProxyDescription,IPProxyType,IPREgion,IPUTC</Columns>