Receiving Click and Cost Data via HTTP Requests

This page outlines how vendors can receive Snagajob click and cost data for Apply Now button click events via an API endpoint.

Overview

Partners can include a <TrackingUrl> element in their XML feed (must be HTTPS) for each posting they would like to receive event details for. When a Worker clicks the ‘Apply Now’ button on snagajob.com, Snagajob will perform an HTTP GET request to the URL appending these query string parameters.

Snagajob will carry forward any existing path and query string parameters provided in the original URL

• timestamp

• eventId

• clickCost

• ipAddress

Query String Parameter Descriptions

Name	Description	Example
timestamp	The click event time represented as an Epoch Unix Timestamp. All clicks are recorded in Eastern Time.	10111000
eventId	The unique id for the click event.	78dbe8d7-bc12-42ba-97d8-6f7236bbb009
clickCost	The cost per click that the posting was bidding at the time of the event.	22
ipAddress	The IP Address of the user who generated the click event	1.1.1.1.1

Example Tracking URL

<TrackingUrl>https://myapplicantapi.com/where-clicks-should-go</TrackingUrl>

Example XML Containing the <TrackingUrl>

<?xml version='1.0' encoding='UTF-8'?>
<Postings>
    <Item>
        </Brand>
        </Job_Title>
        </Employment_Type>
        </Wage>
        </Location_Name>
        </Address_Line_1>
        </City>
        </State>
        </Zip>
        </Rate>
        </Job_Description>
        </Primary_Industry>
        </URL>
        </External_Posting_ID>
        </Location_Number>
        </PostUrl>
        </ScreeningQuestionsUrl>
        <TrackingUrl><![CDATA[https://myapplicantapi.com/where-clicks-should-go]]></TrackingUrl>
    </Item>
</Postings>

See: XML Examples for a complete XML sample

Example Request

Snagajob's Sample Request for Sending Click Data

GET https://myapplicantapi.com/where-clicks-should-go

Query Parameters

Name	Type	Description
timestamp*	String	The click event time represented as an Epoch Unix Timestamp. All clicks are recorded in Eastern Time.
eventId*	String	The unique id for the click event.
clickCost*	String	The cost per click that the posting was bidding at the time of the event.
ipAddress*	String	The IP Address of the user who generated the click event

Example Url: https://myapplicantapi.com/where-clicks-should-go?eventId=78dbe8d7-bc12-42ba-97d8-6f7236bbb009&timestamp=10111000&clickCost=22&ipAddress=1.1.1.1.1