Configuração no Gestor de Eventos do TikTok #
- Inicie sessão no seu gestor de eventos do TikTok.
- Clique em + para ligar uma nova fonte de dados.

- Selecione a opção “Web” e clique em “Seguinte”.
- Escolha a configuração manual se pretender instalar o código do pixel por conta própria.

- No que diz respeito ao método de ligação, selecione a opção “Tiktok Pixel + Events API”.

- Indique um nome para o seu pixel.

- Instale o código base na sua página de destino (dentro de ).

- Siga os passos para configurar eventos como o carregamento da página e o clique. Também pode configurá-los mais tarde, assim que a sua página de destino estiver pronta. No Passo 7, guarde o seu ID do Pixel e gere um token de acesso para configuração posterior.

Instalação do código da página de destino #
- Siga o nosso código de exemplo e basta alterar o seu ID do pixel. Por favor, inclua a parte relativa ao pixel do TikTok em e substitua CVQT4GJC77U89V958HM0 pelo seu próprio ID do pixel.
JavaScript
<head>
<!-- TikTok Pixel Code Start -->
<script>
!(function (w, d, t) {
w.TiktokAnalyticsObject = t;
var ttq = (w[t] = w[t] || []);
// Define available methods
ttq.methods = [
"page", "track", "identify", "instances", "debug",
"on", "off", "once", "ready", "alias", "group",
"enableCookie", "disableCookie",
"holdConsent", "revokeConsent", "grantConsent",
];
// Defer method calls until SDK loads
ttq.setAndDefer = function (t, e) {
t[e] = function () {
t.push([e].concat(Array.prototype.slice.call(arguments, 0)));
};
};
for (var i = 0; i < ttq.methods.length; i++) {
ttq.setAndDefer(ttq, ttq.methods[i]);
}
// Create pixel instance
ttq.instance = function (t) {
var e = ttq._i[t] || [];
for (var n = 0; n < ttq.methods.length; n++) {
ttq.setAndDefer(e, ttq.methods[n]);
}
return e;
};
// Load the TikTok pixel SDK
ttq.load = function (e, n) {
var r = "https://analytics.tiktok.com/i18n/pixel/events.js";
var o = n && n.partner;
ttq._i = ttq._i || {};
ttq._i[e] = [];
ttq._i[e]._u = r;
ttq._t = ttq._t || {};
ttq._t[e] = +new Date();
ttq._o = ttq._o || {};
ttq._o[e] = n || {};
// Inject script tag
var script = document.createElement("script");
script.type = "text/javascript";
script.async = true;
script.src = r + "?sdkid=" + e + "&lib=" + t;
var firstScript = document.getElementsByTagName("script")[0];
firstScript.parentNode.insertBefore(script, firstScript);
};
// Initialize with pixel ID and fire page view
ttq.load("CVQT4GJC77U89V958HM0");
ttq.page();
})(window, document, "ttq");
</script>
<!-- TikTok Pixel Code End -->
</head>Por favor, inclua o trecho abaixo no corpo do seu código HTML; pode editá-lo conforme necessário.
JavaScript
<script>
// Capture URL Parameters
const urlParams = new URLSearchParams(window.location.search);
let ttclid = urlParams.get("ttclid") || "";
let campaign_id = urlParams.get("campaign_id") || "";
let campaign_name = urlParams.get("campaign_name") || "";
let creative_name = urlParams.get("creative_name") || "";
// Function to Handle Download Button Click
function handleDownloadClick() {
let trackingURL =
`https://track.tenjin.com/v0/click/NBoIGJFsXn8oGtlVqtcaL` +
`?tenjin_parameter_1=${ttclid}` +
`&redirect=false`;
let downloadURL = "https://kudoocat.com/puzzlegame.apk";
// Step 1: Send tracking request silently (no page redirection)
fetch(trackingURL, { method: "GET", mode: "no-cors" })
.then(() => {
console.log("Tracking sent successfully.");
})
.catch(() => {
console.log("Tracking request failed.");
});
// Step 2: Directly trigger file download
window.location.href = downloadURL;
}
// Prevent iOS Double-Tap Zoom
let lastTouchEnd = 0;
document.addEventListener(
"touchend",
function (event) {
const now = Date.now();
if (now - lastTouchEnd <= 300) {
event.preventDefault();
}
lastTouchEnd = now;
},
false
);
// Prevent Multi-Touch Gestures
document.addEventListener(
"touchstart",
function (e) {
if (e.touches.length > 1) {
e.preventDefault();
}
},
{ passive: false }
);
</script>No que diz respeito ao URL de rastreamento, por favor, obtenha o seu próprio URL de rastreamento na Tenjin (consulte as instruções de configuração da Tenjin abaixo).
Configuração no painel do Tenjin #
- Adicione o canal do TikTok Web-to-App no painel do Tenjin.
- Gere um URL de rastreamento na página da campanha; o URL de rastreamento deve ser implementado na sua página de destino:
https://track.tenjin.com/v0/click/NBoIGJFsXn8oGtlVqtcaL?click_id=${ttclid}&redirect=false - Ative o callback de instalação da aplicação a partir do site do TikTok.
