Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A Person entity is an identified entity that has interacted with or been loaded into the Mobile Database. It is identified by a person_id, which uniquely identifies the record. A customer can also define an external_person_id, which is a unique identifier from the customer system for reference and cross-linking.

A person Person can also be tracked/linked by a mobile number (MDN). This alternate identifier is sufficient in the short-term, but it is not an ideal long-term identification method because mobile numbers can be changed, returned, ported, and recycled.

...

Because of the dynamic nature of mobile participation and campaigns, it is possible that person Person records could exist in either the Mobile Database or the Customer system in any sequence/order. The following logic ensures that the same Person entity gets tied together to avoid inadvertently linking two different people:

  1. The person_id and external_person_id columns are always treated as the same person Person record and must be unique (the external_person_id can be omitted if it is not used/exist).
  2. If the MDN and carrier_code match an existing person Person record, they will be considered the same Person entity. If the carrier_code does not match, then they will be assumed to be different people.
    Note
    : Since phone numbers often get ported and/or recycled, and to ensure MMA compliance, it is not a valid assumption that carrier changes are always the same person.

...

Data Element

Type

Description

person_id

String

Vibes unique identifier for each person Person record in the Mobile Database.

external_person_id

String

Customer unique identifier for a person Person in the Mobile Database. This value is optional, but if specified, must be unique within the Mobile Database.

mobile_phone

Object

Object representation of a Person's mobile phone. A person Person can have only one active Mobile Phone at a time.

mobile_phone.mdn

String

The Mobile Directory Number (a number that can be dialed).

mobile_phone.carrier_code

String

The Cellular Carrier associated with this Mobile number. Please see #TBD for a list of valid Carrier Codes.

custom_fields

Object

 

...