Difference between revisions of "ATC/Current/SDK/Identify"

From Genesys Documentation
Jump to: navigation, search
(Published)
 
(10 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
|Standalone=No
 
|Standalone=No
 
|DisplayName=identify
 
|DisplayName=identify
−
|Platform=PureEngage, PureConnect, PureCloud
 
 
|TocName=identify
 
|TocName=identify
−
|Context=The <tt>identify</tt> method adds information to a customer.
+
|Context=Learn how to use the <tt>identify</tt> method to add information to a customer record.
 +
|Dimension=DevTracking
 +
|ComingSoon=No
 +
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
 
|Section={{Section
 
|Section={{Section
 +
|alignment=Vertical
 +
|structuredtext={{NoteFormat|On January 31, 2023, Genesys removed the functionality of the identify method that is used to add a customer record. For more information, see [https://rcstaging.wpengine.com/articles/deprecation-identify-journey-sdk-method/ Deprecation: identify journey SDK method].|}}{{NoteFormat|1=This article only applies to customers using {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_chats|display text=web chat}}. If you are a Genesys Cloud CX customer, we encourage you to use the new {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_messaging|display text=web messaging}} feature to replace web chat.|2=}}<br />
 +
|Status=No
 +
}}{{Section
 
|sectionHeading=Description
 
|sectionHeading=Description
−
|Type=Structured
 
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=The <tt>identify</tt> method adds information to a customer record.  
−
|structuredtext=The <tt>identify</tt> method adds information to a customer.
+
 
−
|fullwidth=No
+
{{NoteFormat|<tt>identify</tt> affects the next web event sent using the <tt>{{Link-SomewhereInThisVersion|manual=SDK|topic=Pageview}}</tt> or <tt>{{Link-SomewhereInThisVersion|manual=SDK|topic=Record}}</tt> method.|}}
 +
|Status=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Signature
 
|sectionHeading=Signature
−
|Type=Structured
 
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
 
 
|structuredtext=<tt>ac('identify', [loginId], [traits], [callback])</tt>
 
|structuredtext=<tt>ac('identify', [loginId], [traits], [callback])</tt>
−
|fullwidth=No
+
|Status=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Arguments
 
|sectionHeading=Arguments
−
|Type=Structured
 
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=*[[#loginID|loginId]]
−
|structuredtext=* [[#loginID|loginId]]
+
*[[#traits|traits]]
−
* [[#traits|traits]]
+
*[[#callback|callback]]
−
* [[#callback|callback]]
+
|Status=No
−
|fullwidth=No
 
 
}}{{Section
 
}}{{Section
 
|sectionHeading=login
 
|sectionHeading=login
−
|Type=Structured
 
 
|anchor=login
 
|anchor=login
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=*'''Description:''' ID used to stitch customer identities together
−
|structuredtext=* Description: an Id that can be used to stitch customer identities together
+
*'''Type:''' String/null
−
* Type: string/null
+
*'''Status:''' Required
−
* Status: required
+
*'''Note:''' If loginId is null, the current identity is cleared.
−
* Note: If loginId is null, the current identity will be cleared.
+
|Status=No
−
|fullwidth=No
 
 
}}{{Section
 
}}{{Section
 
|sectionHeading=traits
 
|sectionHeading=traits
−
|Type=Structured
 
 
|anchor=traits
 
|anchor=traits
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=*'''Description:''' Information about a customer
−
|structuredtext=* Description: information about a customer
+
*'''Type:''' Object
−
* Type: object
+
*'''Status:''' Optional
−
* Status: optional
+
*'''Restrictions:''' Flat object with properties of type string, number, or Boolean
−
* Restrictions: A flat object with properties of type string, number, or boolean
+
 
−
|fullwidth=No
+
For more information about how to link different customer records, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Traits_mapper|display text=Traits mapper.}}
 +
|Status=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=callback
 
|sectionHeading=callback
−
|Type=Structured
 
 
|anchor=callback
 
|anchor=callback
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=*'''Description:''' Callback
−
|structuredtext=* Description: callback
+
*'''Type:''' Function
−
* Type: function
+
*'''Status:''' Optional
−
* Status: optional
+
|Status=No
−
|fullwidth=No
 
 
}}
 
}}
 
}}
 
}}

Latest revision as of 07:15, February 3, 2023

This topic is part of the manual Journey JavaScript SDK for version Current of Genesys Predictive Engagement.

Learn how to use the identify method to add information to a customer record.

Important
On January 31, 2023, Genesys removed the functionality of the identify method that is used to add a customer record. For more information, see Deprecation: identify journey SDK method.
Important
This article only applies to customers using web chat. If you are a Genesys Cloud CX customer, we encourage you to use the new web messaging feature to replace web chat.

Description

The identify method adds information to a customer record.

Important
identify affects the next web event sent using the pageview or record method.

Signature

ac('identify', [loginId], [traits], [callback])

Arguments

login

  • Description: ID used to stitch customer identities together
  • Type: String/null
  • Status: Required
  • Note: If loginId is null, the current identity is cleared.

traits

  • Description: Information about a customer
  • Type: Object
  • Status: Optional
  • Restrictions: Flat object with properties of type string, number, or Boolean

For more information about how to link different customer records, see Traits mapper.

callback

  • Description: Callback
  • Type: Function
  • Status: Optional
Retrieved from "https://all.docs.genesys.com/ATC/Current/SDK/Identify (2025-07-26 12:43:36)"
Comments or questions about this documentation? Contact us for support!