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

# كيف تعمل إشارات التوسع

> النموذج وراء إشارات توسع Pubrio — المراحل، وكتالوج أنواع الإشارات، والحضور المحلي، والتسجيل، والزخم، والحداثة، والتدفق — مع القيم الدقيقة التي تُعيدها Expansion API.

<Info>
  يقرأ Pubrio كل توسع على طول محاور مستقلة قليلة: **المرحلة** التي بلغتها الشركة، و**الإشارات** وراءها، و**الحضور المحلي** الذي تملكه بالفعل، و**الزخم** و**الحداثة** و**اتجاه التدفق** للتحرك. أعمدة **قيمة API** أدناه هي بالضبط ما ستراه في الاستجابات ويمكنك التصفية عليه. للحصول على قائمة محدَّثة دائمًا، استدعِ نقطة [تصنيف التوسع](/ar/api-reference/endpoint/expansions/types).
</Info>

## مراحل التوسع

يقع كل زوج شركة-وسوق في مرحلة ما. تشكّل المراحل سلّمًا من الاهتمام الأول إلى عملية راسخة بالكامل.

<Frame caption="ترتفع مراحل التوسع في الالتزام — كل منها مدعومة بأنواع إشارات مميزة.">
  <img src="https://mintcdn.com/pubrio/SfmZ4AIyLQF87YBW/images/expansion-stage-ladder.svg?fit=max&auto=format&n=SfmZ4AIyLQF87YBW&q=85&s=a8b79dda50dc8a2f6837a3ec6446a0d9" alt="سلّم المراحل: استكشاف، التزام، توسع، تنمية — ترتفع في الالتزام، مع بصمة راسخة بعدها." width="760" height="320" data-path="images/expansion-stage-ladder.svg" />
</Frame>

<Steps>
  <Step title="الاستكشاف" icon="binoculars">
    `exploring` — اهتمام مبكر: نشاط إعلاني أو إخباري موجَّه للمنطقة، قبل أي التزام.
  </Step>

  <Step title="الالتزام" icon="seedling">
    `committing` — موارد تُضخ: شراكات، بنية تحتية، وأعمال تأسيسية أخرى.
  </Step>

  <Step title="التوسع" icon="plane-arrival">
    `expanding` — يتشكّل موطئ قدم: توظيف محلي، قيادة في المنطقة، أو مكتب فعلي.
  </Step>

  <Step title="التنمية" icon="building-circle-check">
    `scaling` — تشغيل فعلي: تنمية الفريق وإطلاق منتجات محليًا.
  </Step>
</Steps>

<Note>
  لا يرفع نشاط واحد شركة إلى مرحلة أعلى — يبحث Pubrio أولًا عن نمط مدعَّم بأدلة متعددة.
</Note>

<Frame caption="المراحل الأربع نفسها، مباشرة على خريطة توسع شركة — كل سوق مثبَّتة ومُلوَّنة حسب موضعها على السلّم.">
  <img src="https://mintcdn.com/pubrio/D7-S_msGUHbXRYZf/images/expansion/global-expansion-map.png?fit=max&auto=format&n=D7-S_msGUHbXRYZf&q=85&s=2b2d2c846fc700626e4041942149e96e" alt="خريطة التوسع العالمي لشركة مع أسواق موزَّعة حسب المرحلة، إلى جانب مفتاح مراحل يعرض أعداد الاستكشاف، والالتزام، والتوسع، والتنمية" width="3022" height="1570" data-path="images/expansion/global-expansion-map.png" />
</Frame>

## محوران: إشارات التوسع مقابل الحضور المحلي

يقرأ Pubrio موقع شركة على **محورين مستقلين**، وتُظهر الواجهة كليهما — لهذا يمكن لنفس الشركة أن تُظهر مرحلة توسع نشطة *و*بصمة محلية راسخة في آنٍ واحد.

<Columns cols={2}>
  <Card title="مرحلة الإشارة" icon="wave-pulse">
    مشتقة من **إشارات** توسع نشطة — توظيف، إعلانات، أخبار، مكتب جديد. تجيب على *"ماذا تفعل الشركة لدخول هذا السوق الآن؟"* (`exploring` → `scaling`).
  </Card>

  <Card title="الحضور المحلي" icon="location-dot">
    مشتقة من **البصمة** الفعلية للشركة — حجم فريقها المرصود في السوق وأي مكتب معروف. تجيب على *"ماذا تملك الشركة على الأرض بالفعل؟"*
  </Card>
