الحملات (الترويج المتبادل)

الحملات هي محرك الترويج المتبادل: تتيح لك الإعلان عن أحد تطبيقاتك داخل تطبيق آخر تملكه، باستخدام الربط «الوحدات الإعلانية لمواضع الإعلانات → الترويج المتبادل» الموضّح في تفاصيل التطبيق.

قائمة الحملات

تعرض صفحة الحملات (/campaigns) جميع الحملات التي أنشأتها في جدول يتضمن: رقم الصف، والعنوان، والتطبيق المستهدف (الاسم والحزمة، ويُعرضان على سطرين)، ونوع الحملة (حاليًا «الترويج المتبادل» دائمًا — يوجد مفهوم «الإعلان عبر الشبكات» في محدد النوع، لكنه غير متاح فعليًا للاختيار)، والحالة والأولوية (تُعرض كل منهما كشارات ملوّنة، ويمكن الفرز حسبهما)، وتاريخ البدء، وتاريخ الانتهاء، وتاريخ الإنشاء، وتاريخ التحديث (يمكن الفرز حسب الأخيرين أيضًا)، والإجراءات (تعديل وحذف).

يمكنك تصفية القائمة حسب حالة الحملة أو الأولوية أو العلامة التجارية المستهدفة، باستخدام محدد ديناميكي متعدد الاختيارات لكل منها. ينقلك تعديل الحملة (إجراء القلم) إلى المعالج الموضّح أدناه في وضع التعديل؛ أما الحذف فيطلب التأكيد أولًا ولا يمكن التراجع عنه.

لا يتوفر زر + إنشاء إلا إذا كانت خطتك لا تزال تسمح بإنشاء حملة ترويج متبادل إضافية (canCreateCampaign()). إذا بلغت الحد الأقصى للحملات في خطتك، يحل محله مؤشر استخدام («تم استخدام X/Y من الحملات») ورابط «🔒 ترقية» ينقلك إلى الاشتراك.

إنشاء حملة أو تعديلها — المعالج

يؤدي النقر على + إنشاء (أو تعديل حملة حالية) إلى تشغيل معالج خطوة بخطوة. يتكون المعالج من خمس خطوات، وليس أربعًا — يسهل الخطأ في عدّها لأن الخطوة الأولى تُتخطى تلقائيًا عند تعديل حملة حالية (إذ لا يمكن تغيير نوع الحملة بعد إنشائها). تتبع جميع خطوات المعالج النمط نفسه: «مسودة، ثم حفظ». أثناء تعبئة إحدى الخطوات، تبقى تعديلاتك في الحالة المحلية لمكوّن تلك الخطوة فقط. لا تُكتب أي بيانات في السياق المشترك للمعالج — ولا يُحفظ أي شيء على الخادم — حتى تنقر على زر للحفظ وينجح استدعاء API المقابل. إذا حاولت مغادرة الخطوة مع وجود تعديلات غير محفوظة، تظهر رسالة تأكيد «لديك تغييرات غير محفوظة. هل تريد المغادرة بالتأكيد؟» (نعم، مغادرة / البقاء) لحمايتك من فقدان عملك.

الخطوة 1 — تحديد نوع الحملة

تحتوي على بطاقة واحدة قابلة للاختيار: الترويج المتبادل («روّج لتطبيقاتك لدى مستخدمي تطبيقاتك الأخرى»). هذا هو الخيار الفعلي الوحيد — يوجد نوع ثانٍ باسم «الإعلان عبر الشبكات» في الشيفرة الأساسية كعنصر نائب للاستخدام مستقبلًا، لكنه غير قابل للاختيار حاليًا في واجهة المستخدم. ينقلك النقر على التالي إلى الخطوة التالية؛ ولا تُجري هذه الخطوة أي استدعاء للخادم بمفردها، إذ لا يُنشأ أي شيء حتى الخطوة 2. في وضع التعديل، تُتخطى هذه الخطوة بالكامل — ويُفتح المعالج مباشرةً على الخطوة 2، مع تثبيت نوع الحملة الحالية مسبقًا.

