The jobiqo AIR tracking API is designed to collect job views and conversions (apply start) of traffic generated via jobiqo AIR. The integration enables real-time monitoring and optimizations of the AIR campaigns. The integration is straightforward and can be done in Google Tag Manager (GTM).
The API supports following events:
- Job View: the user lands on the job landing page
- Job Apply Start: the user clicks the “Apply” button
For every event we need a corresponding GTM Tag & Trigger.
Job View
Any traffic generated from Jobiqo AIR can be identified via GET parameters in the URL on the job detail page. Such URLs usually look like e.g.:
https://example.com/job-20725?air_campaign_id=123&utm_campaign=jobiqo
-air&utm_source=Talent&utm_medium=aggregator
To identify AIR traffic, we can rely on utm_campaign=jobiqo-air.
To fire the “Job View” event, create a new GTM trigger first. This trigger needs to have two conditions:
- Page URL represents the job landing page (e.g. in our case Page URL contains “/job/”, but this can be different from system to system)
- Page URL contains “jobiqo-air”
In a second step, create a new GTM Tag using “Custom HTML” that fires based on the trigger above:
Insert following code:
<script>
fetch("https://air.jobiqo.com/campaign-tracking", {
method: "POST",
body: JSON.stringify({
event_type: "view",
session_id: "static",
url: "{{Page URL}}",
}),
headers: {
"Content-type": "application/json; charset=UTF-8"
}
});
</script>
Job Apply Start
To fire the “Job Apply Start” event, follow the same steps as for the “Job View” event. Create a new trigger for following conditions:
- A User presses the “Apply” button (Button text and condition can vary from system to system, this is just a very common example)
- Page URL contains “jobiqo-air”
In a second step, create a new GTM Tag using “Custom HTML” that fires based on the trigger above with following code:
<script>
fetch("https://air.jobiqo.com/campaign-tracking", {
method: "POST",
body: JSON.stringify({
event_type: "apply",
session_id: "static",
url: "{{Page URL}}",
}),
headers: {
"Content-type": "application/json; charset=UTF-8"
}
});
</script>