تم تصميم واجهة API التحويلات لإنشاء اتصال مباشر بين بيانات التسويق لديك والأنظمة التي تساعد في تحسين استهداف الإعلانات وتقليل التكلفة لكل إجراء وقياس النتائج على مستوى تقنيات Meta. يمكنك تكوين خادم وإعداده على Google Cloud Platform (GCP) أو أي موفر خدمة سحابية آخر لإرسال بيانات رئيسية لأحداث ويب وبلا اتصال عبر واجهة API التحويلات. باستخدام هذا الإعداد، بعد أن تقوم بتكوين إشارة الويب Google Analytics 4 (GA4)، يمكنك إرسالها إلى الخادم الخاص المستضاف على Google Cloud Platform (GCP) ومن ثم إلى Meta عبر واجهة API التحويلات.
تتم كتابة إشارة واجهة API التحويلات والاحتفاظ بها بواسطة Meta استنادًا إلى قالب الإشارة المخصص في Google. يُرجى التواصل مع Google بشأن أي أسئلة لديك حول إعداد منتجات Google أو وثائق المطوّرين من Google.
يوضح هذا المستند ما يلي:
قبل المتابعة هذا الدمج، نوصي بإجراء ما يلي:
إذا كان نظامك يستخدم إصدارًا أقدم من GA4، فستحتاج إلى ترقية إعداد مدير الإشارات الحالي لاستخدام GA4 قبل المتابعة في هذا الدمج.
يتيح لك هذا إدارة إشارة التتبع والتسويق وتخزينها. كما أنه يساعدك في تتبع كيفية تفاعل المستخدمين مع موقع الويب لديك.
ستحتاج إلى تكوين حاوية خادم وحاوية ويب:
انتقل إلى "إدارة العلامات من Google" عن طريق زيارة موقع إدارة العلامات من Google.
إذا كان لديك حساب بالفعل، فقم بتحديده. بخلاف ذلك، أنشئ حساب GTM جديدًا.
انقر على إنشاء حاوية
قم بتسمية الحاوية وحدد "الخادم" كمنصة مستهدفة
انقر على إنشاء
يتطلب إعداد حاوية الخادم تكوين خادم الإشارة. يمكن إكمال نشر GCP الافتراضي عند إعداد حاوية الخادم. راجع التوجيهات التالية. بالنسبة إلى أي موفر خدمة سحابية آخر (على سبيل المثال، AWS أو Microsoft Azure)، راجع دليل إعداد الخادم اليدوي.
تكوين حاويات الويب والخادم
graph.facebook.com
.يمكنك تكوين حاوية الويب لإرسال بيانات موقع الويب إلى خادم الإشارات الذي تم إنشاؤه. تعرف على المزيد حول كيفية تكوين Google Analytics: إشارة تكوين GA4.
transport_url
يمكنك تكوين حقول إضافية لأي معلمات أخرى تريد إرسالها لكل الأحداث.
first_party_collection
true
إذا تم إعداد تكوين GA4 موجود بالفعل، فيمكنك إما تعديله أو إنشاء إشارة تكوين إضافية في GTM من جانب الخادم.
إذا كنت بصدد إعداد GTM من جانب الخادم لأول مرة، فإن إضافة عنوان URL حاوية الخادم سيبدأ في إرسال كل الزيارات إلى حاوية الخادم. إذا أردت الاستمرار في إرسال البيانات إلى GA4، فستحتاج إلى إضافة إشارة GA4 من جانب الخادم في حاوية الخادم، مما يضمن تشغيل كل الأحداث. قد تحتاج إلى إنشاء إشارات أحداث GA4 إضافية أو تعديل الإشارات الموجودة لضمان تعيين كامل لأحداث بيكسل Meta.
إذا قمت بإعداد نطاق مخصص، وكان نطاق خادم إشارة GTM متوفر داخليًا، فسيتم إرسال معرف متصفح Meta ومعرف النقر في Meta تلقائيًا.
إذا كنت تستخدم النطاق الافتراضي المتوفر أو لاحظت عدم إرسال حقول معرف المتصفح ومعرف النقر في مدير الأحداث، فيمكنك تكوينها كما يلي:
_fbp
_fbc
أنشئ متغير طبقة البيانات في كل معلمات user_data لدى مخطط حدث GTM المشترك. تعرف على المزيد حول إعداد متغيرات طبقة البيانات. على سبيل المثال، لإدخال عنوان البريد الإلكتروني في GTM من جانب الخادم، أنشئ متغيرًا (على سبيل المثال، user_data_email_address
) يمكن تعيينه على اسم متغير طبقة البيانات، eventModel.user_data.email_address
.
إذا كنت لا تستخدم طبقة البيانات، فقم بتكوين المتغيرات لكل معلمة كما هو موضح أدناه للاستخدام بدلاً من ذلك. تعرض القائمة أدناه كل التعيينات لمعلمات user_data في Meta وGTM وأولويتها العامة في المساعدة على زيادة جودة مطابقة الأحداث. لتحقيق أقصى استفادة من إعلانات Meta، نوصي باستخدام أفضل ممارسات واجهة API التحويلات هذه عند إعداد الدمج. إذا كنت قد قمت بالفعل بإعداد واجهة API التحويلات، فنوصي باتباع أفضل الممارسات هذه لتحسين الإعداد الحالي. قد تساعد أفضل الممارسات حول واجهة API التحويلات في تحسين أداء الإعلان عن طريق تخفيض التكلفة لكل إجراء.
معلمة Meta في واجهة API التحويلات | اسم حقل GA4 | اسم متغير طبقة بيانات GTM | الأولوية |
---|---|---|---|
البريد الإلكتروني
| user_data.email_address | eventModel.user_data.email_address | عالية |
معرف النقرة
| x-fb-ck-fbc | لا ينطبق | عالية |
معرف تسجيل دخول فيسبوك | user_data.fb_login_id | لا ينطبق | متوسطة |
تاريخ الميلاد
| x-fb-ud-db | لا ينطبق | متوسطة |
البلد
| user_data.address.country | eventModel.user_data.address.country | متوسطة |
رقم الهاتف
| user_data.phone_number | eventModel.user_data.phone_number | متوسطة |
المعرف الخارجي
| x-fb-ud-external_id | لا ينطبق | متوسطة |
معرف المتصفح
| x-fb-ck-fbp | لا ينطبق | متوسطة |
الولاية
| user_data.address.region | eventModel.user_data.address.region | متوسطة |
الجنس
| x-fb-ud-ge | لا ينطبق | متوسطة |
الاسم الأول
| user_data.address.first_name | eventModel.user_data.address.first_name | منخفضة |
اسم العائلة
| user_data.address.last_name | eventModel.user_data.address.last_name | منخفضة |
المدينة
| user_data.address.city | eventModel.user_data.address.city | منخفضة |
الرمز البريدي | user_data.address.postal_code | eventModel.user_data.address.postal_code | منخفضة |
يمكنك تكوين حاوية الويب لإرسال بيانات موقع الويب إلى خادم الإشارة الذي تم إنشاؤه لإضافة Google Analytics. تعرف على المزيد حول كيفية تكوين Google Analytics: إشارة تكوين GA4.
أضف Google Analytics: إشارة حدث GA4 إلى مساحة العمل من معرض القوالب:
اسم الحدث القياسي في Meta | اسم حدث Google Analytics |
---|---|
AddPaymentInfo | add_payment_info |
AddToCart | add_to_cart |
AddToWishlist | add_to_wishlist |
PageView | gtm.dom |
PageView | page_view |
Purchase | purchase |
Search | search |
InitiateCheckout | begin_checkout |
Lead | generate_lead |
ViewContent | view_item |
CompleteRegistration | sign_up |
في القسم "معلمات الأحداث":
تتضمن كل حاوية من جانب خادم GTM عميل GA4 افتراضي لتتبع الأحداث التي يتم تكوينها من إشارة ويب GA4. يتتبع عميل GA4 مسار /g/collect على عنوان URL خادم الإشارات ويرسل eventModel لإشارة الاستجابة النهائية. إذا تم بالفعل تثبيت عميل GA4 الافتراضي في حاوية الخادم ضمن قسم العملاء، فيمكنك الانتقال إلى الخطوة الرابعة.
لإرسال الحدث إلى واجهة API التحويلات، يجب تثبيت إشارة واجهة API التحويلات من Meta من معرض القوالب. يسمي facebookincubator قالب الإشارة إشارة واجهة API التحويلات. يمكن إعداد هذه الإشارة ليتم تشغيلها وفقًا للأحداث التي يتلقاها عميل GA4 (في الخطوة السابقة) وإرسالها إلى واجهة API التحويلات. لتثبيت إشارة واجهة API التحويلات من Meta، يجب الحصول على معرف البيكسل ورمز الوصول وتحديد مصدر الإجراء ليكون "موقع الويب". بمجرد استخدام واجهة API التحويلات، فإنك توافق على أن المعلمة action_source
دقيقة حسب معلوماتك.
نوصي باستخدام وضع معاينة مدير إشارات Google لاختبار عمليات الدمج قبل نشر التغييرات. تحتوي حاويات الويب وحاويات الخادم على أوضاع معاينة، ويمكنك تشغيل كلاها في الوقت ذاته.
إذا قمت بتغيير الإعداد أثناء تشغيل وضع المعاينة، فتأكد من إعادة تشغيل وضع المعاينة للتأكد من تطبيق التغييرات أثناء الاختبار.
يمكنك التحقق من تلقي أحداث الخادم كما هو مطلوب وذلك باستخدام ميزة اختبار الأحداث المتوفرة في مدير الأحداث. للعثور على الأداة، انتقل إلى مدير الأحداث > مصادر البيانات > البيكسل > اختبار الأحداث.
تعمل أداة اختبار الأحداث على إنشاء معرف اختبار. أرسل معرف الاختبار في صورة معلمة test_event_code
ضمن إشارة واجهة API التحويلات لبدء عرض نشاط الحدث في النافذة "اختبار الأحداث". تأكد من إزالة ذلك قبل نشر أي تغييرات.
تتيح لك أداة اختبار الأحداث معرفة ما إذا كان يتم استقبال الأحداث وإلغاء تكرارها بشكل صحيح. إذا لم تظهر الأحداث بعد دقيقة أو دقيقتين، فتحقق من مصحح أخطاء GTM من جانب الخادم للتأكد من تمرير الطلب:
https://graph.facebook.com
. راجع نص الاستجابة أسفل تفاصيل الطلب لمعرفة الخطأ، وقم بتحديث الدمج حسب الاقتضاء. لا تنس إعادة تشغيل وضع المعاينة بعد إجراء أي تغييرات.بمجرد ظهور الأحداث، تحقق من إرسال معرفات الأحداث لكل حدث بشكل صحيح، وعرض كل مفاتيح المطابقة المتوقعة ومعلمات البيانات المخصصة بشكل صحيح. ستعرض لك أداة اختبار الأحداث ما إذا كان يتم إلغاء تكرار الأحداث بشكل صحيح. إذا كانت معرفات الأحداث مختلفة، فتأكد من تشغيل إشارات GA4 وبيكسل Meta على أداة التشغيل ذاتها، وراجع تنفيذ متغير معرف الحدث.
نوصيك باستخدام إعداد حدث متكرر ومشاركة الأحداث ذاتها من واجهة API التحويلات وبيكسل Meta. تأكد من أن الحدثين يستخدمان event_name
مطابقًا، وأنه يتم تضمين event_id
أو مجموعة من external_id
وfbp
.
سيساعد ذلك Meta في إلغاء تكرار الأحداث وتقليل عدد التقارير المزدوجة للأحداث المطابقة. تعرف على المزيد حول إلغاء التكرار عند الضرورة وكيفية إعدادها. external_id وfbp هي حلول بديلة لإلغاء التكرار وتساعد أيضًا في تحسين جودة الإعداد. نوصي بتضمين هذه المعلمات الثلاث كلما أمكن.
تتوفر لدى GTM طرقًا متعددة لإعداد معلمة لديها القيمة نفسها عبر إشارة المتصفح إشارة الخادم. تتمثل إحدى هذه الطرق في استخدام حدث GA4 ذاته كعامل لتشغيل إشارة بيكسل Meta وحدث الخادم. لتنفيذ ذلك:
event_id
ذاته في كلا الإشارتين:
x-fb-event_id
) من حدث gtag. ويمكنك إنشاء معرف فريد (لكل حدث) على موقع الويب باستخدام إجراء Javascript (أو باستخدام متغير Javascript المخصص لمدير إشارات Google) وتعيين القيمة في الحدث كما يلي:gtag('event', 'purchase', { 'x-fb-event_id': generateEventId(), ...:... });يمكنك إنشاء متغير يشير إلى إجراء Javascript المخصص كما هو موضح أعلاه. كلما تتم الإشارة إلى المتغير، يتم تحميل Javascript أدناه تباعًا:
function() { var gtmData = window.google_tag_manager[{{Container ID}}].dataLayer.get('gtm'); return gtmData.start + '.' + gtmData.uniqueEventId; }
event_id
. يمكنك إجراء ذلك عن طريق إنشاء متغير طبقة بيانات جديد، على سبيل المثال FBEventIdVar، مع تعيين اسم متغير طبقة البيانات ليكون eventModel.event_id
.event_id
من المتغير.fbq('track', Purchase, {..}, {eventID: FBEventIDVar });قم بتكوين حدث GA4 لإرسال معلمة إضافية، تُسمى
event_id
، مع التعيين على المتغير FBEventIdVar
.
لإرسال بيانات مخصصة، استخدم التعيينات أدناه في إشارات حدث GA4:
اسم معلمة Meta | اسم معلمة GA4 |
---|---|
value | value |
currency | currency |
search_string | search_term |
order_id | transaction_id |
content_ids | x-fb-cd-content_ids |
content_type | x-fb-cd-content_type |
content_name | x-fb-cd-content_name |
content_category | x-fb-cd-content_category |
contents* | items OR x-fb-cd-contents |
num_items | x-fb-cd-num_items |
predicted_ltv | x-fb-cd-predicted_ltv |
status | x-fb-cd-status |
delivery_category | x-fb-cd-delivery_category |
custom_properties* | custom_properties |
يُرجى استخدام JSON.stringify x-fb-cd-contents وcustom_properties قبل الإرسال، حيث إنها معلمات JSON تحددها Meta.
بعد تكوين حاويات الويب والخادم، يمكنك إرسال عينة حدث من موقع الويب للتحقق من حدث الخادم. قد تبدو عينة الحدث الذي يتضمن معلمات تم تكوينها كما يلي
gtag('event', 'purchase', { 'event_id': generateEventId(), 'transaction_id': 't_12345', 'currency': 'USD', 'value': 1.23, user_data: { email_address: '<HASHED_DATA>', phone_number: '<HASHED_DATA>', address: { first_name: '<HASHED_DATA>', last_name: '<HASHED_DATA>', city: '<HASHED DATA>', region: '<HASHED_DATA>', postal_code: '<HASHED_DATA>', country: '<HASHED_DATA>' }, }, items: [ { item_id: '1', item_name: 'foo', quantity: 5, price: 123.45, item_category: 'bar', item_brand: 'baz' } ], });
بمجرد تشغيل الحدث، من المفترض أن يتم إرسال طلب إلى، على سبيل المثال، عينة من الرابط: www.analytics.example.com/g/collect، يتضمن المعلمات التي تم تكوينها. يمكنك إضافة رمز الحدث الاختباري إلى إشارة واجهة API التحويلات من Meta بغرض التحقق من الأحداث التي تم إرسالها إلى واجهة API التحويلات. لا يجب استخدام رمز اختبار الحدث إلا لأغراض الاختبار. يجب إزالته عند إرسال حمولة بيانات الإنتاج.
بعد نشر التغييرات، استخدم صفحة التحقق من الإعداد هنا لضمان إرسال الأحداث بشكل صحيح عن طريق "التحقق من الإعداد - واجهة API التحويلات" التالي ومراجعة امتثال دمج الجودة لأفضل الممارسات.
هل توجد نية لإضافة إمكانية إرسال معلمات مخصصة؟ إذا كانت الإجابة بنعم، فمتى سيتوفر ذلك؟
ج: لقد أضفنا إمكانية تعيين معظم المعلمات المخصصة القياسية لواجهة API التحويلات المدعومة في مخطط GTM. كما نوفر إمكانية تنفيذ تعيين مخصص. راجع هنا للتعرف على المزيد.
هل يمكن لخادم واحد أو مجموعة خوادم تشغيل حاويات متعددة؟
ج: لا يدعم GTM سوى التعيين الفردي حاليًا. يمكنك قراءة التوصيات حول كيفية تنظيم الحاويات.
هل يتطلب GTM من جانب الخادم إشارة تستند إلى المتصفح لإرسال الأحداث
ج: نعم
هل من الممكن الحفاظ على GA4 بشكل منفصل مع الدمج من جانب الخادم؟
ج: للحفاظ على GA4 منفصل ودمج GTM من جانب الخادم، يمكنك إنشاء معرف قياس إضافي في Google Analytics. أنشئ إشارة تكوين GA4 منفصلة في GTM من جانب الخادم باستخدام معرف القياس هذا، باتباع الخطوات أعلاه. في هذا السيناريو، ستستمر إشارة تكوين GA4 في إرسال زيارات GA عبر حاوية الويب، بينما سترسل إشارة التكوين الجديدة البيانات إلى حاوية الخادم. أنشئ إشارات حدث GA4 إضافية وفقًا للخطوة الثانية لإرسال الأحداث من جانب الخادم، باستخدام إشارة التكوين الجديدة
هل يتناسب دمج واجهة API التحويلات من GTM مع حلول استضافة السحابة بخلاف GCP؟
ج: من المفترض أن يتوافق دمج واجهة API التحويلات من GTM مع GCP أو أي منصة أخرى من اختيارك. يمكنك قراءة المزيد حول التوفير اليدوي.