Amazon Connect Customer Profiles

2025/07/31 - Amazon Connect Customer Profiles - 9 updated api methods

Changes  The release updates standard profile with 2 new fields that supports account-level engagement. Updated APIs include CreateProfile, UpdateProfile, MergeProfiles, SearchProfiles, BatchGetProfile, GetSegmentMembership, CreateSegmentDefinition, CreateSegmentEstimate.

BatchGetProfile (updated) Link ¶
Changes (response)
{'Profiles': {'EngagementPreferences': {'Email': [{'ContactType': 'PhoneNumber '
                                                                  '| '
                                                                  'MobilePhoneNumber '
                                                                  '| '
                                                                  'HomePhoneNumber '
                                                                  '| '
                                                                  'BusinessPhoneNumber '
                                                                  '| '
                                                                  'EmailAddress '
                                                                  '| '
                                                                  'PersonalEmailAddress '
                                                                  '| '
                                                                  'BusinessEmailAddress',
                                                   'KeyName': 'string',
                                                   'KeyValue': 'string',
                                                   'ProfileId': 'string'}],
                                        'Phone': [{'ContactType': 'PhoneNumber '
                                                                  '| '
                                                                  'MobilePhoneNumber '
                                                                  '| '
                                                                  'HomePhoneNumber '
                                                                  '| '
                                                                  'BusinessPhoneNumber '
                                                                  '| '
                                                                  'EmailAddress '
                                                                  '| '
                                                                  'PersonalEmailAddress '
                                                                  '| '
                                                                  'BusinessEmailAddress',
                                                   'KeyName': 'string',
                                                   'KeyValue': 'string',
                                                   'ProfileId': 'string'}]},
              'ProfileType': 'ACCOUNT_PROFILE | PROFILE'}}

Get a batch of profiles.

See also: AWS API Documentation

Request Syntax

