Safari ITP Fix & External ID সেটআপ গাইড
BonicBD Enterprise সার্ভারের সাথে আপনার ট্র্যাকিং সেটআপ ইন্টিগ্রেট করার পূর্ণাঙ্গ গাইডলাইন। এই সেটআপটি অ্যাপল ডিভাইসে (Safari ITP) ডাটা রিটেনশন বাড়াবে এবং ফেসবুকে আপনার Event Match Quality (EMQ) স্কোর বুস্ট করবে।
ধাপ ১: Cookie Extender ট্যাগ তৈরি করা (Web GTM)
প্রথমে একটি স্ক্রিপ্ট বসাতে হবে যা আমাদের সার্ভারের সাথে কানেক্ট করে ব্রাউজারে একটি পার্মানেন্ট কুকি (bbd_uid) সেট করবে।
- আপনার Web GTM Container-এ যান।
- Tags > New > Tag Configuration-এ ক্লিক করুন।
- Custom HTML সিলেক্ট করুন।
- নিচের কোডটি কপি করে পেস্ট করুন:
HTML / JavaScript
<script>
(function() {
// Check if fetch API exists
if (typeof window !== 'undefined' && window.fetch) {
// ⚠️ গুরত্বপূর্ণ: নিচের লিংকে 'ts.yourdomain.com' এর জায়গায় আপনার ট্র্যাকিং ডোমেইন দিন
var trackerUrl = 'https://ts.yourdomain.com/ping';
try {
fetch(trackerUrl, {
method: 'GET',
mode: 'cors',
credentials: 'include', // This is crucial for Safari ITP
keepalive: true,
headers: {
'Cache-Control': 'no-cache',
'Pragma': 'no-cache'
}
}).catch(function(err) {});
} catch (e) {}
}
})();
</script>
নোট: কোডের ভেতরে
https://ts.yourdomain.com/ping এর জায়গায় আপনার নিজস্ব ট্র্যাকিং সাব-ডোমেইন বসাতে ভুলবেন না।- Triggering-এ ক্লিক করুন এবং All Pages সিলেক্ট করুন।
- ট্যাগটির নাম দিন: BonicBD - Cookie Extender এবং Save করুন।
ধাপ ২: কুকি ভেরিয়েবল তৈরি করা (Web GTM)
এখন ব্রাউজারে সেট হওয়া bbd_uid কুকিটি GTM-এর মাধ্যমে রিড করতে হবে।
- GTM-এ Variables মেনুতে যান।
- User-Defined Variables সেকশনে New-এ ক্লিক করুন।
- Variable Configuration > 1st Party Cookie সিলেক্ট করুন।
- Cookie Name বক্সে হুবহু লিখুন:
bbd_uid - URI-decode cookie অপশনে টিক দিন।
- ভেরিয়েবলটির নাম দিন: C - bbd_uid এবং Save করুন।
ধাপ ৩: সার্ভারে ডাটা পাঠানো (Web GTM)
এখন আমরা এই কুকি আইডিটি (C - bbd_uid) সার্ভারে পাঠাবো।
GA4 Configuration Tag এর মাধ্যমে:
- Web GTM-এ আপনার Google Tag (GA4 Configuration Tag) টি ওপেন করুন।
- Configuration Settings বা Fields to Set-এ যান।
- Add Parameter-এ ক্লিক করুন:
✅ Parameter Name:external_id
✅ Value:{{C - bbd_uid}} - Save করুন। এটি এখন সকল ইভেন্টের সাথে সার্ভারে যাবে।
ধাপ ৪: সার্ভার কন্টেইনার সেটআপ (Server GTM)
ওয়েব থেকে পাঠানো external_id সার্ভারে রিসিভ করে Facebook CAPI-তে ম্যাপ করতে হবে।
- আপনার Server GTM Container-এ যান।
- Variables > New > Variable Configuration > Event Data সিলেক্ট করুন।
- Key Path বক্সে লিখুন:
external_id - ভেরিয়েবলটির নাম দিন: ED - External ID এবং Save করুন।
- এরপর আপনার Facebook CAPI Tag ওপেন করুন।
- User Data সেকশনে External ID ফিল্ডে
{{ED - External ID}}বসিয়ে দিন।
কাজ শেষ! এখন সার্ভার সাইড থেকে প্রতিটি ইভেন্টের সাথে একটি ইউনিক এক্সটার্নাল আইডি ফেসবুকে যাবে, যা আপনার EMQ স্কোর বাড়াবে।
যাচাইকরণ (Verification)
আপনার সেটআপ সঠিকভাবে কাজ করছে কি না তা নিশ্চিত হতে:
- GTM Preview Mode অন করুন এবং আপনার সাইট ভিজিট করুন।
- ব্রাউজারে Inspect Element (F12) > Network Tab-এ যান।
- ফিল্টার বক্সে লিখুন:
ping - রিকোয়েস্টটি সফল (Status 200) হলে সেটার Headers চেক করুন। যদি
Set-Cookieদেখতে পান, তবে বুঝবেন Safari Fix কাজ করছে। - এরপর Application > Cookies ট্যাবে গিয়ে দেখুন
bbd_uidনামে কোনো কুকি আছে কি না।
সাহায্য প্রয়োজন?
কোনো সমস্যায় পড়লে বা বুঝতে অসুবিধা হলে আমাদের সাপোর্ট টিমে নক করুন। আমরা আছি আপনার পাশে!
হোয়াটসঅ্যাপ সাপোর্ট