كيفية قراءة سلسلة موافقة TCF: دليل ميداني للمطورين

ما هي TC string في الواقع

يُنتج IAB Transparency & Consent Framework رمزًا مميزًا واحدًا مدمجًا — TC string — يسافر مع كل طلب إعلان ويُخبر البائعين بالضبط بما وافق عليه المستخدم وما لم يوافق عليه. وهو مُرمَّز بـ Base64-URL ومُحزَّم على مستوى البِت، لذا يبدو كالهراء (CPxy...AAA) لكنه يُرمِّز سجلًا دقيقًا قابلًا للتدقيق.

القطاعات

تتكوّن TC string الكاملة من عدة قطاعات مفصولة بنقاط. الأول هو السلسلة الأساسية؛ والباقي اختياري:

حقول البِت هي جوهر الأمر: البِت N المضبوط على 1 يعني الموافقة على الغرض N أو البائع N. الغرض 1 هو “تخزين/الوصول إلى المعلومات على جهاز،” والغرضان 3 و4 يغطيان الإعلانات المخصّصة، وهكذا.

فك ترميز واحدة عمليًا

نادرًا ما تفك ترميز البِتات يدويًا. استخدم المكتبات التي يوفّرها IAB أو أداة فك ترميز عامة:

في JavaScript، يُرجِع الاستدعاء __tcfapi('getTCData', 2, cb) الكائن المُحلَّل بالفعل — tcData.purpose.consents وtcData.vendor.consents هما خرائط من id → boolean. هذه هي حقيقتك الأساسية أثناء وقت التشغيل.

الأخطاء التي تقتل الإيرادات

عندما يختفي الطلب المخصّص بهدوء، تكون TC string عادةً هي السبب:

سير عمل لتصحيح الأخطاء

أعِد إنتاج موافقة المستخدم، التقط TC string الحية من __tcfapi أو من طلب الإعلان، مرّرها عبر أداة تحقق، وقارن الأغراض/البائعين المُفكَّك ترميزهم بما يتطلبه شركاؤك. في تسع حالات من عشر، تكون الفجوة بِت بائع واحدًا أو غرض 1 مفقودًا.

أين يندرج FlexyConsent

يُولِّد FlexyConsent سلاسل TC strings صالحة وفق المواصفات بمعرّف CMP مسجّل، ويُبقيها حديثة، ويُتيح الحالة المُفكَّك ترميزها لتصحيح الأخطاء، ويُبلِّغ عن الأغراض والبائعين الذين يُمنحون فعليًا عبر حركة المرور لديك — حتى تستطيع أن ترى، لا أن تخمّن، أين تتسرب الموافقة (والإيرادات).

أهم النقاط

← المدونة قراءة الكل →