> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# تتبّع UTM من WhatsApp إلى HubSpot

> انسب محادثات WhatsApp إلى الحملة التي بدأتها باستخدام معلَمات UTM على إعلانات Click-to-WhatsApp، وروابط click-to-chat، وتتبّع CTWA.

عندما يتصل بك عميل عبر WhatsApp
، فإن أهم معلومة في هذا السياق هي **المصدر الذي أتى منه**: أي إعلان من نوع "انقر للوصول إلى صفحة الهبوط" (CTWA) نقر عليه، أو أي رابط موقع إلكتروني، أو أي حملة بريد إلكتروني. بدون هذا الإسناد، تنهار تقاريرك لتصبح "WhatsApp
" كمصدر واحد. وبوجوده، يمكنك مقارنة الحملات، وحساب عائد الاستثمار في الإعلانات (ROAS)، وإدخال الإسناد الصحيح في صفقات HubSpot
.

تغطي هذه الصفحة الأنماط الثلاثة التي يدعمها Flowella
لنقل إسناد الحملة من WhatsApp
إلى HubSpot
.

## النمط 1: إعلانات Click-to- WhatsApp

(`ctwa_clid`
)

تربط إعلانات CTWA على Facebook و Instagram معرف النقر (`ctwa_clid`
) بكل محادثة تنشأ عنها. يقوم Meta
بتمرير هذا المعرف إلى سياق المحادثة عندما ينقر المستخدم على الإعلان ويبدأ الدردشة، ويقوم Flowella
بإعادة توجيهه إلى HubSpot
في سجل جهة الاتصال.

التدفق:

1. يرى العميل إعلان CTWA على Facebook أو Instagram.
2. ينقر العميل على زر **إرسال رسالة** في الإعلان. يفتح WhatsApp
   برسالة مملوءة مسبقًا ويسجل Meta
   `ctwa_clid`
   .
3. يرسل العميل الرسالة. يتلقى Flowella
   الرسالة الواردة مع`ctwa_clid`
   في البيانات الوصفية.
4. يقوم Flowella
   بإنشاء أو تحديث جهة الاتصال HubSpot
   بقيمة`ctwa_clid`
   في خاصية مخصصة.
5. يقوم Flowella
   أيضًا بتخزين`ctwa_clid`
   مقابل المحادثة حتى تتمكن أدوات التحليل من ربطها مرة أخرى بإنفاق الإعلانات.

<Note>
  يستخدم تكامل واجهة برمجة تطبيقات التحويلات (Conversions API) في
  Meta
  لإرسال أحداث التحويل مرة أخرى إلى Facebook Ads Manager نفس`ctwa_clid`
  . انظر [CTWA Ads](/ar/campaigns/click-to-whatsapp-ads) لإعداد هذا حتى تتمكن من تحسين الإنفاق الإعلاني على التحويلات الفعلية، وليس فقط النقرات.
</Note>

## النمط 2: روابط "انقر للدردشة" من صفحاتك الخاصة

عندما تضع زر \*\*Chat on WhatsApp
\*\* على موقعك الإلكتروني أو في بريدك الإلكتروني، ستستخدم رابط`wa.me`
. يدعم الرابط معلمة`text`
التي تملأ مسبقًا الرسالة الأولى للمستخدم:

```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```

يمكن لـ

Flowella
تحليل الرسالة المملوءة مسبقًا بحثًا عن رموز التتبع وكتابتها في HubSpot
. القاعدة التي نوصي بها:

* استخدم **كلمة رئيسية بين قوسين** من غير المرجح أن يكتبها المستخدم عن طريق الخطأ، على سبيل المثال`[SPRING_LAUNCH]`
  أو`[NEWSLETTER_JUL]`
  .
* ضع الكلمة الرئيسية بين علامات حتى يكون التحليل واضحًا.
* اجعل الكلمة الرئيسية قصيرة وسهلة القراءة حتى تظل الرسالة المعبأة مسبقًا تبدو طبيعية.

يتم وضع الكود المستخرج في خاصية`whatsapp_entry_source`
الخاصة بجهة الاتصال في HubSpot
(أو خاصية مخصصة تحددها في \*\* Flowella
→ Settings → HubSpot
\*\*).

### إنشاء الروابط لكل حملة

نمط عملي: في أداة حملات HubSpot
أو جدول بيانات التسويق الخاص بك، قم بإنشاء قائمة بحث صغيرة للحملة → كود الإدخال، وقم بإنشاء رابط`wa.me`
واحد لكل حملة. استخدم أداة تقصير الروابط أو رابط تتبع الحملة إذا كنت تريد رابطًا أكثر تنظيمًا في البريد الإلكتروني ومواد الإعلانات الإبداعية.

## النمط 3: روابط UTM

الخاصة بإرسال النماذج

عندما يؤدي إرسال نموذج HubSpot
إلى تشغيل سير عمل WhatsApp
، تكون خصائص HubSpot
UTM
القياسية (`hs_analytics_first_url`
،`hs_analytics_source`
،`hs_analytics_source_data_1`
، إلخ) موجودة بالفعل في جهة الاتصال. Flowella
يقرأ هذه الخصائص عبر تكامل HubSpot
ويعرضها في سياق المحادثة.

