ChakraHQChakraHQ

إرسال حدث تحويل عميل محتمل إلى واجهة API لتحويلات Google Ads

إرسال تحويلات العملاء المحتملين من Chakra إلى Google Ads عبر Data Manager

نظرة عامة

استخدم إجراء قاعدة دورة الحياة إرسال التحويل إلى حساب الإعلانات مع منصة الإعلانات Google Ads لتحميل تحويلات العملاء المحتملين إلى Google Ads عبر Data Manager (events:ingest).

المتطلبات الأساسية

  • إجراء تحويل في Google Ads يقبل التحويلات بلا اتصال بالإنترنت أو التحويلات المحمّلة
  • اتصال Google ضمن المسؤول ← اتصالات حسابات الإعلانات
  • توفّر GCLID للعميل المحتمل عبر مصدر التسويق أو إحدى سمات العميل المحتمل
  • إذن لإنشاء قواعد دورة الحياة وتعديلها
  1. انتقل إلى المسؤول ← اتصالات حسابات الإعلانات (/admin/ad-account-connections).
  2. اربط Google وامنح Data Manager إذن الوصول حتى تتمكن Chakra من تحميل التحويلات.
  3. إذا ظهرت لاحقًا رسالة تفيد بأن الاتصال يحتاج إلى إعادة المصادقة، فاستخدم «إعادة الاتصال» في صف Google هذا حتى تحتفظ قواعد دورة الحياة الحالية بمعرّف الاتصال نفسه.
  1. أنشئ في Google Ads إجراء تحويل يقبل التحويلات المحمّلة أو التي تتم بلا اتصال بالإنترنت للعملاء المحتملين.
  2. انسخ معرّف إجراء التحويل الرقمي — ستلصقه في إجراء قاعدة دورة الحياة.

إنشاء قاعدة دورة الحياة

  1. أنشئ قاعدة دورة حياة يتم تفعيلها عند تحويل عميل محتمل (على سبيل المثال process:state-change:post مع شرط يتعلق بحالة التحويل).
  2. أضف الإجراء إرسال التحويل إلى حساب الإعلانات.
  3. عيّن منصة الإعلانات إلى Google Ads.
  4. املأ حقول Google أدناه، ثم احفظ القاعدة وفعّلها.

حقول الإجراء

  • اتصال Google (مطلوب) — اتصال OAuth من اتصالات حسابات الإعلانات
  • معرّف حساب Google Ads (مطلوب) — معرّف العميل الذي يملك إجراء التحويل
  • معرّف حساب تسجيل الدخول إلى Google Ads (اختياري) — معرّف الحساب الإداري / MCC عندما يصل المستخدم المتصل إلى حساب Ads عبر حساب إداري
  • معرّف إجراء التحويل (مطلوب) — المعرّف الرقمي من Google Ads
  • اسم الحدث (اختياري) — للتسمية فقط؛ تتم المطابقة باستخدام معرّف إجراء التحويل
  • مصدر GCLID — مصدر التسويق (process.marketingSource.gclid) أو سمة العميل المحتمل
  • الإجراء + سمة GCLID — مطلوب عندما يكون مصدر GCLID هو سمة العميل المحتمل
  • معرّف الحدث (إزالة التكرار) (اختياري) — يُعيّن إلى order_id في Google
  • القيمة / العملة (اختياري)
  • تعيينات بيانات المستخدم (موصى بها) — البريد الإلكتروني ورقم الهاتف وحقول الهوية الأخرى
  • تجاوزات البيانات المخصصة / معرّف النقر (اختياري) — تجاوزات متقدمة

آلية عمل الإحالة

تكون المطابقة في Google أفضل عندما يتضمن الحدث gclid و/أو حقول هوية قوية، مثل البريد الإلكتروني أو رقم الهاتف. قد تُرسل الأحداث التي تتضمن بيانات هوية ضعيفة، لكن احتمال مطابقتها في Google Ads أقل.

التحقق

  1. حوّل عميلًا محتملًا تجريبيًا يتضمن GCLID (من مصدر التسويق أو السمة المعينة).
  2. افتح اتصال Google ضمن اتصالات حسابات الإعلانات وتحقق من سجلات التحويل للتأكد من نجاح التحميل.
  3. تحقق من ظهور التحويل في تقارير Google Ads (قد يستغرق ذلك بعض الوقت).

ملاحظات

  • أعِد ربط Google عند انتهاء صلاحية الرمز المميز حتى تتمكن قواعد دورة الحياة من مواصلة استخدام معرّف الاتصال نفسه.
  • عيّن معرّف حساب تسجيل الدخول / الحساب الإداري فقط عندما يصل مستخدم Google المتصل إلى حساب Ads عبر MCC.
  • راجع أيضًا نظرة عامة على قاعدة دورة الحياة ضمن المنصة ← الميزات لمعرفة كيفية عمل الأحداث والإجراءات معًا.

في هذه الصفحة