client.batch_get_profile(
    DomainName='string',
    ProfileIds=[
        'string',
    ]
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type ProfileIds:

list

param ProfileIds:

[REQUIRED]

List of unique identifiers for customer profiles to retrieve.

  • (string) --

rtype:

dict

returns:

Response Syntax

{
    'Errors': [
        {
            'Code': 'string',
            'Message': 'string',
            'ProfileId': 'string'
        },
    ],
    'Profiles': [
        {
            'ProfileId': 'string',
            'AccountNumber': 'string',
            'AdditionalInformation': 'string',
            'PartyType': 'INDIVIDUAL'|'BUSINESS'|'OTHER',
            'BusinessName': 'string',
            'FirstName': 'string',
            'MiddleName': 'string',
            'LastName': 'string',
            'BirthDate': 'string',
            'Gender': 'MALE'|'FEMALE'|'UNSPECIFIED',
            'PhoneNumber': 'string',
            'MobilePhoneNumber': 'string',
            'HomePhoneNumber': 'string',
            'BusinessPhoneNumber': 'string',
            'EmailAddress': 'string',
            'PersonalEmailAddress': 'string',
            'BusinessEmailAddress': 'string',
            'Address': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'ShippingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'MailingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'BillingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'Attributes': {
                'string': 'string'
            },
            'FoundByItems': [
                {
                    'KeyName': 'string',
                    'Values': [
                        'string',
                    ]
                },
            ],
            'PartyTypeString': 'string',
            'GenderString': 'string',
            'ProfileType': 'ACCOUNT_PROFILE'|'PROFILE',
            'EngagementPreferences': {
                'Phone': [
                    {
                        'KeyName': 'string',
                        'KeyValue': 'string',
                        'ProfileId': 'string',
                        'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                    },
                ],
                'Email': [
                    {
                        'KeyName': 'string',
                        'KeyValue': 'string',
                        'ProfileId': 'string',
                        'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                    },
                ]
            }
        },
    ]
}

Response Structure

  • (dict) --

    • Errors (list) --

      For information about the errors that are common to all actions, see Common Errors.

      • (dict) --

        Error object describing why a specific profile failed.

        • Code (string) --

          Status code for why a specific profile failed.

        • Message (string) --

          Message describing why a specific profile failed.

        • ProfileId (string) --

          The profile id that failed.

    • Profiles (list) --

      Array of Profile Objects.

      • (dict) --

        The standard profile of a customer.

        • ProfileId (string) --

          The unique identifier of a customer profile.

        • AccountNumber (string) --

          An account number that you have assigned to the customer.

        • AdditionalInformation (string) --

          Any additional information relevant to the customer’s profile.

        • PartyType (string) --

          The type of profile used to describe the customer.

        • BusinessName (string) --

          The name of the customer’s business.

        • FirstName (string) --

          The customer’s first name.

        • MiddleName (string) --

          The customer’s middle name.

        • LastName (string) --

          The customer’s last name.

        • BirthDate (string) --

          The customer’s birth date.

        • Gender (string) --

          The gender with which the customer identifies.

        • PhoneNumber (string) --

          The customer's phone number, which has not been specified as a mobile, home, or business number.

        • MobilePhoneNumber (string) --

          The customer’s mobile phone number.

        • HomePhoneNumber (string) --

          The customer’s home phone number.

        • BusinessPhoneNumber (string) --

          The customer’s home phone number.

        • EmailAddress (string) --

          The customer’s email address, which has not been specified as a personal or business address.

        • PersonalEmailAddress (string) --

          The customer’s personal email address.

        • BusinessEmailAddress (string) --

          The customer’s business email address.

        • Address (dict) --

          A generic address associated with the customer that is not mailing, shipping, or billing.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • ShippingAddress (dict) --

          The customer’s shipping address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • MailingAddress (dict) --

          The customer’s mailing address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • BillingAddress (dict) --

          The customer’s billing address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • Attributes (dict) --

          A key value pair of attributes of a customer profile.

          • (string) --

            • (string) --

        • FoundByItems (list) --

          A list of items used to find a profile returned in a SearchProfiles response. An item is a key-value(s) pair that matches an attribute in the profile.

          If the optional AdditionalSearchKeys parameter was included in the SearchProfiles request, the FoundByItems list should be interpreted based on the LogicalOperator used in the request:

          • AND - The profile included in the response matched all of the search keys specified in the request. The FoundByItems will include all of the key-value(s) pairs that were specified in the request (as this is a requirement of AND search logic).

          • OR - The profile included in the response matched at least one of the search keys specified in the request. The FoundByItems will include each of the key-value(s) pairs that the profile was found by.

          The OR relationship is the default behavior if the LogicalOperator parameter is not included in the SearchProfiles request.

          • (dict) --

            A data type pair that consists of a KeyName and Values list that were used to find a profile returned in response to a SearchProfiles request.

            • KeyName (string) --

              A searchable identifier of a customer profile.

            • Values (list) --

              A list of key values.

              • (string) --

        • PartyTypeString (string) --

          An alternative to PartyType which accepts any string as input.

        • GenderString (string) --

          An alternative to Gender which accepts any string as input.

        • ProfileType (string) --

          The type of the profile.

        • EngagementPreferences (dict) --

          The customer or account’s engagement preferences.

          • Phone (list) --

            A list of phone-related contact preferences

            • (dict) --

              Object that defines users contact preference.

              • KeyName (string) --

                A searchable, unique identifier of a customer profile.

              • KeyValue (string) --

                The key value used to look up profile based off the keyName.

              • ProfileId (string) --

                The unique identifier of a customer profile.

              • ContactType (string) --

                The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

          • Email (list) --

            A list of email-related contact preferences

            • (dict) --

              Object that defines users contact preference.

              • KeyName (string) --

                A searchable, unique identifier of a customer profile.

              • KeyValue (string) --

                The key value used to look up profile based off the keyName.

              • ProfileId (string) --

                The unique identifier of a customer profile.

              • ContactType (string) --

                The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

CreateProfile (updated) Link ¶
Changes (request)
{'EngagementPreferences': {'Email': [{'ContactType': 'PhoneNumber | '
                                                     'MobilePhoneNumber | '
                                                     'HomePhoneNumber | '
                                                     'BusinessPhoneNumber | '
                                                     'EmailAddress | '
                                                     'PersonalEmailAddress | '
                                                     'BusinessEmailAddress',
                                      'KeyName': 'string',
                                      'KeyValue': 'string',
                                      'ProfileId': 'string'}],
                           'Phone': [{'ContactType': 'PhoneNumber | '
                                                     'MobilePhoneNumber | '
                                                     'HomePhoneNumber | '
                                                     'BusinessPhoneNumber | '
                                                     'EmailAddress | '
                                                     'PersonalEmailAddress | '
                                                     'BusinessEmailAddress',
                                      'KeyName': 'string',
                                      'KeyValue': 'string',
                                      'ProfileId': 'string'}]},
 'ProfileType': 'ACCOUNT_PROFILE | PROFILE'}

Creates a standard profile.

A standard profile represents the following attributes for a customer profile in a domain.

See also: AWS API Documentation

Request Syntax

client.create_profile(
    DomainName='string',
    AccountNumber='string',
    AdditionalInformation='string',
    PartyType='INDIVIDUAL'|'BUSINESS'|'OTHER',
    BusinessName='string',
    FirstName='string',
    MiddleName='string',
    LastName='string',
    BirthDate='string',
    Gender='MALE'|'FEMALE'|'UNSPECIFIED',
    PhoneNumber='string',
    MobilePhoneNumber='string',
    HomePhoneNumber='string',
    BusinessPhoneNumber='string',
    EmailAddress='string',
    PersonalEmailAddress='string',
    BusinessEmailAddress='string',
    Address={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    ShippingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    MailingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    BillingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    Attributes={
        'string': 'string'
    },
    PartyTypeString='string',
    GenderString='string',
    ProfileType='ACCOUNT_PROFILE'|'PROFILE',
    EngagementPreferences={
        'Phone': [
            {
                'KeyName': 'string',
                'KeyValue': 'string',
                'ProfileId': 'string',
                'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
            },
        ],
        'Email': [
            {
                'KeyName': 'string',
                'KeyValue': 'string',
                'ProfileId': 'string',
                'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
            },
        ]
    }
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type AccountNumber:

string

param AccountNumber:

An account number that you have assigned to the customer.

type AdditionalInformation:

string

param AdditionalInformation:

Any additional information relevant to the customer’s profile.

type PartyType:

string

param PartyType:

The type of profile used to describe the customer.

type BusinessName:

string

param BusinessName:

The name of the customer’s business.

type FirstName:

string

param FirstName:

The customer’s first name.

type MiddleName:

string

param MiddleName:

The customer’s middle name.

type LastName:

string

param LastName:

The customer’s last name.

type BirthDate:

string

param BirthDate:

The customer’s birth date.

type Gender:

string

param Gender:

The gender with which the customer identifies.

type PhoneNumber:

string

param PhoneNumber:

The customer’s phone number, which has not been specified as a mobile, home, or business number.

type MobilePhoneNumber:

string

param MobilePhoneNumber:

The customer’s mobile phone number.

type HomePhoneNumber:

string

param HomePhoneNumber:

The customer’s home phone number.

type BusinessPhoneNumber:

string

param BusinessPhoneNumber:

The customer’s business phone number.

type EmailAddress:

string

param EmailAddress:

The customer’s email address, which has not been specified as a personal or business address.

type PersonalEmailAddress:

string

param PersonalEmailAddress:

The customer’s personal email address.

type BusinessEmailAddress:

string

param BusinessEmailAddress:

The customer’s business email address.

type Address:

dict

param Address:

A generic address associated with the customer that is not mailing, shipping, or billing.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type ShippingAddress:

dict

param ShippingAddress:

The customer’s shipping address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type MailingAddress:

dict

param MailingAddress:

The customer’s mailing address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type BillingAddress:

dict

param BillingAddress:

The customer’s billing address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type Attributes:

dict

param Attributes:

A key value pair of attributes of a customer profile.

  • (string) --

    • (string) --

type PartyTypeString:

string

param PartyTypeString:

An alternative to PartyType which accepts any string as input.

type GenderString:

string

param GenderString:

An alternative to Gender which accepts any string as input.

type ProfileType:

string

param ProfileType:

The type of the profile.

type EngagementPreferences:

dict

param EngagementPreferences:

Object that defines the preferred methods of engagement, per channel.

  • Phone (list) --

    A list of phone-related contact preferences

    • (dict) --

      Object that defines users contact preference.

      • KeyName (string) --

        A searchable, unique identifier of a customer profile.

      • KeyValue (string) --

        The key value used to look up profile based off the keyName.

      • ProfileId (string) --

        The unique identifier of a customer profile.

      • ContactType (string) --

        The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

  • Email (list) --

    A list of email-related contact preferences

    • (dict) --

      Object that defines users contact preference.

      • KeyName (string) --

        A searchable, unique identifier of a customer profile.

      • KeyValue (string) --

        The key value used to look up profile based off the keyName.

      • ProfileId (string) --

        The unique identifier of a customer profile.

      • ContactType (string) --

        The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

rtype:

dict

returns:

Response Syntax

{
    'ProfileId': 'string'
}

Response Structure

  • (dict) --

    • ProfileId (string) --

      The unique identifier of a customer profile.

CreateSegmentDefinition (updated) Link ¶
Changes (request)
{'SegmentGroups': {'Groups': {'Dimensions': {'ProfileAttributes': {'ProfileType': {'DimensionType': 'INCLUSIVE '
                                                                                                    '| '
                                                                                                    'EXCLUSIVE',
                                                                                   'Values': ['ACCOUNT_PROFILE '
                                                                                              '| '
                                                                                              'PROFILE']}}}}}}

Creates a segment definition associated to the given domain.

See also: AWS API Documentation

Request Syntax

client.create_segment_definition(
    DomainName='string',
    SegmentDefinitionName='string',
    DisplayName='string',
    Description='string',
    SegmentGroups={
        'Groups': [
            {
                'Dimensions': [
                    {
                        'ProfileAttributes': {
                            'AccountNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'AdditionalInformation': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'FirstName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'LastName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MiddleName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'GenderString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PartyTypeString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BirthDate': {
                                'DimensionType': 'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessPhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'HomePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MobilePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'EmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PersonalEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'Address': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ShippingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'MailingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'BillingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'Attributes': {
                                'string': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ProfileType': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE',
                                'Values': [
                                    'ACCOUNT_PROFILE'|'PROFILE',
                                ]
                            }
                        },
                        'CalculatedAttributes': {
                            'string': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                'Values': [
                                    'string',
                                ],
                                'ConditionOverrides': {
                                    'Range': {
                                        'Start': 123,
                                        'End': 123,
                                        'Unit': 'DAYS'
                                    }
                                }
                            }
                        }
                    },
                ],
                'SourceSegments': [
                    {
                        'SegmentDefinitionName': 'string'
                    },
                ],
                'SourceType': 'ALL'|'ANY'|'NONE',
                'Type': 'ALL'|'ANY'|'NONE'
            },
        ],
        'Include': 'ALL'|'ANY'|'NONE'
    },
    Tags={
        'string': 'string'
    }
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type SegmentDefinitionName:

string

param SegmentDefinitionName:

[REQUIRED]

The unique name of the segment definition.

type DisplayName:

string

param DisplayName:

[REQUIRED]

The display name of the segment definition.

type Description:

string

param Description:

The description of the segment definition.

type SegmentGroups:

dict

param SegmentGroups:

[REQUIRED]

Specifies the base segments and dimensions for a segment definition along with their respective relationship.

  • Groups (list) --

    Holds the list of groups within the segment definition.

    • (dict) --

      Contains dimensions that determine what to segment on.

      • Dimensions (list) --

        Defines the attributes to segment on.

        • (dict) --

          Object that holds what profile and calculated attributes to segment on.

          • ProfileAttributes (dict) --

            Object that holds the profile attributes to segment on.

            • AccountNumber (dict) --

              A field to describe values to segment on within account number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • AdditionalInformation (dict) --

              A field to describe values to segment on within additional information.

              • DimensionType (string) -- [REQUIRED]

                The action to segment with.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • FirstName (dict) --

              A field to describe values to segment on within first name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • LastName (dict) --

              A field to describe values to segment on within last name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • MiddleName (dict) --

              A field to describe values to segment on within middle name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • GenderString (dict) --

              A field to describe values to segment on within genderString.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PartyTypeString (dict) --

              A field to describe values to segment on within partyTypeString.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BirthDate (dict) --

              A field to describe values to segment on within birthDate.

              • DimensionType (string) -- [REQUIRED]

                The action to segment with.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PhoneNumber (dict) --

              A field to describe values to segment on within phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessName (dict) --

              A field to describe values to segment on within business name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessPhoneNumber (dict) --

              A field to describe values to segment on within business phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • HomePhoneNumber (dict) --

              A field to describe values to segment on within home phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • MobilePhoneNumber (dict) --

              A field to describe values to segment on within mobile phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • EmailAddress (dict) --

              A field to describe values to segment on within email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PersonalEmailAddress (dict) --

              A field to describe values to segment on within personal email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessEmailAddress (dict) --

              A field to describe values to segment on within business email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • Address (dict) --

              A field to describe values to segment on within address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • ShippingAddress (dict) --

              A field to describe values to segment on within shipping address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • MailingAddress (dict) --

              A field to describe values to segment on within mailing address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • BillingAddress (dict) --

              A field to describe values to segment on within billing address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • Attributes (dict) --

              A field to describe values to segment on within attributes.

              • (string) --

                • (dict) --

                  Object that segments on various Customer Profile's fields.

                  • DimensionType (string) -- [REQUIRED]

                    The action to segment with.

                  • Values (list) -- [REQUIRED]

                    The values to apply the DimensionType on.

                    • (string) --

            • ProfileType (dict) --

              A field to describe values to segment on within profile type.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

          • CalculatedAttributes (dict) --

            Object that holds the calculated attributes to segment on.

            • (string) --

              • (dict) --

                Object that segments on Customer Profile's Calculated Attributes.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment with.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType with.

                  • (string) --

                • ConditionOverrides (dict) --

                  Applies the given condition over the initial Calculated Attribute's definition.

                  • Range (dict) --

                    The relative time period over which data is included in the aggregation for this override.

                    • Start (integer) -- [REQUIRED]

                      The start time of when to include objects.

                    • End (integer) --

                      The end time of when to include objects.

                    • Unit (string) -- [REQUIRED]

                      The unit for start and end.

      • SourceSegments (list) --

        Defines the starting source of data.

        • (dict) --

          The source segments to build off of.

          • SegmentDefinitionName (string) --

            The unique name of the segment definition.

      • SourceType (string) --

        Defines how to interact with the source data.

      • Type (string) --

        Defines how to interact with the profiles found in the current filtering.

  • Include (string) --

    Defines whether to include or exclude the profiles that fit the segment criteria.

type Tags:

dict

param Tags:

The tags used to organize, track, or control access for this resource.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'SegmentDefinitionName': 'string',
    'DisplayName': 'string',
    'Description': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'SegmentDefinitionArn': 'string',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • SegmentDefinitionName (string) --

      The name of the segment definition.

    • DisplayName (string) --

      The display name of the segment definition.

    • Description (string) --

      The description of the segment definition.

    • CreatedAt (datetime) --

      The timestamp of when the segment definition was created.

    • SegmentDefinitionArn (string) --

      The arn of the segment definition.

    • Tags (dict) --

      The tags used to organize, track, or control access for this resource.

      • (string) --

        • (string) --

CreateSegmentEstimate (updated) Link ¶
Changes (request)
{'SegmentQuery': {'Groups': {'Dimensions': {'ProfileAttributes': {'ProfileType': {'DimensionType': 'INCLUSIVE '
                                                                                                   '| '
                                                                                                   'EXCLUSIVE',
                                                                                  'Values': ['ACCOUNT_PROFILE '
                                                                                             '| '
                                                                                             'PROFILE']}}}}}}

Creates a segment estimate query.

See also: AWS API Documentation

Request Syntax

client.create_segment_estimate(
    DomainName='string',
    SegmentQuery={
        'Groups': [
            {
                'Dimensions': [
                    {
                        'ProfileAttributes': {
                            'AccountNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'AdditionalInformation': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'FirstName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'LastName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MiddleName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'GenderString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PartyTypeString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BirthDate': {
                                'DimensionType': 'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessPhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'HomePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MobilePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'EmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PersonalEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'Address': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ShippingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'MailingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'BillingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'Attributes': {
                                'string': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ProfileType': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE',
                                'Values': [
                                    'ACCOUNT_PROFILE'|'PROFILE',
                                ]
                            }
                        },
                        'CalculatedAttributes': {
                            'string': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                'Values': [
                                    'string',
                                ],
                                'ConditionOverrides': {
                                    'Range': {
                                        'Start': 123,
                                        'End': 123,
                                        'Unit': 'DAYS'
                                    }
                                }
                            }
                        }
                    },
                ],
                'SourceSegments': [
                    {
                        'SegmentDefinitionName': 'string'
                    },
                ],
                'SourceType': 'ALL'|'ANY'|'NONE',
                'Type': 'ALL'|'ANY'|'NONE'
            },
        ],
        'Include': 'ALL'|'ANY'|'NONE'
    }
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type SegmentQuery:

dict

param SegmentQuery:

[REQUIRED]

The segment query for calculating a segment estimate.

  • Groups (list) --

    Holds the list of groups within the segment definition.

    • (dict) --

      Contains dimensions that determine what to segment on.

      • Dimensions (list) --

        Defines the attributes to segment on.

        • (dict) --

          Object that holds what profile and calculated attributes to segment on.

          • ProfileAttributes (dict) --

            Object that holds the profile attributes to segment on.

            • AccountNumber (dict) --

              A field to describe values to segment on within account number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • AdditionalInformation (dict) --

              A field to describe values to segment on within additional information.

              • DimensionType (string) -- [REQUIRED]

                The action to segment with.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • FirstName (dict) --

              A field to describe values to segment on within first name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • LastName (dict) --

              A field to describe values to segment on within last name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • MiddleName (dict) --

              A field to describe values to segment on within middle name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • GenderString (dict) --

              A field to describe values to segment on within genderString.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PartyTypeString (dict) --

              A field to describe values to segment on within partyTypeString.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BirthDate (dict) --

              A field to describe values to segment on within birthDate.

              • DimensionType (string) -- [REQUIRED]

                The action to segment with.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PhoneNumber (dict) --

              A field to describe values to segment on within phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessName (dict) --

              A field to describe values to segment on within business name.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessPhoneNumber (dict) --

              A field to describe values to segment on within business phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • HomePhoneNumber (dict) --

              A field to describe values to segment on within home phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • MobilePhoneNumber (dict) --

              A field to describe values to segment on within mobile phone number.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • EmailAddress (dict) --

              A field to describe values to segment on within email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • PersonalEmailAddress (dict) --

              A field to describe values to segment on within personal email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • BusinessEmailAddress (dict) --

              A field to describe values to segment on within business email address.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

            • Address (dict) --

              A field to describe values to segment on within address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • ShippingAddress (dict) --

              A field to describe values to segment on within shipping address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • MailingAddress (dict) --

              A field to describe values to segment on within mailing address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • BillingAddress (dict) --

              A field to describe values to segment on within billing address.

              • City (dict) --

                The city belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Country (dict) --

                The country belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • County (dict) --

                The county belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • PostalCode (dict) --

                The postal code belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • Province (dict) --

                The province belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

              • State (dict) --

                The state belonging to the address.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment on.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType on.

                  • (string) --

            • Attributes (dict) --

              A field to describe values to segment on within attributes.

              • (string) --

                • (dict) --

                  Object that segments on various Customer Profile's fields.

                  • DimensionType (string) -- [REQUIRED]

                    The action to segment with.

                  • Values (list) -- [REQUIRED]

                    The values to apply the DimensionType on.

                    • (string) --

            • ProfileType (dict) --

              A field to describe values to segment on within profile type.

              • DimensionType (string) -- [REQUIRED]

                The action to segment on.

              • Values (list) -- [REQUIRED]

                The values to apply the DimensionType on.

                • (string) --

          • CalculatedAttributes (dict) --

            Object that holds the calculated attributes to segment on.

            • (string) --

              • (dict) --

                Object that segments on Customer Profile's Calculated Attributes.

                • DimensionType (string) -- [REQUIRED]

                  The action to segment with.

                • Values (list) -- [REQUIRED]

                  The values to apply the DimensionType with.

                  • (string) --

                • ConditionOverrides (dict) --

                  Applies the given condition over the initial Calculated Attribute's definition.

                  • Range (dict) --

                    The relative time period over which data is included in the aggregation for this override.

                    • Start (integer) -- [REQUIRED]

                      The start time of when to include objects.

                    • End (integer) --

                      The end time of when to include objects.

                    • Unit (string) -- [REQUIRED]

                      The unit for start and end.

      • SourceSegments (list) --

        Defines the starting source of data.

        • (dict) --

          The source segments to build off of.

          • SegmentDefinitionName (string) --

            The unique name of the segment definition.

      • SourceType (string) --

        Defines how to interact with the source data.

      • Type (string) --

        Defines how to interact with the profiles found in the current filtering.

  • Include (string) --

    Define whether to include or exclude the profiles that fit the segment criteria.

rtype:

dict

returns:

Response Syntax

{
    'DomainName': 'string',
    'EstimateId': 'string',
    'StatusCode': 123
}

Response Structure

  • (dict) --

    • DomainName (string) --

      The unique name of the domain.

    • EstimateId (string) --

      A unique identifier for the resource. The value can be passed to GetSegmentEstimate to retrieve the result of segment estimate status.

    • StatusCode (integer) --

      The status code for the response.

GetSegmentDefinition (updated) Link ¶
Changes (response)
{'SegmentGroups': {'Groups': {'Dimensions': {'ProfileAttributes': {'ProfileType': {'DimensionType': 'INCLUSIVE '
                                                                                                    '| '
                                                                                                    'EXCLUSIVE',
                                                                                   'Values': ['ACCOUNT_PROFILE '
                                                                                              '| '
                                                                                              'PROFILE']}}}}}}

Gets a segment definition from the domain.

See also: AWS API Documentation

Request Syntax

client.get_segment_definition(
    DomainName='string',
    SegmentDefinitionName='string'
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type SegmentDefinitionName:

string

param SegmentDefinitionName:

[REQUIRED]

The unique name of the segment definition.

rtype:

dict

returns:

Response Syntax

{
    'SegmentDefinitionName': 'string',
    'DisplayName': 'string',
    'Description': 'string',
    'SegmentGroups': {
        'Groups': [
            {
                'Dimensions': [
                    {
                        'ProfileAttributes': {
                            'AccountNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'AdditionalInformation': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'FirstName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'LastName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MiddleName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'GenderString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PartyTypeString': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BirthDate': {
                                'DimensionType': 'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessName': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessPhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'HomePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'MobilePhoneNumber': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'EmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'PersonalEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'BusinessEmailAddress': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                'Values': [
                                    'string',
                                ]
                            },
                            'Address': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ShippingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'MailingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'BillingAddress': {
                                'City': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Country': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'County': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'PostalCode': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'Province': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                },
                                'State': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'Attributes': {
                                'string': {
                                    'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                    'Values': [
                                        'string',
                                    ]
                                }
                            },
                            'ProfileType': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE',
                                'Values': [
                                    'ACCOUNT_PROFILE'|'PROFILE',
                                ]
                            }
                        },
                        'CalculatedAttributes': {
                            'string': {
                                'DimensionType': 'INCLUSIVE'|'EXCLUSIVE'|'CONTAINS'|'BEGINS_WITH'|'ENDS_WITH'|'BEFORE'|'AFTER'|'BETWEEN'|'NOT_BETWEEN'|'ON'|'GREATER_THAN'|'LESS_THAN'|'GREATER_THAN_OR_EQUAL'|'LESS_THAN_OR_EQUAL'|'EQUAL',
                                'Values': [
                                    'string',
                                ],
                                'ConditionOverrides': {
                                    'Range': {
                                        'Start': 123,
                                        'End': 123,
                                        'Unit': 'DAYS'
                                    }
                                }
                            }
                        }
                    },
                ],
                'SourceSegments': [
                    {
                        'SegmentDefinitionName': 'string'
                    },
                ],
                'SourceType': 'ALL'|'ANY'|'NONE',
                'Type': 'ALL'|'ANY'|'NONE'
            },
        ],
        'Include': 'ALL'|'ANY'|'NONE'
    },
    'SegmentDefinitionArn': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • SegmentDefinitionName (string) --

      The name of the segment definition.

    • DisplayName (string) --

      The display name of the segment definition.

    • Description (string) --

      The description of the segment definition.

    • SegmentGroups (dict) --

      The segment criteria associated with this definition.

      • Groups (list) --

        Holds the list of groups within the segment definition.

        • (dict) --

          Contains dimensions that determine what to segment on.

          • Dimensions (list) --

            Defines the attributes to segment on.

            • (dict) --

              Object that holds what profile and calculated attributes to segment on.

              • ProfileAttributes (dict) --

                Object that holds the profile attributes to segment on.

                • AccountNumber (dict) --

                  A field to describe values to segment on within account number.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • AdditionalInformation (dict) --

                  A field to describe values to segment on within additional information.

                  • DimensionType (string) --

                    The action to segment with.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • FirstName (dict) --

                  A field to describe values to segment on within first name.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • LastName (dict) --

                  A field to describe values to segment on within last name.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • MiddleName (dict) --

                  A field to describe values to segment on within middle name.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • GenderString (dict) --

                  A field to describe values to segment on within genderString.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • PartyTypeString (dict) --

                  A field to describe values to segment on within partyTypeString.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • BirthDate (dict) --

                  A field to describe values to segment on within birthDate.

                  • DimensionType (string) --

                    The action to segment with.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • PhoneNumber (dict) --

                  A field to describe values to segment on within phone number.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • BusinessName (dict) --

                  A field to describe values to segment on within business name.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • BusinessPhoneNumber (dict) --

                  A field to describe values to segment on within business phone number.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • HomePhoneNumber (dict) --

                  A field to describe values to segment on within home phone number.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • MobilePhoneNumber (dict) --

                  A field to describe values to segment on within mobile phone number.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • EmailAddress (dict) --

                  A field to describe values to segment on within email address.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • PersonalEmailAddress (dict) --

                  A field to describe values to segment on within personal email address.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • BusinessEmailAddress (dict) --

                  A field to describe values to segment on within business email address.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

                • Address (dict) --

                  A field to describe values to segment on within address.

                  • City (dict) --

                    The city belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Country (dict) --

                    The country belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • County (dict) --

                    The county belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • PostalCode (dict) --

                    The postal code belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Province (dict) --

                    The province belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • State (dict) --

                    The state belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                • ShippingAddress (dict) --

                  A field to describe values to segment on within shipping address.

                  • City (dict) --

                    The city belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Country (dict) --

                    The country belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • County (dict) --

                    The county belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • PostalCode (dict) --

                    The postal code belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Province (dict) --

                    The province belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • State (dict) --

                    The state belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                • MailingAddress (dict) --

                  A field to describe values to segment on within mailing address.

                  • City (dict) --

                    The city belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Country (dict) --

                    The country belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • County (dict) --

                    The county belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • PostalCode (dict) --

                    The postal code belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Province (dict) --

                    The province belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • State (dict) --

                    The state belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                • BillingAddress (dict) --

                  A field to describe values to segment on within billing address.

                  • City (dict) --

                    The city belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Country (dict) --

                    The country belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • County (dict) --

                    The county belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • PostalCode (dict) --

                    The postal code belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • Province (dict) --

                    The province belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                  • State (dict) --

                    The state belonging to the address.

                    • DimensionType (string) --

                      The action to segment on.

                    • Values (list) --

                      The values to apply the DimensionType on.

                      • (string) --

                • Attributes (dict) --

                  A field to describe values to segment on within attributes.

                  • (string) --

                    • (dict) --

                      Object that segments on various Customer Profile's fields.

                      • DimensionType (string) --

                        The action to segment with.

                      • Values (list) --

                        The values to apply the DimensionType on.

                        • (string) --

                • ProfileType (dict) --

                  A field to describe values to segment on within profile type.

                  • DimensionType (string) --

                    The action to segment on.

                  • Values (list) --

                    The values to apply the DimensionType on.

                    • (string) --

              • CalculatedAttributes (dict) --

                Object that holds the calculated attributes to segment on.

                • (string) --

                  • (dict) --

                    Object that segments on Customer Profile's Calculated Attributes.

                    • DimensionType (string) --

                      The action to segment with.

                    • Values (list) --

                      The values to apply the DimensionType with.

                      • (string) --

                    • ConditionOverrides (dict) --

                      Applies the given condition over the initial Calculated Attribute's definition.

                      • Range (dict) --

                        The relative time period over which data is included in the aggregation for this override.

                        • Start (integer) --

                          The start time of when to include objects.

                        • End (integer) --

                          The end time of when to include objects.

                        • Unit (string) --

                          The unit for start and end.

          • SourceSegments (list) --

            Defines the starting source of data.

            • (dict) --

              The source segments to build off of.

              • SegmentDefinitionName (string) --

                The unique name of the segment definition.

          • SourceType (string) --

            Defines how to interact with the source data.

          • Type (string) --

            Defines how to interact with the profiles found in the current filtering.

      • Include (string) --

        Defines whether to include or exclude the profiles that fit the segment criteria.

    • SegmentDefinitionArn (string) --

      The arn of the segment definition.

    • CreatedAt (datetime) --

      The timestamp of when the segment definition was created.

    • Tags (dict) --

      The tags used to organize, track, or control access for this resource.

      • (string) --

        • (string) --

GetSegmentMembership (updated) Link ¶
Changes (response)
{'Profiles': {'Profile': {'EngagementPreferences': {'Email': [{'ContactType': 'PhoneNumber '
                                                                              '| '
                                                                              'MobilePhoneNumber '
                                                                              '| '
                                                                              'HomePhoneNumber '
                                                                              '| '
                                                                              'BusinessPhoneNumber '
                                                                              '| '
                                                                              'EmailAddress '
                                                                              '| '
                                                                              'PersonalEmailAddress '
                                                                              '| '
                                                                              'BusinessEmailAddress',
                                                               'KeyName': 'string',
                                                               'KeyValue': 'string',
                                                               'ProfileId': 'string'}],
                                                    'Phone': [{'ContactType': 'PhoneNumber '
                                                                              '| '
                                                                              'MobilePhoneNumber '
                                                                              '| '
                                                                              'HomePhoneNumber '
                                                                              '| '
                                                                              'BusinessPhoneNumber '
                                                                              '| '
                                                                              'EmailAddress '
                                                                              '| '
                                                                              'PersonalEmailAddress '
                                                                              '| '
                                                                              'BusinessEmailAddress',
                                                               'KeyName': 'string',
                                                               'KeyValue': 'string',
                                                               'ProfileId': 'string'}]},
                          'ProfileType': 'ACCOUNT_PROFILE | PROFILE'}}}

Determines if the given profiles are within a segment.

See also: AWS API Documentation

Request Syntax

client.get_segment_membership(
    DomainName='string',
    SegmentDefinitionName='string',
    ProfileIds=[
        'string',
    ]
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type SegmentDefinitionName:

string

param SegmentDefinitionName:

[REQUIRED]

The Id of the wanted segment. Needs to be a valid, and existing segment Id.

type ProfileIds:

list

param ProfileIds:

[REQUIRED]

The list of profile IDs to query for.

  • (string) --

rtype:

dict

returns:

Response Syntax

{
    'SegmentDefinitionName': 'string',
    'Profiles': [
        {
            'ProfileId': 'string',
            'QueryResult': 'PRESENT'|'ABSENT',
            'Profile': {
                'ProfileId': 'string',
                'AccountNumber': 'string',
                'AdditionalInformation': 'string',
                'PartyType': 'INDIVIDUAL'|'BUSINESS'|'OTHER',
                'BusinessName': 'string',
                'FirstName': 'string',
                'MiddleName': 'string',
                'LastName': 'string',
                'BirthDate': 'string',
                'Gender': 'MALE'|'FEMALE'|'UNSPECIFIED',
                'PhoneNumber': 'string',
                'MobilePhoneNumber': 'string',
                'HomePhoneNumber': 'string',
                'BusinessPhoneNumber': 'string',
                'EmailAddress': 'string',
                'PersonalEmailAddress': 'string',
                'BusinessEmailAddress': 'string',
                'Address': {
                    'Address1': 'string',
                    'Address2': 'string',
                    'Address3': 'string',
                    'Address4': 'string',
                    'City': 'string',
                    'County': 'string',
                    'State': 'string',
                    'Province': 'string',
                    'Country': 'string',
                    'PostalCode': 'string'
                },
                'ShippingAddress': {
                    'Address1': 'string',
                    'Address2': 'string',
                    'Address3': 'string',
                    'Address4': 'string',
                    'City': 'string',
                    'County': 'string',
                    'State': 'string',
                    'Province': 'string',
                    'Country': 'string',
                    'PostalCode': 'string'
                },
                'MailingAddress': {
                    'Address1': 'string',
                    'Address2': 'string',
                    'Address3': 'string',
                    'Address4': 'string',
                    'City': 'string',
                    'County': 'string',
                    'State': 'string',
                    'Province': 'string',
                    'Country': 'string',
                    'PostalCode': 'string'
                },
                'BillingAddress': {
                    'Address1': 'string',
                    'Address2': 'string',
                    'Address3': 'string',
                    'Address4': 'string',
                    'City': 'string',
                    'County': 'string',
                    'State': 'string',
                    'Province': 'string',
                    'Country': 'string',
                    'PostalCode': 'string'
                },
                'Attributes': {
                    'string': 'string'
                },
                'FoundByItems': [
                    {
                        'KeyName': 'string',
                        'Values': [
                            'string',
                        ]
                    },
                ],
                'PartyTypeString': 'string',
                'GenderString': 'string',
                'ProfileType': 'ACCOUNT_PROFILE'|'PROFILE',
                'EngagementPreferences': {
                    'Phone': [
                        {
                            'KeyName': 'string',
                            'KeyValue': 'string',
                            'ProfileId': 'string',
                            'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                        },
                    ],
                    'Email': [
                        {
                            'KeyName': 'string',
                            'KeyValue': 'string',
                            'ProfileId': 'string',
                            'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                        },
                    ]
                }
            }
        },
    ],
    'Failures': [
        {
            'ProfileId': 'string',
            'Message': 'string',
            'Status': 123
        },
    ]
}

Response Structure

  • (dict) --

    • SegmentDefinitionName (string) --

      The unique name of the segment definition.

    • Profiles (list) --

      An array of maps where each contains a response per profile requested.

      • (dict) --

        Object that holds the results for membership.

        • ProfileId (string) --

          The profile id the result belongs to.

        • QueryResult (string) --

          Describes whether the profile was absent or present in the segment.

        • Profile (dict) --

          The standard profile of a customer.

          • ProfileId (string) --

            The unique identifier of a customer profile.

          • AccountNumber (string) --

            An account number that you have assigned to the customer.

          • AdditionalInformation (string) --

            Any additional information relevant to the customer’s profile.

          • PartyType (string) --

            The type of profile used to describe the customer.

          • BusinessName (string) --

            The name of the customer’s business.

          • FirstName (string) --

            The customer’s first name.

          • MiddleName (string) --

            The customer’s middle name.

          • LastName (string) --

            The customer’s last name.

          • BirthDate (string) --

            The customer’s birth date.

          • Gender (string) --

            The gender with which the customer identifies.

          • PhoneNumber (string) --

            The customer's phone number, which has not been specified as a mobile, home, or business number.

          • MobilePhoneNumber (string) --

            The customer’s mobile phone number.

          • HomePhoneNumber (string) --

            The customer’s home phone number.

          • BusinessPhoneNumber (string) --

            The customer’s home phone number.

          • EmailAddress (string) --

            The customer’s email address, which has not been specified as a personal or business address.

          • PersonalEmailAddress (string) --

            The customer’s personal email address.

          • BusinessEmailAddress (string) --

            The customer’s business email address.

          • Address (dict) --

            A generic address associated with the customer that is not mailing, shipping, or billing.

            • Address1 (string) --

              The first line of a customer address.

            • Address2 (string) --

              The second line of a customer address.

            • Address3 (string) --

              The third line of a customer address.

            • Address4 (string) --

              The fourth line of a customer address.

            • City (string) --

              The city in which a customer lives.

            • County (string) --

              The county in which a customer lives.

            • State (string) --

              The state in which a customer lives.

            • Province (string) --

              The province in which a customer lives.

            • Country (string) --

              The country in which a customer lives.

            • PostalCode (string) --

              The postal code of a customer address.

          • ShippingAddress (dict) --

            The customer’s shipping address.

            • Address1 (string) --

              The first line of a customer address.

            • Address2 (string) --

              The second line of a customer address.

            • Address3 (string) --

              The third line of a customer address.

            • Address4 (string) --

              The fourth line of a customer address.

            • City (string) --

              The city in which a customer lives.

            • County (string) --

              The county in which a customer lives.

            • State (string) --

              The state in which a customer lives.

            • Province (string) --

              The province in which a customer lives.

            • Country (string) --

              The country in which a customer lives.

            • PostalCode (string) --

              The postal code of a customer address.

          • MailingAddress (dict) --

            The customer’s mailing address.

            • Address1 (string) --

              The first line of a customer address.

            • Address2 (string) --

              The second line of a customer address.

            • Address3 (string) --

              The third line of a customer address.

            • Address4 (string) --

              The fourth line of a customer address.

            • City (string) --

              The city in which a customer lives.

            • County (string) --

              The county in which a customer lives.

            • State (string) --

              The state in which a customer lives.

            • Province (string) --

              The province in which a customer lives.

            • Country (string) --

              The country in which a customer lives.

            • PostalCode (string) --

              The postal code of a customer address.

          • BillingAddress (dict) --

            The customer’s billing address.

            • Address1 (string) --

              The first line of a customer address.

            • Address2 (string) --

              The second line of a customer address.

            • Address3 (string) --

              The third line of a customer address.

            • Address4 (string) --

              The fourth line of a customer address.

            • City (string) --

              The city in which a customer lives.

            • County (string) --

              The county in which a customer lives.

            • State (string) --

              The state in which a customer lives.

            • Province (string) --

              The province in which a customer lives.

            • Country (string) --

              The country in which a customer lives.

            • PostalCode (string) --

              The postal code of a customer address.

          • Attributes (dict) --

            A key value pair of attributes of a customer profile.

            • (string) --

              • (string) --

          • FoundByItems (list) --

            A list of items used to find a profile returned in a SearchProfiles response. An item is a key-value(s) pair that matches an attribute in the profile.

            If the optional AdditionalSearchKeys parameter was included in the SearchProfiles request, the FoundByItems list should be interpreted based on the LogicalOperator used in the request:

            • AND - The profile included in the response matched all of the search keys specified in the request. The FoundByItems will include all of the key-value(s) pairs that were specified in the request (as this is a requirement of AND search logic).

            • OR - The profile included in the response matched at least one of the search keys specified in the request. The FoundByItems will include each of the key-value(s) pairs that the profile was found by.

            The OR relationship is the default behavior if the LogicalOperator parameter is not included in the SearchProfiles request.

            • (dict) --

              A data type pair that consists of a KeyName and Values list that were used to find a profile returned in response to a SearchProfiles request.

              • KeyName (string) --

                A searchable identifier of a customer profile.

              • Values (list) --

                A list of key values.

                • (string) --

          • PartyTypeString (string) --

            An alternative to PartyType which accepts any string as input.

          • GenderString (string) --

            An alternative to Gender which accepts any string as input.

          • ProfileType (string) --

            The type of the profile.

          • EngagementPreferences (dict) --

            The customer or account’s engagement preferences.

            • Phone (list) --

              A list of phone-related contact preferences

              • (dict) --

                Object that defines users contact preference.

                • KeyName (string) --

                  A searchable, unique identifier of a customer profile.

                • KeyValue (string) --

                  The key value used to look up profile based off the keyName.

                • ProfileId (string) --

                  The unique identifier of a customer profile.

                • ContactType (string) --

                  The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

            • Email (list) --

              A list of email-related contact preferences

              • (dict) --

                Object that defines users contact preference.

                • KeyName (string) --

                  A searchable, unique identifier of a customer profile.

                • KeyValue (string) --

                  The key value used to look up profile based off the keyName.

                • ProfileId (string) --

                  The unique identifier of a customer profile.

                • ContactType (string) --

                  The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

    • Failures (list) --

      An array of maps where each contains a response per profile failed for the request.

      • (dict) --

        Object that holds failures for membership.

        • ProfileId (string) --

          The profile id the failure belongs to.

        • Message (string) --

          A message describing the failure.

        • Status (integer) --

          The status describing the failure.

MergeProfiles (updated) Link ¶
Changes (request)
{'FieldSourceProfileIds': {'EngagementPreferences': 'string',
                           'ProfileType': 'string'}}

Runs an AWS Lambda job that does the following:

  • All the profileKeys in the ProfileToBeMerged will be moved to the main profile.

  • All the objects in the ProfileToBeMerged will be moved to the main profile.

  • All the ProfileToBeMerged will be deleted at the end.

  • All the profileKeys in the ProfileIdsToBeMerged will be moved to the main profile.

  • Standard fields are merged as follows:

    • Fields are always "union"-ed if there are no conflicts in standard fields or attributeKeys.

    • When there are conflicting fields:

      • If no SourceProfileIds entry is specified, the main Profile value is always taken.

      • If a SourceProfileIds entry is specified, the specified profileId is always taken, even if it is a NULL value.

You can use MergeProfiles together with GetMatches, which returns potentially matching profiles, or use it with the results of another matching system. After profiles have been merged, they cannot be separated (unmerged).

See also: AWS API Documentation

Request Syntax

client.merge_profiles(
    DomainName='string',
    MainProfileId='string',
    ProfileIdsToBeMerged=[
        'string',
    ],
    FieldSourceProfileIds={
        'AccountNumber': 'string',
        'AdditionalInformation': 'string',
        'PartyType': 'string',
        'BusinessName': 'string',
        'FirstName': 'string',
        'MiddleName': 'string',
        'LastName': 'string',
        'BirthDate': 'string',
        'Gender': 'string',
        'PhoneNumber': 'string',
        'MobilePhoneNumber': 'string',
        'HomePhoneNumber': 'string',
        'BusinessPhoneNumber': 'string',
        'EmailAddress': 'string',
        'PersonalEmailAddress': 'string',
        'BusinessEmailAddress': 'string',
        'Address': 'string',
        'ShippingAddress': 'string',
        'MailingAddress': 'string',
        'BillingAddress': 'string',
        'Attributes': {
            'string': 'string'
        },
        'ProfileType': 'string',
        'EngagementPreferences': 'string'
    }
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type MainProfileId:

string

param MainProfileId:

[REQUIRED]

The identifier of the profile to be taken.

type ProfileIdsToBeMerged:

list

param ProfileIdsToBeMerged:

[REQUIRED]

The identifier of the profile to be merged into MainProfileId.

  • (string) --

type FieldSourceProfileIds:

dict

param FieldSourceProfileIds:

The identifiers of the fields in the profile that has the information you want to apply to the merge. For example, say you want to merge EmailAddress from Profile1 into MainProfile. This would be the identifier of the EmailAddress field in Profile1.

  • AccountNumber (string) --

    A unique identifier for the account number field to be merged.

  • AdditionalInformation (string) --

    A unique identifier for the additional information field to be merged.

  • PartyType (string) --

    A unique identifier for the party type field to be merged.

  • BusinessName (string) --

    A unique identifier for the business name field to be merged.

  • FirstName (string) --

    A unique identifier for the first name field to be merged.

  • MiddleName (string) --

    A unique identifier for the middle name field to be merged.

  • LastName (string) --

    A unique identifier for the last name field to be merged.

  • BirthDate (string) --

    A unique identifier for the birthdate field to be merged.

  • Gender (string) --

    A unique identifier for the gender field to be merged.

  • PhoneNumber (string) --

    A unique identifier for the phone number field to be merged.

  • MobilePhoneNumber (string) --

    A unique identifier for the mobile phone number field to be merged.

  • HomePhoneNumber (string) --

    A unique identifier for the home phone number field to be merged.

  • BusinessPhoneNumber (string) --

    A unique identifier for the business phone number field to be merged.

  • EmailAddress (string) --

    A unique identifier for the email address field to be merged.

  • PersonalEmailAddress (string) --

    A unique identifier for the personal email address field to be merged.

  • BusinessEmailAddress (string) --

    A unique identifier for the party type field to be merged.

  • Address (string) --

    A unique identifier for the party type field to be merged.

  • ShippingAddress (string) --

    A unique identifier for the shipping address field to be merged.

  • MailingAddress (string) --

    A unique identifier for the mailing address field to be merged.

  • BillingAddress (string) --

    A unique identifier for the billing type field to be merged.

  • Attributes (dict) --

    A unique identifier for the attributes field to be merged.

    • (string) --

      • (string) --

  • ProfileType (string) --

    A unique identifier for the profile type field to be merged.

  • EngagementPreferences (string) --

    A unique identifier for the engagement preferences field to be merged.

rtype:

dict

returns:

Response Syntax

{
    'Message': 'string'
}

Response Structure

  • (dict) --

    • Message (string) --

      A message that indicates the merge request is complete.

SearchProfiles (updated) Link ¶
Changes (response)
{'Items': {'EngagementPreferences': {'Email': [{'ContactType': 'PhoneNumber | '
                                                               'MobilePhoneNumber '
                                                               '| '
                                                               'HomePhoneNumber '
                                                               '| '
                                                               'BusinessPhoneNumber '
                                                               '| EmailAddress '
                                                               '| '
                                                               'PersonalEmailAddress '
                                                               '| '
                                                               'BusinessEmailAddress',
                                                'KeyName': 'string',
                                                'KeyValue': 'string',
                                                'ProfileId': 'string'}],
                                     'Phone': [{'ContactType': 'PhoneNumber | '
                                                               'MobilePhoneNumber '
                                                               '| '
                                                               'HomePhoneNumber '
                                                               '| '
                                                               'BusinessPhoneNumber '
                                                               '| EmailAddress '
                                                               '| '
                                                               'PersonalEmailAddress '
                                                               '| '
                                                               'BusinessEmailAddress',
                                                'KeyName': 'string',
                                                'KeyValue': 'string',
                                                'ProfileId': 'string'}]},
           'ProfileType': 'ACCOUNT_PROFILE | PROFILE'}}

Searches for profiles within a specific domain using one or more predefined search keys (e.g., _fullName, _phone, _email, _account, etc.) and/or custom-defined search keys. A search key is a data type pair that consists of a KeyName and Values list.

This operation supports searching for profiles with a minimum of 1 key-value(s) pair and up to 5 key-value(s) pairs using either AND or OR logic.

See also: AWS API Documentation

Request Syntax

client.search_profiles(
    NextToken='string',
    MaxResults=123,
    DomainName='string',
    KeyName='string',
    Values=[
        'string',
    ],
    AdditionalSearchKeys=[
        {
            'KeyName': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    LogicalOperator='AND'|'OR'
)
type NextToken:

string

param NextToken:

The pagination token from the previous SearchProfiles API call.

type MaxResults:

integer

param MaxResults:

The maximum number of objects returned per page.

The default is 20 if this parameter is not included in the request.

type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type KeyName:

string

param KeyName:

[REQUIRED]

A searchable identifier of a customer profile. The predefined keys you can use to search include: _account, _profileId, _assetId, _caseId, _orderId, _fullName, _phone, _email, _ctrContactId, _marketoLeadId, _salesforceAccountId, _salesforceContactId, _salesforceAssetId, _zendeskUserId, _zendeskExternalId, _zendeskTicketId, _serviceNowSystemId, _serviceNowIncidentId, _segmentUserId, _shopifyCustomerId, _shopifyOrderId.

type Values:

list

param Values:

[REQUIRED]

A list of key values.

  • (string) --

type AdditionalSearchKeys:

list

param AdditionalSearchKeys:

A list of AdditionalSearchKey objects that are each searchable identifiers of a profile. Each AdditionalSearchKey object contains a KeyName and a list of Values associated with that specific key (i.e., a key-value(s) pair). These additional search keys will be used in conjunction with the LogicalOperator and the required KeyName and Values parameters to search for profiles that satisfy the search criteria.

  • (dict) --

    A data type pair that consists of a KeyName and Values list that is used in conjunction with the KeyName and Values parameters to search for profiles using the SearchProfiles API.

    • KeyName (string) -- [REQUIRED]

      A searchable identifier of a customer profile.

    • Values (list) -- [REQUIRED]

      A list of key values.

      • (string) --

type LogicalOperator:

string

param LogicalOperator:

Relationship between all specified search keys that will be used to search for profiles. This includes the required KeyName and Values parameters as well as any key-value(s) pairs specified in the AdditionalSearchKeys list.

This parameter influences which profiles will be returned in the response in the following manner:

  • AND - The response only includes profiles that match all of the search keys.

  • OR - The response includes profiles that match at least one of the search keys.

The OR relationship is the default behavior if this parameter is not included in the request.

rtype:

dict

returns:

Response Syntax

{
    'Items': [
        {
            'ProfileId': 'string',
            'AccountNumber': 'string',
            'AdditionalInformation': 'string',
            'PartyType': 'INDIVIDUAL'|'BUSINESS'|'OTHER',
            'BusinessName': 'string',
            'FirstName': 'string',
            'MiddleName': 'string',
            'LastName': 'string',
            'BirthDate': 'string',
            'Gender': 'MALE'|'FEMALE'|'UNSPECIFIED',
            'PhoneNumber': 'string',
            'MobilePhoneNumber': 'string',
            'HomePhoneNumber': 'string',
            'BusinessPhoneNumber': 'string',
            'EmailAddress': 'string',
            'PersonalEmailAddress': 'string',
            'BusinessEmailAddress': 'string',
            'Address': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'ShippingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'MailingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'BillingAddress': {
                'Address1': 'string',
                'Address2': 'string',
                'Address3': 'string',
                'Address4': 'string',
                'City': 'string',
                'County': 'string',
                'State': 'string',
                'Province': 'string',
                'Country': 'string',
                'PostalCode': 'string'
            },
            'Attributes': {
                'string': 'string'
            },
            'FoundByItems': [
                {
                    'KeyName': 'string',
                    'Values': [
                        'string',
                    ]
                },
            ],
            'PartyTypeString': 'string',
            'GenderString': 'string',
            'ProfileType': 'ACCOUNT_PROFILE'|'PROFILE',
            'EngagementPreferences': {
                'Phone': [
                    {
                        'KeyName': 'string',
                        'KeyValue': 'string',
                        'ProfileId': 'string',
                        'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                    },
                ],
                'Email': [
                    {
                        'KeyName': 'string',
                        'KeyValue': 'string',
                        'ProfileId': 'string',
                        'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
                    },
                ]
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Items (list) --

      The list of Profiles matching the search criteria.

      • (dict) --

        The standard profile of a customer.

        • ProfileId (string) --

          The unique identifier of a customer profile.

        • AccountNumber (string) --

          An account number that you have assigned to the customer.

        • AdditionalInformation (string) --

          Any additional information relevant to the customer’s profile.

        • PartyType (string) --

          The type of profile used to describe the customer.

        • BusinessName (string) --

          The name of the customer’s business.

        • FirstName (string) --

          The customer’s first name.

        • MiddleName (string) --

          The customer’s middle name.

        • LastName (string) --

          The customer’s last name.

        • BirthDate (string) --

          The customer’s birth date.

        • Gender (string) --

          The gender with which the customer identifies.

        • PhoneNumber (string) --

          The customer's phone number, which has not been specified as a mobile, home, or business number.

        • MobilePhoneNumber (string) --

          The customer’s mobile phone number.

        • HomePhoneNumber (string) --

          The customer’s home phone number.

        • BusinessPhoneNumber (string) --

          The customer’s home phone number.

        • EmailAddress (string) --

          The customer’s email address, which has not been specified as a personal or business address.

        • PersonalEmailAddress (string) --

          The customer’s personal email address.

        • BusinessEmailAddress (string) --

          The customer’s business email address.

        • Address (dict) --

          A generic address associated with the customer that is not mailing, shipping, or billing.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • ShippingAddress (dict) --

          The customer’s shipping address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • MailingAddress (dict) --

          The customer’s mailing address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • BillingAddress (dict) --

          The customer’s billing address.

          • Address1 (string) --

            The first line of a customer address.

          • Address2 (string) --

            The second line of a customer address.

          • Address3 (string) --

            The third line of a customer address.

          • Address4 (string) --

            The fourth line of a customer address.

          • City (string) --

            The city in which a customer lives.

          • County (string) --

            The county in which a customer lives.

          • State (string) --

            The state in which a customer lives.

          • Province (string) --

            The province in which a customer lives.

          • Country (string) --

            The country in which a customer lives.

          • PostalCode (string) --

            The postal code of a customer address.

        • Attributes (dict) --

          A key value pair of attributes of a customer profile.

          • (string) --

            • (string) --

        • FoundByItems (list) --

          A list of items used to find a profile returned in a SearchProfiles response. An item is a key-value(s) pair that matches an attribute in the profile.

          If the optional AdditionalSearchKeys parameter was included in the SearchProfiles request, the FoundByItems list should be interpreted based on the LogicalOperator used in the request:

          • AND - The profile included in the response matched all of the search keys specified in the request. The FoundByItems will include all of the key-value(s) pairs that were specified in the request (as this is a requirement of AND search logic).

          • OR - The profile included in the response matched at least one of the search keys specified in the request. The FoundByItems will include each of the key-value(s) pairs that the profile was found by.

          The OR relationship is the default behavior if the LogicalOperator parameter is not included in the SearchProfiles request.

          • (dict) --

            A data type pair that consists of a KeyName and Values list that were used to find a profile returned in response to a SearchProfiles request.

            • KeyName (string) --

              A searchable identifier of a customer profile.

            • Values (list) --

              A list of key values.

              • (string) --

        • PartyTypeString (string) --

          An alternative to PartyType which accepts any string as input.

        • GenderString (string) --

          An alternative to Gender which accepts any string as input.

        • ProfileType (string) --

          The type of the profile.

        • EngagementPreferences (dict) --

          The customer or account’s engagement preferences.

          • Phone (list) --

            A list of phone-related contact preferences

            • (dict) --

              Object that defines users contact preference.

              • KeyName (string) --

                A searchable, unique identifier of a customer profile.

              • KeyValue (string) --

                The key value used to look up profile based off the keyName.

              • ProfileId (string) --

                The unique identifier of a customer profile.

              • ContactType (string) --

                The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

          • Email (list) --

            A list of email-related contact preferences

            • (dict) --

              Object that defines users contact preference.

              • KeyName (string) --

                A searchable, unique identifier of a customer profile.

              • KeyValue (string) --

                The key value used to look up profile based off the keyName.

              • ProfileId (string) --

                The unique identifier of a customer profile.

              • ContactType (string) --

                The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

    • NextToken (string) --

      The pagination token from the previous SearchProfiles API call.

UpdateProfile (updated) Link ¶
Changes (request)
{'EngagementPreferences': {'Email': [{'ContactType': 'PhoneNumber | '
                                                     'MobilePhoneNumber | '
                                                     'HomePhoneNumber | '
                                                     'BusinessPhoneNumber | '
                                                     'EmailAddress | '
                                                     'PersonalEmailAddress | '
                                                     'BusinessEmailAddress',
                                      'KeyName': 'string',
                                      'KeyValue': 'string',
                                      'ProfileId': 'string'}],
                           'Phone': [{'ContactType': 'PhoneNumber | '
                                                     'MobilePhoneNumber | '
                                                     'HomePhoneNumber | '
                                                     'BusinessPhoneNumber | '
                                                     'EmailAddress | '
                                                     'PersonalEmailAddress | '
                                                     'BusinessEmailAddress',
                                      'KeyName': 'string',
                                      'KeyValue': 'string',
                                      'ProfileId': 'string'}]},
 'ProfileType': 'ACCOUNT_PROFILE | PROFILE'}

Updates the properties of a profile. The ProfileId is required for updating a customer profile.

When calling the UpdateProfile API, specifying an empty string value means that any existing value will be removed. Not specifying a string value means that any value already there will be kept.

See also: AWS API Documentation

Request Syntax

client.update_profile(
    DomainName='string',
    ProfileId='string',
    AdditionalInformation='string',
    AccountNumber='string',
    PartyType='INDIVIDUAL'|'BUSINESS'|'OTHER',
    BusinessName='string',
    FirstName='string',
    MiddleName='string',
    LastName='string',
    BirthDate='string',
    Gender='MALE'|'FEMALE'|'UNSPECIFIED',
    PhoneNumber='string',
    MobilePhoneNumber='string',
    HomePhoneNumber='string',
    BusinessPhoneNumber='string',
    EmailAddress='string',
    PersonalEmailAddress='string',
    BusinessEmailAddress='string',
    Address={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    ShippingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    MailingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    BillingAddress={
        'Address1': 'string',
        'Address2': 'string',
        'Address3': 'string',
        'Address4': 'string',
        'City': 'string',
        'County': 'string',
        'State': 'string',
        'Province': 'string',
        'Country': 'string',
        'PostalCode': 'string'
    },
    Attributes={
        'string': 'string'
    },
    PartyTypeString='string',
    GenderString='string',
    ProfileType='ACCOUNT_PROFILE'|'PROFILE',
    EngagementPreferences={
        'Phone': [
            {
                'KeyName': 'string',
                'KeyValue': 'string',
                'ProfileId': 'string',
                'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
            },
        ],
        'Email': [
            {
                'KeyName': 'string',
                'KeyValue': 'string',
                'ProfileId': 'string',
                'ContactType': 'PhoneNumber'|'MobilePhoneNumber'|'HomePhoneNumber'|'BusinessPhoneNumber'|'EmailAddress'|'PersonalEmailAddress'|'BusinessEmailAddress'
            },
        ]
    }
)
type DomainName:

string

param DomainName:

[REQUIRED]

The unique name of the domain.

type ProfileId:

string

param ProfileId:

[REQUIRED]

The unique identifier of a customer profile.

type AdditionalInformation:

string

param AdditionalInformation:

Any additional information relevant to the customer’s profile.

type AccountNumber:

string

param AccountNumber:

An account number that you have assigned to the customer.

type PartyType:

string

param PartyType:

The type of profile used to describe the customer.

type BusinessName:

string

param BusinessName:

The name of the customer’s business.

type FirstName:

string

param FirstName:

The customer’s first name.

type MiddleName:

string

param MiddleName:

The customer’s middle name.

type LastName:

string

param LastName:

The customer’s last name.

type BirthDate:

string

param BirthDate:

The customer’s birth date.

type Gender:

string

param Gender:

The gender with which the customer identifies.

type PhoneNumber:

string

param PhoneNumber:

The customer’s phone number, which has not been specified as a mobile, home, or business number.

type MobilePhoneNumber:

string

param MobilePhoneNumber:

The customer’s mobile phone number.

type HomePhoneNumber:

string

param HomePhoneNumber:

The customer’s home phone number.

type BusinessPhoneNumber:

string

param BusinessPhoneNumber:

The customer’s business phone number.

type EmailAddress:

string

param EmailAddress:

The customer’s email address, which has not been specified as a personal or business address.

type PersonalEmailAddress:

string

param PersonalEmailAddress:

The customer’s personal email address.

type BusinessEmailAddress:

string

param BusinessEmailAddress:

The customer’s business email address.

type Address:

dict

param Address:

A generic address associated with the customer that is not mailing, shipping, or billing.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type ShippingAddress:

dict

param ShippingAddress:

The customer’s shipping address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type MailingAddress:

dict

param MailingAddress:

The customer’s mailing address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type BillingAddress:

dict

param BillingAddress:

The customer’s billing address.

  • Address1 (string) --

    The first line of a customer address.

  • Address2 (string) --

    The second line of a customer address.

  • Address3 (string) --

    The third line of a customer address.

  • Address4 (string) --

    The fourth line of a customer address.

  • City (string) --

    The city in which a customer lives.

  • County (string) --

    The county in which a customer lives.

  • State (string) --

    The state in which a customer lives.

  • Province (string) --

    The province in which a customer lives.

  • Country (string) --

    The country in which a customer lives.

  • PostalCode (string) --

    The postal code of a customer address.

type Attributes:

dict

param Attributes:

A key value pair of attributes of a customer profile.

  • (string) --

    • (string) --

type PartyTypeString:

string

param PartyTypeString:

An alternative to PartyType which accepts any string as input.

type GenderString:

string

param GenderString:

An alternative to Gender which accepts any string as input.

type ProfileType:

string

param ProfileType:

Determines the type of the profile.

type EngagementPreferences:

dict

param EngagementPreferences:

Object that defines users preferred methods of engagement.

  • Phone (list) --

    A list of phone-related contact preferences

    • (dict) --

      Object that defines users contact preference.

      • KeyName (string) --

        A searchable, unique identifier of a customer profile.

      • KeyValue (string) --

        The key value used to look up profile based off the keyName.

      • ProfileId (string) --

        The unique identifier of a customer profile.

      • ContactType (string) --

        The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

  • Email (list) --

    A list of email-related contact preferences

    • (dict) --

      Object that defines users contact preference.

      • KeyName (string) --

        A searchable, unique identifier of a customer profile.

      • KeyValue (string) --

        The key value used to look up profile based off the keyName.

      • ProfileId (string) --

        The unique identifier of a customer profile.

      • ContactType (string) --

        The contact type used for engagement. For example: HomePhoneNumber, PersonalEmailAddress.

rtype:

dict

returns:

Response Syntax

{
    'ProfileId': 'string'
}

Response Structure

  • (dict) --

    • ProfileId (string) --

      The unique identifier of a customer profile.