الخطوة 2 — إعدادات الحملة

تُستخدم هذه الخطوة لإنشاء الحملة (عند الحفظ لأول مرة في وضع الإنشاء)، ولتعديل إعداداتها الأساسية (في وضع التعديل). الحقول:

• مفتاح تبديل حالة الحملة — في وضع التعديل فقط. يبدّل بين «نشطة» و«متوقفة مؤقتًا» (مع مربع حوار للتأكيد في الحالتين: «تنشيط الحملة؟» / «إيقاف الحملة مؤقتًا؟»). عند محاولة تنشيط حملة، يُتحقق قبل الحفظ من أنها تحتوي على مادة إعلانية واحدة على الأقل، وأن واحدة على الأقل من موادها الإعلانية نشطة — وإلا فسيُمنع التنشيط مع ظهور الرسالة «لا يمكن تنشيط الحملة — يُرجى إضافة مادة إعلانية واحدة على الأقل أولًا» أو «...يجب أن تكون هناك مادة إعلانية واحدة على الأقل بحالة نشطة»، ولن يسري التبديل.
• عنوان الحملة — حقل نصي مطلوب.
• تحديد العلامة التجارية — قائمة منسدلة مطلوبة بعلاماتك التجارية. يؤدي تغيير العلامة التجارية إلى مسح التطبيق المحدد في «التطبيق المراد الترويج له»، لأن قائمة التطبيقات تعتمد على العلامة التجارية.
• التطبيق المراد الترويج له — قائمة منسدلة مطلوبة، تُعبّأ بناءً على العلامة التجارية المحددة؛ وتكون معطّلة حتى تختار علامة تجارية.
• أولوية الحملة — عالية / متوسطة / منخفضة، وتُعرض كثلاثة أزرار بيضاوية قابلة للاختيار؛ والقيمة الافتراضية هي «متوسطة».
• بدء الحملة — إما «فورًا» أو تاريخ محدد. إذا اخترت تاريخًا، فلا يمكن أن يكون في الماضي (يُقارن بتاريخ اليوم)، إلا أن هذا التحقق يُتخطى في وضع التعديل إذا لم تغيّر التاريخ المحفوظ بالفعل.
• انتهاء الحملة — إما «بدون (لا يوجد تاريخ انتهاء)» أو تاريخ محدد، مع تطبيق قاعدة عدم السماح بتاريخ في الماضي نفسها، إضافةً إلى التحقق من أن تاريخ الانتهاء يأتي بعد تاريخ البدء.

قفل الحقول أثناء نشاط الحملة: بمجرد أن تصبح الحملة نشطة، لا يمكنك تغيير العلامة التجارية أو التطبيق المراد الترويج له أو تاريخ البدء/إعداد «فورًا» — إذ تُعطّل هذه الحقول مع ملاحظة توضيحية صغيرة («...لا يمكن تغييره أثناء نشاط الحملة»). يظل بإمكانك تغيير العنوان والأولوية وتاريخ الانتهاء، وإيقاف الحملة مؤقتًا (عبر مفتاح التبديل).

عند الحفظ (حفظ والتالي في وضع الإنشاء؛ وحفظ في وضع التعديل)، يُرسَل إلى الخادم كل من العنوان والتطبيق المستهدف ونوع الحملة والأولوية وتاريخَي البدء والانتهاء المحسوبَين، إضافةً إلى الحالة في وضع التعديل. عند الإنشاء لأول مرة، تُستخدم بيانات النشر/المناطق الموجودة في الاستجابة (إن وُجدت) لتعبئة الحالة الأولية للخطوة 3 مسبقًا. ولا يُكتب أي من ذلك في السياق المشترك للمعالج إلا بعد نجاح استدعاء API.

الخطوة 3 — الاستهداف

