Firebase 将于 5 月 14 日重返 Google I/O 大会！
立即报名。
إنشاء حملة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل البدء
تأكَّد من إكمال الخطوات الواردة في البدء لضمان توفُّر تطبيق مفعَّل فيه Firebase وإضافة أحدث إصدار من Firebase In-App Messaging
SDK.
إنشاء حملة جديدة
يمكنك إعداد حملتك الجديدة في صفحة "الرسائل" ضمن Firebase.
- إذا كنت مستخدمًا جديدًا، انقر على إنشاء حملتك الأولى.
- إذا لم يكن الأمر كذلك، انقر على حملة جديدة.
الخطوة 1: النمط والمحتوى
في وحدة التحكّم، استخدِم نماذج الرسائل Firebase In-App Messaging لدمج ميزات مختلفة تخدم أغراضًا مختلفة مع رسائلك داخل التطبيق.
استكشاف حالات الاستخدام للاطّلاع على أمثلة حول كيفية تصميم نماذج الرسائل
| نوع نموذج الرسالة |
الميزة |
وصف الميزة |
| بطاقة |
نافذة مشروطة |
الصورة فقط |
بانر |
| lens |
lens |
lens |
lens |
صورة |
قدِّم عنوان URL للصورة يستخدم HTTPS. يمكنك استخدام
Firebase Hosting لاستضافة صورك. |
| lens |
lens |
lens |
lens |
الإجراء |
استخدِم روابط المواقع الإلكترونية أو الروابط لصفحات في التطبيق لإرسال المستخدمين إلى صفحات خارجية أو صفحات معيّنة في تطبيقك. يمكنك استخدام روابط Firebase الديناميكية لإنشاء الروابط لصفحات في التطبيق وإدارتها. تتضمّن نماذج النافذة المنبثقة
والصورة فقط زر X، ما يسمح للمستخدمين
برفض الرسالة. |
| lens |
lens |
|
lens |
لون النص/الخلفية |
خصِّص العناصر المرئية للرسالة من خلال إدخال رمز اللون السداسي العشري أو استخدام تدرّج الألوان للعثور على درجة اللون المحدّدة التي تتطابق مع علامتك التجارية. |
| lens |
lens |
|
lens |
عنوان الرسالة أو نصها |
اجذب انتباه المستخدمين من خلال عنوان ذي صلة ووصف موجز. تترجم Firebase النص وتغيّر حجمه تلقائيًا بما يتناسب مع المستخدمين. |
| lens |
lens |
|
|
الزر الأساسي |
تم ضبط الإجراء التلقائي للزر على إغلاق الرسالة. قدِّم عنوان URL لإعادة توجيه المستخدمين إليه كإجراء. |
| lens |
|
|
|
الزر الثانوي |
تم ضبط الإجراء التلقائي للزر على إغلاق الرسالة. قدِّم عنوان URL لإعادة توجيه المستخدمين إليه كإجراء. |
في نافذة إنشاء حملة ضمن وحدة تحكّم Firebase، خصِّص رسالتك حسب رغبتك باستخدام الميزات المتاحة لكل نموذج.
على يسار نافذة إنشاء حملة، يمكنك معاينة رسالتك
في الوضع الأفقي أو العمودي على هاتف أو جهاز لوحي.
تقدّم المعاينة داخل وحدة التحكّم فكرة عامة عن طريقة ظهور رسالتك على جهاز جوّال. يختلف عرض الرسالة الفعلي حسب الجهاز.
الاختبار باستخدام جهاز حقيقي للاطّلاع على العرض الدقيق
إذا أردت ذلك، حدِّد بيانات وصفية مخصّصة لحملتك. ستتوفّر هذه البيانات الوصفية على جهة العميل باستخدام عمليات ردّ الاتصال في حزمة تطوير البرامج (SDK) عند عرض حملة للمستخدم.
على سبيل المثال، قد تحتاج إلى وضع علامة على الحملة باستخدام رمز ترويجي يمكنك استخدامه على العميل.
الخطوة 2: استهداف المستخدمين
أدخِل اسمًا لحملتك.
يُستخدَم هذا الاسم في إعداد تقارير الحملات، وهو ليس جزءًا من الرسالة المرئية.
(اختياري) أدخِل وصفًا للحملة.
يتم استخدام هذا الوصف في تقارير الحملة، وهو ليس جزءًا من الرسالة المرئية.
انقر على القائمة المنسدلة اختيار تطبيق وحدِّد التطبيق الذي تريد ربطه بهذه الحملة.
(اختياري) انقر على الزر و لتضييق نطاق المستخدمين المستهدَفين بشكل أكبر.
استخدِم القائمة المنسدلة اختيار لاختيار مواصفات إضافية.
اطّلِع على النسبة المئوية للمستخدمين المحتملين المؤهّلين لهذه الحملة.
يتم تقدير هذا الرقم استنادًا إلى المستخدمين النشطين الذين تواصلوا مع الخدمة خلال آخر 7 أيام. لا تظهر هذه الرسالة للمستخدمين المؤهّلين إلا عند استيفاء شرط مشغّل.
(اختياري) إذا كان تطبيقك يستهدف المستخدمين بلغات متعدّدة، سيُطلب منك ترجمة الحملة إلى تلك اللغات. استخدِم مربّع الحوار
إما لإضافة ترجماتك الخاصة أو استخدام "ترجمة Google" لتحديد اللغة
المناسبة للحملة بسهولة.
الخطوة 3: تحديد جدول زمني لرسالتك
قدِّم وصفًا لتاريخ ووقت بدء حملتك.
يمكن أن تبدأ حملتك عند نشرها أو عند حلول موعد بدء مُجدوَل.
أدخِل تاريخ ووقت انتهاء حملتك.
يمكن أن تستمر حملتك إلى أجل غير مسمى أو أن يكون لها نقطة نهاية محدّدة.
انقر على "حدث +" لإضافة حدث مشغِّل واحد على الأقل.
- يمكنك إدخال أحداث تلقائية أو أحداث تم تسجيلها من خلال "إحصاءات Firebase" لتفعيل رسالتك داخل التطبيق. ويمكن أن تكون هذه الأحداث إجراءات يتّخذها المستخدم أو أحداثًا في النظام أو أخطاء.
- يتم تشغيل رسالتك داخل التطبيق عند وقوع أيّ من أحداثك.
حدِّد الحدّ الأقصى لعدد مرات الظهور على كل جهاز. يسمح لك الحدّ الأقصى بالتحكّم في عدد المرّات التي تظهر فيها رسالتك للمستخدمين.
- لا يتم عرض الحملة تلقائيًا بعد أن يراها المستخدم (أي تظهر له) مرة واحدة.
- أو يمكنك ضبط معدّل تكرار الرسائل بالأيام.
الخطوة 4: أحداث الإحالات الناجحة (اختيارية)
يتتبّع Firebase عدد مرّات الظهور التي تؤدي إلى حدث إحالة ناجحة مكتملة.
في نافذة إنشاء الحملة، استخدِم القائمة المنسدلة اختيار حدث الإحالة الناجحة للاختيار من بين ما يلي:
بعد نشر الحملة، انتقِل إلى
صفحة المراسلة
وانقر على اسم الحملة للاطّلاع على البيانات ذات الصلة بسجلّ الإحالات الناجحة للحملة.
نشر حملتك
بعد تعديل حملتك، يمكنك النقر على حفظ كمسودة للرجوع إلى الحملة وتعديلها في حالة المسودة.
أو يمكنك النقر على نشر لإتاحة رسالتك للمستخدمين المستهدَفين في التاريخ المحدّد. يمكنك تعديل حملتك بعد نشرها.
بعد إيقاف حملة تم نشرها، لن تتمكّن من نشرها مرة أخرى.
ومع ذلك، يمكنك إيقاف حملة نشطة أو تعديلها في أي وقت. يمكنك أيضًا إنشاء نسخة طبق الأصل من حملة حالية لإجراء تغييرات طفيفة وتجنُّب إنشاء حملات جديدة تمامًا.
الحصول على إحصاءات مستندة إلى الذكاء الاصطناعي لحملات الرسائل باستخدام "Gemini في Firebase"
يقدّم Gemini في Firebase ملخّصات وإحصاءات وإرشادات حول حملات المراسلة لتحسين أداء حملات Firebase Cloud Messaging وIn-App Messaging. من خلال تحليل بيانات الحملات، يمكن أن يساعدك Gemini في Firebase على فهم مدى وصول حملاتك وتأثيرها، كما يقترح استراتيجيات لتحسين تفاعل المستخدمين وزيادة أعدادهم.
الوصول إلى إحصاءات الذكاء الاصطناعي لحملات المراسلة
لاستخدام إحصاءات الذكاء الاصطناعي في "حملات المراسلة"، تأكَّد من أنّ مشروعك يتضمّن ما يلي:
تم تفعيل "Gemini في Firebase" لمشروعك. يمكنك الاطّلاع على مزيد من المعلومات في المقالة إعداد Gemini في Firebase.
Firebase Cloud Messaging أو In-App Messaging مفعّلة في مشروعك على Firebase.
تتوفّر حملة واحدة على الأقل وتظهر في وحدة تحكّم Firebase.
بعد التأكّد من استيفاء هذه المتطلبات:
افتح المراسلة في
وحدة تحكّم Firebase للوصول إلى بيانات الحملة.
بعد تحميل بيانات حملتك، انقر على إنشاء إحصاءات مستندة إلى الذكاء الاصطناعي.
يظهر ملخّص وتحليل لحملات المراسلة.
الأسعار
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة أسعار Gemini in Firebase.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\nBefore you begin\n\nMake sure you complete the steps in [Get\nStarted](/docs/in-app-messaging/get-started) to\nensure you have an app with Firebase enabled and have added the latest Firebase In-App Messaging\nSDK.\n\nCreate a new campaign\n\nSet up your new campaign in the Firebase console's\n[Messaging page](https://console.firebase.google.com/project/_/messaging).\n\n- If you are a first time user, click **Create your first campaign**.\n- If not, click **New campaign**.\n\nStep 1: Style and content\n\nIn the console, use Firebase In-App Messaging message templates to incorporate different\nfeatures to serve different purposes with your in-app messages.\n\n[Explore use cases](/docs/in-app-messaging/explore-use-cases) to see\nexamples for stylizing the messages templates.\n\n\n| Message Template Type |||| Feature | Feature Description |\n| Feature | Feature Description |\n|---------|---------------------|------------|--------|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Card | Modal | Image only | Banner |\n| lens | lens | lens | lens | Image | Provide an HTTPS Image URL. You can use [Firebase Hosting](/docs/hosting) to host your images. |\n| lens | lens | lens | lens | Action | Use weblinks or deep links to send your users to external pages or specific pages in your app. You can use [Firebase Dynamic Links](/docs/dynamic-links) to create and manage deep links. Templates **Modal** and **Image only** include an X button, allowing users to dismiss the message. |\n| lens | lens | | lens | Text/background color | Customize the message visuals by entering the Hex Color Code or using the color gradient to find the specific hue that matches your brand. |\n| lens | lens | | lens | Message title/body | Catch your user's attention with a relevant header and a concise description. Firebase automatically translates and scales your text to accommodate your users. |\n| lens | lens | | | Primary button | The default button action is set to dismiss the message. Provide a URL to redirect users as the action. |\n| lens | | | | Secondary button | The default button action is set to dismiss the message. Provide a URL to redirect users as the action. |\n\n\u003cbr /\u003e\n\n1. In Firebase console's **Compose campaign** window, customize your\n message to your liking with the features available to each template.\n\n2. On the right-hand side of the **Compose campaign** window, preview your message\n in landscape or portrait orientation for a phone or tablet device.\n\n The in-console preview provides a general idea of how your message appears\n on a mobile device. Actual message rendering varies depending on the device.\n [Test with a real device to see the exact rendering](/docs/in-app-messaging/get-started#send_a_test_message).\n3. If desired, define custom metadata for your campaign. This metadata will be available\n on the client side using SDK callbacks when a campaign is displayed to a user.\n For example, you might want to tag the campaign with a promo code that\n you can use on the client.\n\nStep 2: Target your users\n\n1. Enter a name for your campaign.\n\n This name is used for campaign reporting and is not part of the visible\n message.\n2. (Optional) Provide a campaign description.\n\n This description is used for campaign reporting and is not part of the visible\n message.\n3. Click on the **Select app** dropdown and identify which\n app you want to associate with this campaign.\n\n4. (Optional) Click the **and** button to further narrow down your\n target users.\n\n Use the **Select** dropdown to choose additional specifications.\n5. View the percentage of potential users that are eligible for this\n campaign.\n\n This number is estimated based on active users who contacted the service\n in the last 7 days. Eligible users only see this message if a trigger\n condition occurs.\n6. (Optional) If your app targets users in multiple languages, you will be\n prompted to localize the campaign in those languages. Use the dialog to\n either add your own translations or use Google Translate to localize the\n campaign easily.\n\nStep 3: Scheduling your message\n\n1. Describe a start date and time for your campaign.\n\n Your campaign can start when you publish the campaign or have a scheduled\n start.\n2. Describe an end date and time for your campaign.\n\n Your campaign can run indefinitely or have a scheduled endpoint.\n3. Click Event + to add at least one trigger event.\n\n - You can enter default events or [events logged through Firebase Analytics](/docs/analytics/android/events) to trigger your in-app message. These events can be user actions, system events, or errors.\n - Your in-app message is triggered when any of your events occur.\n4. Specify your per-device frequency limit. The limit allows you to\n control how often your users see your message.\n\n - By default, a campaign is not shown after it has been viewed by (that is, impressed on) the user once.\n - Or, you can set the frequency of messages in days.\n\nStep 4: Conversion events (optional)\n\nFirebase tracks the number of impressions that result in a completed conversion\nevent.\n\n1. In the **Compose campaign** window, use the **Select conversion event**\n dropdown to choose from:\n\n - The default conversion events.\n - Any [events you enabled as conversions](https://support.google.com/firebase/answer/6317522#enable).\n2. After you publish the campaign, go to the\n [Messaging page](https://console.firebase.google.com/project/_/messaging)\n and click on the campaign's name to see data related to the\n campaign's conversion history.\n\nPublishing your campaign\n\nAfter modifying your campaign, you can click **Save as draft** for the option to\nreturn and edit the campaign in draft status.\n\nOr, you can click **Publish** to release your message to targeted users on the\nscheduled date. You can edit your campaign after it has been published.\n\nOnce you stop a published campaign, you will not be able to publish it again.\nHowever, you may stop or edit a running campaign at any time. You can also\nduplicate an existing one to make slight variations and avoid creating a\ncompletely new campaigns.\n\nGet AI insights for messaging campaigns with Gemini in Firebase\n\nGemini in Firebase\nprovides messaging campaign summarization, insights,\nand guidance to improve your Firebase Cloud Messaging and In-App Messaging\ncampaign performance. By analyzing campaign data,\nGemini in Firebase can help you understand your campaigns' reach and impact\nand suggests strategies to improve user engagement and growth.\n\nAccess AI insights for messaging campaigns\n\nTo use messaging campaign AI insights, make sure that your project has the\nfollowing:\n\n- Gemini in Firebase is enabled for your project. Learn more at\n [Set up Gemini in Firebase](/docs/gemini-in-firebase/set-up-gemini).\n\n- Firebase Cloud Messaging or In-App Messaging is enabled in your Firebase\n project.\n\n- At least one campaign exists and appears in the Firebase console.\n\nAfter ensuring these requirements are met:\n\n1. Open [**Messaging**](//console.firebase.google.com/project/_/messaging) in the\n Firebase console to access campaign data.\n\n2. After your campaign data loads, click **Generate AI insights**.\n\n A summary and analysis of your messaging campaigns appears.\n\nPricing\n\nSee\n[Gemini in Firebase pricing](/docs/gemini-in-firebase#pricing) for more\ninformation."]]
