Firebase की इन-ऐप्लिकेशन मैसेज की सुविधा का इस्तेमाल शुरू करें

इस क्विकस्टार्ट गाइड में, Firebase In-App Messaging को सेट अप करने और पहला मैसेज भेजने का तरीका बताया गया है.

iOS+ Android Flutter

शुरू करने से पहले

शुरू करने से पहले, पक्का करें कि आपने अपने Apple प्रोजेक्ट में Firebase जोड़ा हो.

अपने प्रोजेक्ट में Firebase In-App Messaging SDK टूल जोड़ना

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.

Apple प्रोजेक्ट में Firebase SDK टूल जोड़ने के अलग-अलग तरीकों के बारे में जानने के लिए, इंस्टॉल करने से जुड़ी हमारी गाइड पढ़ें. इसमें फ़्रेमवर्क को सीधे तौर पर इंपोर्ट करने और CocoaPods का इस्तेमाल करने के तरीके शामिल हैं.

1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, File > Add Packages पर जाएं.
2. जब आपसे कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk.git

ध्यान दें: नए प्रोजेक्ट में, डिफ़ॉल्ट (नवीनतम) एसडीके वर्शन का इस्तेमाल किया जाना चाहिए. हालांकि, ज़रूरत पड़ने पर पुराना वर्शन चुना जा सकता है.
3. In-App Messaging लाइब्रेरी चुनें.
4. टारगेट की बिल्ड सेटिंग के Other Linker Flags सेक्शन में -ObjC फ़्लैग जोड़ें.
5. In-App Messaging का इस्तेमाल करने के लिए, आपको अपने Firebase प्रोजेक्ट में Google Analytics चालू करना होगा. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ना होगा. आपके पास, आईडीएफ़ए इकट्ठा करने की सुविधा के बिना या आईडीएफ़ए इकट्ठा करने की सुविधा के साथ लाइब्रेरी चुनने का विकल्प होता है. Firebase SDK के लिए Google Analytics में मॉड्यूल के नए संगठन के बारे में अक्सर पूछे जाने वाले सवाल देखें.
6. इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करना शुरू कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा.

अब अपने ऐप्लिकेशन में एसडीके टूल को शुरू करें:

1. अगर आपने अब तक Firebase मॉड्यूल इंपोर्ट नहीं किया है, तो इसे अपने App struct या UIApplicationDelegate में इंपोर्ट करें:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. अगर आपने अब तक FirebaseApp शेयर किया गया इंस्टेंस कॉन्फ़िगर नहीं किया है, तो उसे कॉन्फ़िगर करें. आम तौर पर, इसे App के इनिशियलाइज़र या ऐप्लिकेशन डेलिगेट के application(_:didFinishLaunchingWithOptions:) तरीके में कॉन्फ़िगर किया जाता है:

   Swift

   FirebaseApp.configure()

   Objective-C

   [FIRApp configure];

3. अपने ऐप्लिकेशन को कंपाइल और चलाएं.

ध्यान दें: Firebase In-App Messaging के लिए, Firebase 5.6.0 या इसके बाद का वर्शन ज़रूरी है. अगर आपको अपना ऐप्लिकेशन कंपाइल करने में समस्या आ रही है, तो अपने ऐप्लिकेशन की प्रोजेक्ट डायरेक्ट्री में pod update चलाकर देखें. हालांकि, ध्यान रखें कि इस कमांड से आपके ऐप्लिकेशन की सभी डिपेंडेंसी अपडेट हो जाती हैं, सिर्फ़ Firebase की नहीं.

टेस्ट मैसेज भेजना

अपने ऐप्लिकेशन का इंस्टॉलेशन आईडी पाना

बैटरी बचाने के लिए, Firebase In-App Messaging सर्वर से मैसेज सिर्फ़ एक बार फ़ेच करता है. इससे टेस्टिंग में मुश्किल हो सकती है. इसलिए, Firebase कंसोल की मदद से, एक ऐसा टेस्ट डिवाइस चुना जा सकता है जो ज़रूरत पड़ने पर मैसेज दिखाता है.

टेस्टिंग डिवाइस का पता, Firebase इंस्टॉलेशन आईडी से चलता है. यह आईडी, Firebase इंस्टॉलेशन सेवा देती है. अपने टेस्टिंग ऐप्लिकेशन का इंस्टॉलेशन आईडी ढूंढने के लिए, ऐप्लिकेशन को रनटाइम कमांड आर्ग्युमेंट -FIRDebugEnabled के साथ चलाएं:

1. Xcode प्रोजेक्ट खुला होने पर, सबसे ऊपर मौजूद मेन्यू बार में जाकर, Product > Scheme > Edit scheme... को चुनें.
2. इसके बाद, पॉप-अप होने वाले डायलॉग बॉक्स का Arguments टैब खोलें.
3. लॉन्च के दौरान पास किए गए आर्ग्युमेंट में जाकर, + आइटम जोड़ें पर क्लिक करें.
4. अभी-अभी बनाए गए फ़ील्ड में "-FIRDebugEnabled" डालें.
5. बंद करें पर क्लिक करें. इसके बाद, अपना ऐप्लिकेशन चलाएं.

ऐप्लिकेशन चलने के बाद, Xcode कंसोल के लॉग में यह लाइन ढूंढें:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

अपने टेस्टिंग डिवाइस पर मैसेज भेजना

टेस्टिंग डिवाइस पर ऐप्लिकेशन लॉन्च करने और उसका Firebase इंस्टॉलेशन आईडी (एफ़आईडी) मिलने के बाद, टेस्ट मैसेज भेजकर Firebase In-App Messaging सेटअप आज़माया जा सकता है:

1. Firebase कंसोल में, मैसेजिंग पेज खोलें.
2. अगर यह आपका पहला कैंपेन है, तो अपना पहला कैंपेन बनाएं पर क्लिक करें.
   1. Firebase In-App messages को चुनें. इसके बाद, बनाएं पर क्लिक करें.
3. इसके अलावा, कैंपेन टैब में जाकर, नया कैंपेन पर क्लिक करें.
   1. इन-ऐप्लिकेशन मैसेजिंग को चुनें.
4. अपने पहले मैसेज के लिए टाइटल डालें.
5. डिवाइस पर टेस्ट करें पर क्लिक करें
6. अपने ऐप्लिकेशन का Firebase इंस्टॉलेशन आईडी, इंस्टॉलेशन आईडी जोड़ें फ़ील्ड में डालें.
7. मैसेज भेजने के लिए, टेस्ट करें पर क्लिक करें.

Firebase In-App Messaging, जांच करें पर क्लिक करते ही आपका टेस्ट मैसेज भेज देता है. मैसेज देखने के लिए, आपको टेस्टिंग डिवाइस पर ऐप्लिकेशन को बंद करके फिर से खोलना होगा.

यह पुष्टि करने के लिए कि आपका डिवाइस, टेस्ट डिवाइस है या नहीं, इस लॉग मैसेज को देखें:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.