Versions Compared

Key

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

Adding to a segment

Method Objective

The method allows adding the current user to a segment.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", params);

NameTypeRequirementDescription
paramsObjectrequiredObject with request parameters.

Request parameters

NameTypeRequirementDescription
segment_idnumber/stringrequiredSegment ID. It's available in the PersonaClick account: CRM > Segments.
emailstringoptionallyThe current user's Email.
phonestringoptionally

The current user's Phone.

Examples of use

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com",
    "phone": "+10000000000"
});

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com"
});

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", {
    "segment_id": 100500,
    "phone": "+10000000000"
});

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", {"segment_id": 100500});



Removing from a segment

Method Objective

The method allows excluding the current user from a segment.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", params);


NameTypeRequirementDescription
paramsObjectrequiredObject with request parameters.

Request parameters

NameTypeRequirementDescription
segment_idnumber/stringrequiredSegment ID. It's available in the PersonaClick account: CRM > Segments.
emailstringoptionallyThe current user's Email.
phonestringoptionally

The current user's Phone.

Examples of use

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com",
    "phone": "+10000000000"
});


Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com"
});


Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", {
    "segment_id": 100500,
    "phone": "+10000000000"
});


Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", {"segment_id": 100500});




Getting the segments list

Method Objective

The method allows getting a list of segments that include the current user.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "get", callback);


NameTypeRequirementDescription
callbackFunctionrequiredObject with request parameters.

API response

TypeValue
Object array

Object array, each will have the following properties:

  • id (number) - the Segment ID.
  • type (string) - the Segment Type. It can have the following values: static, dynamic.

Examples of use

Code Block
languagejs
themeFadeToGrey
personaclick("segment", "get", function(segments) {
    segments.forEach(function(segment) {
        console.log(segment.id);
        console.log(segment.type);
    });
});


Table of Contents
maxLevel2
classpersonaclick-fixed-position