Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Adding to a segment

Getting the category list

Method Objective

The method allows adding the current user to a segmentgetting information for all active NPS categories.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segmentnps", "addcategories", paramssuccess, error);

NameTypeRequirementDescription
params
success
Object
Functionrequired
Object with request parameters.
Request parameters
The callback function that takes the API response. The API response type is an Object array.
errorFunctionoptionallyThe callback function in case of an error - any non 200 HTTP response.

API response

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" });
NPS Category ID. 
codestringThe unique code of the NPS category.
namestring

The name of the NPS category.

promoter_questionstringThe question is for the "Promoter" user type.
promoter_successstringThanks-message for the "Promoter" user type.
passive_questionstringThe question is for the "Passive" user type.
passive_successstringThanks-message for the "Passive" user type.
detractor_questionstringThe question is for the "Detractor" user type.
detractor_successstringThanks-message for the "Detractor" user type.

Example of use

Code Block
languagejs
themeFadeToGrey
personaclick("segmentnps", "addcategories", function(categories) {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com"
});
Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add",// NPS widget rendering
}, function(error) {
    "segment_id": 100500,
    "phone": "+10000000000"
});
Code Block
languagejs
themeFadeToGrey
personaclick("segment", "add", {"segment_id": 100500});

Removing from a segment

// when something went wrong
});


Getting the channel list

Method Objective

The method allows excluding the current user from a segmentgetting information for all active NPS channels.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segmentnps", "removechannels", paramssuccess, error);


NameTypeRequirementDescription
params
success
Object
Functionrequired
Object with request parameters.
Request parameters
The callback function that takes the API response. The API response type is an Object array.
errorFunctionoptionallyThe callback function in case of an error - any non 200 HTTP response.

API response

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
NPS Channel ID. 
codestringThe unique code of the NPS channel.
namestring

The name of the NPS channel.

Example of use

Code Block
languagejs
themeFadeToGrey
personaclick("segmentnps", "removechannels", {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com",
    "phone": "+10000000000"
});
Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", function(channels) {
    "segment_id": 100500,
    "email": "john.doe@examplestore.com"
});
Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove",// using available NPS channels
}, function(error) {
    "segment_id": 100500,
    "phone": "+10000000000"
});
Code Block
languagejs
themeFadeToGrey
personaclick("segment", "remove", {"segment_id": 100500});
Getting the segment list
// when something went wrong
});



Saving the NPS review

Method Objective

The method allows getting a list of segments that include the current usersaving the results of the NPS survey.

Syntax and parameters

Code Block
languagejs
themeFadeToGrey
personaclick("segmentnps", "get"review", params, success, callbackerror);

NameTypeRequirementDescription
callback
params
Function
ObjectrequiredObject with request parameters.
API response
successFunctionrequiredThe callback function will be executed if the request is successful.
errorFunctionoptionallyThe callback function in case of an error - any non 200 HTTP response.

Request parameters

Name

Type
DescriptionObject 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.
    Requirement

    Description

    channel

    stringrequired

    The NPS channel code.

    categorystringrequiredThe NPS category code.
    ratenumberrequired

    The rating got from the user.

    Note

    The value must be an integer between 1 and 10.


    commentstringoptionallyUser comment.

    Example of use

    Code Block
    languagejs
    themeFadeToGrey
    personaclick("segmentnps", "get", function(segments) {
        segments.forEach(function(segment"review", {
        channel: "website",
        category: "delivery",
        rate: 9,
        comment: "It's not bad, but it could be better."
    }, function() {
        // when the  console.log(segment.id);
        survey is successfully saved
    }, function(error) {
       console.log(segment.type);
        }); // when something went wrong
    });
    



    Column

    Page Navigation

    Table of Contents
    maxLevel2

    classpersonaclick-fixed-position

    indent0px
    stylenone




    Related Pages

    Filter by label (Content by label)
    showLabelsfalse
    showSpacefalse
    sorttitle
    cqllabel = "nps"