يتكون الاستهداف فعليًا من قسمين فرعيين مستقلين يشتركان في خطوة واحدة وزر حفظ واحد: النشر (أي من علاماتك التجارية/تطبيقاتك سيعرض هذه الحملة) والمناطق (البلدان التي ستُعرض فيها).

النشر. تختار، عبر قوائم مربعات الاختيار، أحد الخيارين:

• جميع العلامات التجارية — مربع اختيار رئيسي واحد يعني أن الحملة يمكن أن تظهر في جميع العلامات التجارية والتطبيقات التي تملكها، بما فيها ما يُضاف لاحقًا.
• علامات تجارية محددة — اختيار علامة تجارية واحدة أو أكثر من قائمة قابلة للتمرير، ولكل منها قائمة فرعية بتطبيقاتها. داخل العلامة التجارية المحددة، يمكنك اختيار تطبيقات بعينها، أو تحديد مربع «الكل (بما في ذلك التطبيقات المستقبلية)» الخاص بتلك العلامة لتضمين جميع تطبيقاتها (الحالية والمستقبلية) دون اختيارها واحدًا تلو الآخر.

يظهر ملخص محدّث باستمرار لـ«العلامات التجارية المحددة» و«التطبيقات المحددة» على هيئة شرائح فوق قوائم الاختيار، لتتمكن من رؤية الاستهداف الحالي بنظرة سريعة.

المناطق. محدد بلدان متعدد الاختيارات مع اختصار «تحديد الكل»، يُستخدم لتقييد البلدان التي تُعرض فيها الحملة (أو تركها دون تقييد). إذا لم تضع قيودًا، تُعرض الحملة في جميع المناطق. صُمم محدد المناطق هذا ليكون منفصلًا عن ميزة مجموعات المناطق المُسمّاة الموضّحة لاحقًا في هذا الدليل — فهو مجرد اختيار بسيط وغير مُسمّى للبلدان على مستوى كل حملة، وليس مجموعة محفوظة قابلة لإعادة الاستخدام. (إذا تعذّر تحميل قائمة البلدان الديناميكية من الخادم، تُستخدم هنا قائمة احتياطية أصغر تضم 16 بلدًا، ولهذا تبدو خيارات القائمة الاحتياطية في هذا المحدد أقل من نظيرتها في مجموعات المناطق.)

يتبع القسمان الفرعيان سلوك المسودة/الحفظ نفسه المتّبع في بقية المعالج: تبقى التعديلات محلية حتى تنقر على «حفظ» (أو «حفظ والتالي»)، وعندها تُحفظ إعدادات النشر والمناطق عبر استدعاءات API منفصلة لكل منهما، ثم تُدمج في الحالة المشتركة للمعالج.

الخطوة 4 — المواد الإعلانية

هنا ترفع المواد الإعلانية الفعلية التي تظهر عند عرض الحملة.

إضافة مواد إعلانية جديدة. يتيح لك نموذج «إضافة مواد إعلانية جديدة»، المصمم على هيئة جدول، إضافة صف واحد أو أكثر دفعة واحدة (يضيف رابط + إضافة مواد إعلانية صفًا فارغًا آخر؛ وتحذف أيقونة سلة المهملات أحد الصفوف). يحتوي كل صف على:

• الصورة — انقر على المربع الفارغ لرفع صورة. الصيغ المقبولة: JPEG وPNG وJPG وGIF وWebP؛ والحجم الأقصى 10MB. تُرفض الملفات غير المطابقة مع عرض خطأ محدد داخل النموذج (صيغة غير صحيحة، أو «الحد الأقصى 10MB (X.XXMB)» مع إظهار الحجم الفعلي).
• الاسم — نص مطلوب.
• عنوان URL المستهدف — مطلوب؛ ويجب أن يكون عنوان URL صالحًا يبدأ بـhttp:// أو https://، ويُتحقق منه مباشرةً أثناء الكتابة.
• نوع الإعلان — إعلان بيني، أو بانر، أو إعلان مدمج مع المحتوى، أو إعلان بمكافأة، أو إعلان فتح التطبيق (appOpen) (وهي مجموعة التنسيقات الخمسة نفسها المستخدمة للوحدات الإعلانية في المواضع الأخرى).