هذا هو النمط الأكثر وضوحًا عندما يكون WhatsApp
قناة **متابعة**: وصل العميل في الأصل عبر عنوان URL الموسوم بـ UTM
، وأرسل نموذجًا، و Flowella
يطلق WhatsApp Flow
الذي يملأ الفراغات. يتم الحفاظ على إسناد UTM
من البداية إلى النهاية دون أي شيء خاص بـ WhatsApp
.

## إنشاء تقارير HubSpot

بناءً على هذه البيانات

بمجرد وصول الإحالة إلى جهة الاتصال، يمكنك إنشاء تقارير HubSpot
قياسية بناءً عليها:

* \*\*جهات الاتصال حسب`whatsapp_entry_source`
  \*\* — الحملات التي جذبت عملاء محتملين من WhatsApp

* \*\*الصفقات → المصدر الأول = WhatsApp
  \*\* — الإيرادات المنسوبة إلى جهات الاتصال التي نشأت من WhatsApp

* **أداء سير العمل حسب المصدر** — الحملات التي حققت أعلى معدلات الرد/التحويل داخل WhatsApp Flow

انظر [التقارير ولوحات المعلومات](/ar/hubspot/reporting-and-dashboards) للاطلاع على أنماط التقارير التي نوصي بإعدادها.

## ما هي الإحالة التي يكتبها Flowella

إلى HubSpot
؟

بشكل افتراضي، يكتب Flowella
الخصائص التالية على كل جهة اتصال أثناء نشاط WhatsApp
:

| الخاصية                       | النوع                                                   | وقت الكتابة |
| ----------------------------- | ------------------------------------------------------- | ----------- |
| `whatsapp_opted_in`           |                                                         |             |
| منطقية                        | عندما يمنح جهة الاتصال موافقته على WhatsApp             |             |
|                               |                                                         |             |
| `whatsapp_first_message_at`   |                                                         |             |
| طابع زمني                     | عندما يرى Flowella                                      |             |
| رسالة واردة لأول مرة          |                                                         |             |
| `whatsapp_last_message_at`    |                                                         |             |
| طابع زمني                     | يتم تحديثه مع كل رسالة واردة                            |             |
| `whatsapp_entry_source`       |                                                         |             |
| سلسلة                         | كود المصدر المُحلل للرسالة الواردة الأولى أو`ctwa_clid` |             |
|                               |                                                         |             |
| `whatsapp_campaign_id`        |                                                         |             |
| سلسلة                         | معرف حملة Flowella                                      |             |
| للمحادثة، إن أمكن             |                                                         |             |
| `whatsapp_template_last_sent` |                                                         |             |
| سلسلة                         | أحدث قالب تم إرساله إلى جهة الاتصال                     |             |

يمكنك تعيين بيانات WhatsApp
إضافية إلى خصائص HubSpot
مخصصة في \*\* Flowella
→ الإعدادات → HubSpot
→ تعيين الحقول\*\*.

## المشاكل الشائعة

<AccordionGroup>
  <Accordion title="لا يظهر 'ctwa_clid' إلا للمحادثات التي يتم إنشاؤها بواسطة الإعلانات">
    لا تحمل كل رسالة واردة من WhatsApp
    عنوان`ctwa_clid`
    . فقط تلك التي تأتي من إعلان CTWA على Facebook/Instagram هي التي تحمله. الرسائل المباشرة (حيث قام العميل بكتابة رقمك يدويًا في WhatsApp
    ) لن تحتوي على هذه القيمة، وهذا صحيح — فليس هناك إعلان يمكن نسبها إليه.
  </Accordion>

  <Accordion title="يمكن للمستخدم حذف النص المعبأ مسبقًا">
    الرسالة المعبأة مسبقًا هي مجرد إعداد افتراضي. يقوم بعض المستخدمين بحذفها قبل الإرسال، بينما يقوم آخرون بتعديلها. لا تعتمد عليها في منطق التوجيه الحرج.

    للحصول على إسناد قوي، فضل استخدام`ctwa_clid`
    (الذي لا يمكن للمستخدم حذفه) على تحليل`text`
    المعبأ مسبقًا (الذي يمكنهم حذفه).
  </Accordion>

  <Accordion title="لمسات متعددة قبل رسالة واتساب">
    العميل الذي نقر على إعلان CTWA على Facebook يوم الثلاثاء، ولم يرسل رسالة، ثم فتح نفس الإعلان يوم الأربعاء وأرسل رسالة، سيكون لديه`ctwa_clid`
    للنقرة التي تمت يوم الأربعاء في بيانات WhatsApp
    الوصفية. لا يزال إسناد النقرة الأولى/النقرة الأخيرة القياسي لـ HubSpot
    يعمل على UTM
    s الأساسية إذا زار العميل موقعك الإلكتروني أيضًا في الفترة الفاصلة.
  </Accordion>
</AccordionGroup>

## أدلة ذات صلة

* [إعلانات CTWA](/ar/campaigns/click-to-whatsapp-ads) — الإعداد الكامل بما في ذلك واجهة برمجة تطبيقات التحويلات
* [التقارير ولوحات المعلومات](/ar/hubspot/reporting-and-dashboards) — تحويل بيانات الإحالة إلى تقارير
* [إجراءات سير العمل](/ar/hubspot/workflow-actions) — إجراءات سير العمل التي يتم تشغيلها عند وصول رسالة واردة