Authentication required

API Key

Parameters

Required

site_token Site Token. This is available in the Settings and will be something like GSN-1234567-X
visitor_id The ID of the visitor to whom the tag is being assigned
tag The tag to assign to the visitor, or leave empty to remove tag

Optional

persistent Setting this to "yes" will make the visitor's tag persist across browsing sessions. Defaults to "no"

Returns

Data object containing keys:

Key Type Description
status String Status of the tagging operation. Either tag_set or tag_removed, depending on context
tag String The tag assigned to the visitor, or empty if the tag has been removed

Example Usage

http://api.gosquared.com/tagging.xml?api_key=API_KEY&site_token=GSN-1234567-X&visitor_id=12345&tag=Somebody

Example Output

<?xml version="1.0" encoding="UTF-8"?>
<data>
	<status>tag_set</status>
	<tag>Somebody</tag>
</data>
Last modified: 3 April 2012 12:16