TikTok Pixel Integration

TikTok Pixel Integration

TikTok Pixel is a conversion tracking tool for TikTok ads. It allows optimizing campaigns for purchases, registrations, and other target actions on your site.

Basic Code Installation

<script>
!function (w, d, t) {
    w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];ttq.methods=["page","track","identify",
    "instances","debug","on","off","once","ready","alias","group","enableCookie","disableCookie"],
    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]);
    ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;n<ttq.methods.length;n++)
    ttq.setAndDefer(e,ttq.methods[n]);return e},ttq.load=function(e,n){
    var i="https://analytics.tiktok.com/i18n/pixel/events.js";
    ttq._i=ttq._i||{},ttq._i[e]=[],ttq._i[e]._u=i,ttq._t=ttq._t||{},ttq._t[e]=+new Date,
    ttq._o=ttq._o||{},ttq._o[e]=n||{};var o=document.createElement("script");
    o.type="text/javascript",o.async=!0,o.src=i+"?sdkid="+e+"&lib="+t;
    var a=document.getElementsByTagName("script")[0];a.parentNode.insertBefore(o,a)};
    ttq.load('PIXEL_ID');ttq.page();
}(window, document, 'ttq');
</script>

Standard Events

// View product
ttq.track('ViewContent', {
    contents: [{ content_id: productId, content_name: productName }],
    value: product.price,
    currency: 'RUB'
});

// Purchase
ttq.track('CompletePayment', {
    contents: orderItems.map(i => ({ content_id: i.productId, quantity: i.qty, price: i.price })),
    value:    orderTotal,
    currency: 'RUB',
    order_id: orderId
});

// Registration
ttq.track('CompleteRegistration', { value: 0, currency: 'RUB' });

User Identification

// Send data for advanced matching
ttq.identify({
    sha256_email: sha256(user.email.toLowerCase()),
    sha256_phone_number: sha256(normalizePhone(user.phone))
});

Events API (Server Pixel)

Http::withToken(env('TIKTOK_ACCESS_TOKEN'))
    ->post('https://business-api.tiktok.com/open_api/v1.3/event/track/', [
        'pixel_code' => env('TIKTOK_PIXEL_ID'),
        'event'      => 'CompletePayment',
        'timestamp'  => time(),
        'context'    => [
            'user' => [
                'sha256_email' => hash('sha256', strtolower($user->email)),
                'sha256_phone' => hash('sha256', normalizePhone($user->phone))
            ],
            'page' => ['url' => $pageUrl]
        ],
        'properties' => [
            'contents'  => $itemsArray,
            'value'     => $total / 100,
            'currency'  => 'RUB'
        ],
        'event_id' => "purchase_{$orderId}"
    ]);

Setup time: a few hours.