</Columns>

لا يتفق المحوران دائمًا، وهذا مقصود:

* يمكن أن تكون شركة في مرحلة **`committing` أو `expanding` حسب الإشارات** بينما تُظهر بالفعل **فريقًا محليًا** كبيرًا الحجم — لديها موطئ قدم وتعمّقه بنشاط، لا تدخل بشكل بارد. تقرأ طبقة الحضور السوقي هذا كـ*تنمية*/*تعميق* بدلًا من دخول جديد.
* يظهر سوق فيه حضور محلي حقيقي لكن **دون إشارات توسع نشطة** بـ\*\*`presence.level` بقيمة `established`\*\* — مشغِّل عريق لا يقوم بتحركات جديدة الآن. تُستبعد هذه افتراضيًا من عروض التوسع الجديد؛ أدرِجها (`is_include_established`) عندما تريد البصمة الكاملة.

<Tip>
  تصف `exploring` / `committing` / `expanding` / `scaling` **الحركة**؛ بينما تصف `established` وطبقة الحضور **البصمة**. اقرأهما معًا لمعرفة ما إذا كانت شركة تدخل حديثًا، أم تعمّق حضورها، أم مستقرة ببساطة.
</Tip>

## أنواع الإشارات

يشير كل نوع إشارة إلى المرحلة التي يدل عليها بقوة أكبر. أنواع الإشارات المتميزة (Premier) هي مؤشرات أعلى أهمية.

<CardGroup cols={3}>
  <Card title="الإعلانات" icon="bullhorn">
    `AD` · استكشاف · قياسي<br />حملات مستهدفة لجمهور السوق.
  </Card>

  <Card title="الأخبار" icon="newspaper">
    `NEWS` · استكشاف · قياسي<br />تغطية التمويل، الشراكات، والإطلاق المرتبطة بالمنطقة.
  </Card>

  <Card title="استثمار رأسمالي" icon="money-bill-trend-up">
    `INFRA` · التزام · **متميز**<br />رأسمال ملتزَم به في السوق عبر الاستثمارات والاستحواذات.
  </Card>

  <Card title="بصمة سحابية" icon="cloud">
    `DNS` · التزام · **متميز**<br />بنية تحتية سحابية مرصودة في السوق.
  </Card>

  <Card title="الشراكات" icon="handshake">
    `PARTNER` · التزام · قياسي<br />شراكات محلية وعلاقات قنوات توزيع.
  </Card>

  <Card title="المشاركة/التحدث في فعاليات" icon="microphone">
    `EVENT_PLUS` · التزام · **متميز**<br />التحدث أو المشاركة في فعالية في السوق المستهدفة.
  </Card>

  <Card title="توظيف قيادي" icon="user-tie">
    `EXEC` · توسع · قياسي<br />أدوار قيادية مقرها في السوق.
  </Card>

  <Card title="مكتب/حضور" icon="building">
    `OFFICE` · توسع · قياسي<br />مكتب فعلي أو حضور مسجَّل.
  </Card>

  <Card title="توظيف محلي" icon="user-plus">
    `HIRE` · توسع · قياسي<br />أدوار تشغيلية مُعلَنة في السوق.
  </Card>

  <Card title="التنمية" icon="users">
    `SCALE` · تنمية · قياسي<br />تنمية الفريق المحلي والعمليات.
  </Card>

  <Card title="إطلاق منتج" icon="rocket">
    `PRODUCT` · تنمية · قياسي<br />منتجات أو خدمات أُطلقت محليًا.
  </Card>
</CardGroup>

<Note>
  غالبًا ما تكون إشارات التوظيف (`HIRE`، `EXEC`) أبكر دليل ملموس على تحرك سوقي، وغالبًا ما تخبرك *بأي وظيفة* تتوسع — المبيعات، أو الهندسة، أو العمليات — عبر بيانات الوظيفة الأساسية.
</Note>

## درجة التوسع والثقة

<Columns cols={2}>
  <Card title="درجة التوسع" icon="ranking-star">
    مدى أهمية ونشاط التوسع. رتّب حسبها بحيث يرتفع أكثر المتحركين حسمًا إلى أعلى السوق.
  </Card>

  <Card title="الثقة" icon="shield-check">
    مقدار الأدلة الداعمة الموجودة — الشركة التي لديها عدة إشارات مستقلة تُقرَأ بثقة أكبر من تلك المعتمدة على مصدر واحد.
  </Card>
</Columns>

## الزخم، الحداثة، والتدفق

بعد المرحلة، يحمل كل توسع زخمًا وحداثة واتجاه تدفق. هذه مرشحات مستقلة تجمع بينها للتعبير عن استعلامك بدقة.

<Tabs>
  <Tab title="الزخم">
    مسار التحرك عبر المراحل.

    | الزخم  | قيمة API     | المعنى                             |
    | ------ | ------------ | ---------------------------------- |
    | جديد   | `new`        | ظهر للتو.                          |
    | متقدم  | `advancing`  | يتقدم عبر المراحل — يتسارع للداخل. |
    | ثابت   | `steady`     | مستمر بمستوى ثابت.                 |
    | متراجع | `retreating` | يضعف أو ينعكس — ربما ينسحب.        |
  </Tab>

  <Tab title="الحداثة">
    مدى حداثة الدليل، بحيث لا تُخلط إشارة قوية لكن قديمة بإشارة حالية.

    | الحداثة | قيمة API  | عمر الدليل         |
    | ------- | --------- | ------------------ |
    | حديثة   | `fresh`   | خلال \~30 يومًا    |
    | تبرد    | `cooling` | \~30–60 يومًا      |
    | قديمة   | `stale`   | \~60–90 يومًا      |
    | باردة   | `cold`    | أقدم من \~90 يومًا |
  </Tab>

  <Tab title="التدفق">
    أي جانب من التوسع تنظر إليه، بالنسبة للأسواق التي تهمك.

    | التدفق | قيمة API   | يحدد                                      |
    | ------ | ---------- | ----------------------------------------- |
    | وارد   | `inbound`  | الشركات المتوسعة **إلى** الأسواق المحددة. |
    | صادر   | `outbound` | الشركات المتوسعة **من** الأسواق المحددة.  |
    | الكل   | `all`      | كلا الاتجاهين.                            |
  </Tab>

  <Tab title="القوة">
    مدى قوة دليل فردي واحد.

    | القوة      | قيمة API    | المعنى         |
    | ---------- | ----------- | -------------- |
    | منخفضة     | `low`       | دليل ضعيف.     |
    | متوسطة     | `medium`    | دليل معتدل.    |
    | عالية      | `high`      | دليل قوي.      |
    | عالية جدًا | `very_high` | دليل قوي جدًا. |
  </Tab>
</Tabs>

<Warning>
  اتجاه التدفق (`inbound` / `outbound`) **ليس** نفسه الزخم (`advancing` / `retreating`). التدفق يتعلق بـ*أي جانب من الحدود* تنظر إليه؛ أما الزخم فيتعلق بـ*ما إذا كان التحرك يتسارع أم يتباطأ*.
</Warning>

## القطبية: توسع مقابل انكماش

تشير معظم الإشارات إلى النمو، لكن Pubrio يكتشف أيضًا **الانكماش** — دليلًا على أن شركة تقلّص نشاطها. تحمل كل إشارة **قطبية**، بحيث يمكنك رصد التراجعات بوضوح كما ترصد التقدم (مفيد لمراقبة مخاطر فقدان العملاء).

| القطبية | قيمة API                                                               | المعنى                               |
| ------- | ---------------------------------------------------------------------- | ------------------------------------ |
| توسع    | `expansion`                                                            | دليل على النمو في السوق.             |
| انكماش  | `contraction_leading`، `contraction_confirming`، `contraction_lagging` | تقليص، من أول مؤشر إلى تراجع مؤكَّد. |

## تجميع كل ذلك معًا

<Tip>
  عادةً ما يكون العميل المحتمل عالي القيمة إشارة **حديثة**، و**متقدمة**، و**عالية القوة** في **المرحلة** التي تطابق عرضك، وتتدفق في **الاتجاه** الذي يناسب إقليمك — مقارنةً بالحضور المحلي لمعرفة ما إذا كان دخولًا باردًا أو تعميقًا لفريق قائم. تُظهر Expansion API كل واحد من هذه كمرشح وحقل.
</Tip>

<CardGroup cols={2}>
  <Card title="مرجع الحقول" icon="list" href="/ar/knowledge-base/concepts/expansion-field-reference">
    كل مرشح طلب وحقل استجابة، مع الأنواع والقيم.
  </Card>

  <Card title="مثال عملي" icon="route" href="/ar/knowledge-base/concepts/expansion-signals-example">
    تتبّع توسع شركة واحدة من البداية إلى النهاية.
  </Card>
</CardGroup>
