ClickID والمعلمتان fbp وfbc

يشرح هذا الدليل ClickID والمعلمتين _fbc و_fbp من Meta. تمثل المعلمتان _fbc و_fbp قيم ملفات تعريف ارتباط المتصفح ويمكن إرسالهما مع أحداث الخادم. راجع حول إعدادات ملفات تعريف الارتباط لبيكسل Meta.

نوصيك دائمًا بإرسال قيم ملفات تعريف الارتباط للمتصفح _fbc و_fbp في معلمات الأحداث fbc وfbp على التوالي، عندما تكون متاحة. تخضع هذه القيم للتغيير خلال جلسات متصفح متعددة، لذلك نوصي بتحديث الملف الشخصي للمستخدم بأحدث قيمة كلما أمكن ذلك.

ماذا يكون ClickID من Meta؟

ClickID هو معلمة تم إنشاؤها من خلال Meta ويتم إدخالها مع عنوان URL لموقع ويب المعلن عندما ينقر المستخدم على الإعلان في فيسبوك و/أو Instagram. يمكن أن تساعد مشاركة ClickID في إسناد المزيد من التحويلات والوصول إلى المزيد من الأشخاص، ما قد يؤدي إلى أداء أفضل للإعلان. لا يؤثر مرفق ClickID التلقائي على معلمات التتبع المخصصة الأخرى التي قد تكون قمت بتمكينها.

مثال على عنوان URL مع ClickID: https://example.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk

مزايا ClickID

• زيادة حجم التحويلات
• تحسين إسناد الحملة الإعلانية وتعزيزه
• زيادة أداء الإعلان

1. استرداد ClickID من Meta

الاسترداد من معلمة الاستعلام عن عنوان URL fbclid

عندما تكون موجودة في معلمات الاستعلام عن عنوان URL، حاول الحصول على المعلمة من جانب الخادم عن طريق قراءتها من سلسلة الاستعلام عن عنوان URL لطلب HTTP.

مثال:

GET /?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk 
HTTP/2.0
Host: www.example.org

الاسترداد من ملف تعريف ارتباط _fbc

قيمة ClickID متوفرة ضمن ملف تعريف ارتباط _fbc في حالتين:

• تم تثبيت بيكسل Meta على موقع الويب. في هذه الحالة، يعمل بيكسل Meta تلقائيًا على تخزين قيمة ClickID في ملف تعريف ارتباط متصفح _fbc بمجرد توفره
• أن تقوم بتخزينه بالفعل في ملف تعريف الارتباط من الخادم أو في مساحة تخزين الواجهة الخلفية، وفقًا لأفضل الممارسات المدرجة في القسم "تخزين ClickID"

في هاتين الحالتين يمكن الحصول على ClickID منسقة من ملف تعريف ارتباط _fbc عن طريق قراءة عناوين ملفات تعريف الارتباط لطلب HTTP. راجع كيفية تنسيق ClickID بشكل صحيح في قسم "تنسيق ClickID" أدناه.

2. تنسيق ClickID

إذا كان ملف تعريف ارتباط _fbc غير متوفر، بسبب عدم وجود بيكسل Meta قيد التشغيل على موقع الويب، فلا يزال من الممكن إرسال معلمة الحدث fbc مع حدث واجهة API التحويلات إذا كانت معلمة الاستعلام fbclid متوفرة في عنوان URL لطلب الصفحة الحالي.

يجب أن تكون قيمة ClickID المنسقة بالصيغة version.subdomainIndex.creationTime.<fbclid>، حيث يكون:

• version هو دائمًا هذه البادئة: fb
• subdomainIndex هو النطاق الذي تم تعريف ملف تعريف الارتباط فيه ('com' = 0, 'example.com' = 1, 'www.example.com' = 2)
• creationTime هو وقت بتنسيق UNIX منذ الفترة بالمللي ثانية عندما تم تخزين _fbc. إذا لم تحفظ ملف تعريف الارتباط _fbc، فاستخدم الطابع الزمني إذا لاحظت قيمة fbclid لأول مرة أو تلقيتها
• <fbclid> هي قيمة معلمة الاستعلام fbclid في عنوان URL للصفحة.

فيما يلي مثال على الشكل الذي يمكن أن تبدو عليه قيمة المعلمة fbc الناتجة (لاحظ أن الجزء <fbclid> غير صالح):

fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

3. معرف ClickID للمتجر

قم بتعيين ClickID المنسقة في ملف تعريف الارتباط _fbc ضمن استجابة HTTP

يوصى بشدة بتعيين _fbc كـ:

• ملف تعريف ارتباط HTTP في عناوين استجابة HTTP
• مع فترة انتهاء صلاحية مدتها 90 يومًا

بمجرد الاستعادة من معلمة الاستعلام عن عنوان URL fbclid أو ملف تعريف ارتباط متصفح _fbc.

ملاحظة، قم بتعيين ملف تعريف الارتباط فقط إذا:

• كان ملف تعريف ارتباط _fbc غير موجود وتم استرداد ClickID من معلمة الاستعلام عن عنوان URL fbclid
• fbclid في معلمة الاستعلام عن عنوان URL لا يساوي القيمة المقابلة في قيمة ملف تعريف الارتباط _fbc. في ملف تعريف الارتباط، يطابق fbclid السلسلة بعد آخر "." في قيمة ملف تعريف الارتباط.

مثال:

HTTP/2.0 200 OK
Content-Type: text/html
Set-Cookie:
_fbc=fb.1.1709136167115.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk; Expires=Thu, 21 Oct 2021 07:28:00 GMT;

تخزين ClickID المنسقة في الخادم

كبديل لخيار ملف تعريف الارتباط أعلاه، يمكنك تخزين قيمة ClickID المنسقة وإدارتها في مساحة تخزين الواجهة الخلفية. في هذه الحالة، ستحتاج إلى ضمان تخزين أحدث قيمة تم الحصول عليها من معلمة الاستعلام عن عنوان URL وإرسالها، إن وجدت.

4. إرسال المعلمة fbc مع أحداث واجهة API التحويلات

بعد الحصول على قيمة ClickID، يجب تنسيقها بشكل صحيح قبل إرسالها مع حدث عبر واجهة API التحويلات - راجع التعليمات أدناه. نوصي بإرسال المعلمة fbc مع كل حدث إلى واجهة API التحويلات.

اسم المعلمة: fbc

قيمة المعلمة: يجب أن تكون بالصيغة version.subdomainIndex.creationTime.fbclid، حيث يكون:

• version هو دائمًا هذه البادئة: fb
• subdomainIndex هو النطاق الذي تم تعريف ملف تعريف الارتباط فيه ('com' = 0, example.com' = 1, 'www.example.com' = 2). إذا كنت تقوم بإنشاء هذا الحقل على خادم، ولم تحفظ ملف تعريف الارتباط _fbc، فاستخدم القيمة 1.
• creationTime هو وقت بتنسيق UNIX منذ الفترة بالمللي ثانية عندما تم حفظ ملف تعريف الارتباط _fbc. إذا لم تحفظ ملف تعريف الارتباط _fbc، فاستخدم الطابع الزمني إذا لاحظت قيمة fbclid لأول مرة أو تلقيتها.
• fbclid هي قيمة معلمة الاستعلام fbclid في عنوان URL للصفحة.

مثال على القيمة:

fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk

مثال على حمولة بيانات واجهة API التحويلات:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1712248396,
            "action_source": "website",
            "user_data": {

                "fbc": "fb.1.1554763741205.IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk",

                "em": ["7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068"],
                "ph": ["6069d14bf122fdfd931dc7beb58e5dfbba395b1faf05bdcd42d12358d63d8599"],
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            }
        }
    ]
}

أدوات مساعدة الدمج

أداة مساعدة حمولة البيانات

أداة مساعدة حمولة البيانات هي أداة تسمح بإنشاء حمولة بيانات طلب واجهة API التحويلات لضمان إرسال التنسيق الصحيح للبيانات إلى Meta. كما تظهر مجموعة SDK للأعمال بلغات برمجة متعددة يمكنك استخدامها للدمج مع واجهة API التحويلات. تتوفر عند النقر على زر "الحصول على الرمز" ضمن قسم "إنشاء رمز".

fbp

عندما يتم تثبيت بيكسل Meta على موقع ويب، ويستخدم البيكسل ملفات تعريف الارتباط الأساسية، يقوم البيكسل تلقائيًا بحفظ معرف فريد في ملف تعريف الارتباط _fbp لنطاق موقع الويب إذا لم يكن أحد موجودًا بالفعل.

يجب أن تكون قيمة معلمة الحدث fbp بالصيغة version.subdomainIndex.creationTime.randomnumber، حيث يكون:

• version هو دائمًا هذا البادئة: fb
• subdomainIndex هو النطاق الذي تم تعريف ملف تعريف الارتباط فيه ('com' = 0, 'example.com' = 1, 'www.example.com' = 2). إذا كنت تقوم بإنشاء هذا الحقل على خادم، ولم تحفظ ملف تعريف الارتباط _fbp، فاستخدم القيمة 1.
• creationTime هو وقت بتنسيق UNIX منذ الفترة بالمللي ثانية عندما تم حفظ ملف تعريف الارتباط _fbp. إذا لم تحفظ ملف تعريف الارتباط _fbp، فاستخدم الطابع الزمني إذا لاحظت قيمة fbp هذه أو تلقيتها لأول مرة.
• يتم إنشاء Randomnumber بواسطة مجموعة SDK لبيكسل Meta للتأكد من أن كل ملفات تعريف الارتباط _fbp فريدة.

فيما يلي مثال لما يمكن أن تبدو عليه قيمة fbp:

fb.1.1596403881668.1116446470

معرفة المزيد

• يمكنك زيارة دليل دعم البيكسل فيما يتعلق بأي مشكلات تتعلق بمعلمات الاستعلام المفقودة أو عمليات إعادة التوجيه المعطلة.