مكتبة لتمكين استخدام مدير علامات جوجل (Google Tag Manager) من برامج الأسس. تم تصميم هذه المكتبة للعمل مع مـنصة_ويب.
تفترض هذه الخطوات أن لديك بالفعل مشروعًا على منصة الويب وتريد إضافة مدير علامات جوجل إليه.
- أضف المكتبة إلى مشروعك:
اشمل "مـحا"؛
مـحا.اشمل_ملف("Alusus/GoogleTagManager"، "مـدير_علامات_جوجل.أسس")؛
import "Apm";
Apm.importFile("Alusus/GoogleTagManager");
-
أضف الاعتمادات الأخرى إذا لم يتم إضافتها بالفعل في مشروعك إما مباشرةً أو غير مباشرة. بالإضافة إلى منصة الويب، تعتمد هذه المكتبة على الحزم التالية:
مـتم.نـم(Srl.Fs)مـتم.نـظام(Srl.System)مـتم.نـص(Srl.String)مـتم.سـندنا(Srl.SrdRef)مـؤجلات(Promises)جـيسون(Json)
-
قم بتهيئة جانب الخادم للمكتبة عن طريق استدعاء هذه الدالة خارج نهايات الملف:
مـدير_علامات_جوجل.هيئ_الخادم()؛
GoogleTagManager.initializeBackend();
- هيئ جانب الزبون داخل المنفذ المرئي:
انتظر(مـدير_علامات_جوجل.هيئ_الواجهة("<معرف_الحساب>"))؛
await(GoogleTagManager.initializeFrontend("<account_id>"));
- استخدم دالات مـدير_علامات_جوجل لدفع الأحداث حسب متطلبات برنامجك. على سبيل المثال، لدفع حدث إحالة ناجحة (conversion) للاستخدام مع مدير إعلانات جوجل استخدم الدالة التالية من المنفذ المرئي عند حصول عملية شراء:
مـدير_علامات_جوجل.ادفع_حدث_إحالة("<معرف_الحساب>"، "<معرف_الإحالة>"، "<معرف_عملية_شراء>")؛
GoogleTagManager.pushConversionEvent("<account_id>", "<conversion_id>", "<transaction_id>");