يؤدي النقر على حفظ والتالي (وضع الإنشاء) أو حفظ (وضع التعديل) إلى التحقق من صحة كل صف غير فارغ، ورفع كل صورة، ثم إنشاء كل مادة إعلانية عبر API. لا تُضاف إلى القائمة المحفوظة إلا المواد الإعلانية التي تنجح العملية الخاصة بها فعليًا؛ وإذا تعذّر حفظ بعضها، فسترى عدد المواد التي فشل حفظها ويمكنك إعادة المحاولة. يلزم وجود مادة إعلانية واحدة على الأقل قبل أن تتمكن من مغادرة هذه الخطوة في وضع الإنشاء.

قائمة المواد الإعلانية المحفوظة. تظهر المواد الإعلانية المحفوظة مسبقًا فوق نموذج الإضافة على هيئة قائمة بطاقات، تعرض كل منها صورة مصغرة (انقر للتكبير)، والاسم، ونوع الإعلان، وعنوان URL المستهدف، وشارة حالة «نشطة/غير نشطة» مع مفتاح تبديل، وزر تعديل (قلم)، وزر حذف (سلة مهملات).

• يُمنع إلغاء تنشيط مادة إعلانية إذا كانت المادة الإعلانية النشطة الوحيدة في الحملة («يجب أن تبقى مادة إعلانية واحدة على الأقل نشطة») — وفي جميع الحالات الأخرى، يُطلب تأكيد بسيط: «تنشيط/إلغاء تنشيط المادة الإعلانية؟».
• يفتح زر التعديل (القلم) نموذج تعديل مضمّنًا لتلك المادة الإعلانية وحدها (الاسم والصورة وعنوان URL المستهدف — أما نوع الإعلان فثابت)، مع زرَّي حفظ/إلغاء خاصَّين به.
• يعرض الحذف الرسالة «لن تتمكن من التراجع عن هذا الإجراء!» قبل إزالة المادة الإعلانية نهائيًا.

الخطوة 5 — مراجعة الحملة

ملخص للقراءة فقط لكل ما أُدخل في الخطوات 2–4: حالة الحملة، والعنوان، والنوع، والعلامة التجارية، والتطبيق المراد الترويج له، والأولوية، وتاريخ البدء، وتاريخ الانتهاء، وملخص للاستهداف في سطر واحد (مثل «جميع العلامات التجارية · جميع التطبيقات»، أو تفاصيل لكل علامة تجارية)، إضافةً إلى المناطق المحددة (شرائح، أو «جميع المناطق»)، والقائمة الكاملة للمواد الإعلانية مع صورها المصغرة وأسمائها وعناوين URL المستهدفة وشارات أنواع الإعلانات.

في وضع الإنشاء فقط، تحتوي هذه الخطوة أيضًا على مفتاح تبديل فعّال للحالة (نشطة/متوقفة مؤقتًا) في أعلاها مباشرةً — وتسري هنا قواعد التنشيط نفسها المطبقة في الخطوة 2 (يُرفض تنشيط حملة لا تحتوي على أي مواد إعلانية أو لا تحتوي على مادة إعلانية نشطة، مع عرض «لا يمكن تنشيط الحملة»). أما في وضع التعديل، فتُعرض الحالة كشارة للقراءة فقط — ويمكنك تغييرها من مفتاح التبديل في الخطوة 2، وليس من هنا.

يُعيدك النقر على إنهاء إلى قائمة الحملات. في وضع التعديل، سترى أولًا رسالة تأكيد موجزة «تم حفظ الحملة بنجاح»؛ أما في وضع الإنشاء، فتعود مباشرةً دون تأكيد إضافي، لأن كل خطوة حُفظت بالفعل أثناء تقدمك.

---