ट्यूटोरियल: iOS Ads कन्वर्ज़न मेज़र करना

तीसरा चरण: Google Analytics का इस्तेमाल करके, ऑन-डिवाइस कन्वर्ज़न मेज़रमेंट शुरू करना

अब आपके पास उपयोगकर्ताओं के ईमेल पते और फ़ोन नंबर इकट्ठा करने की सुविधा है. साथ ही, आपके ऐप्लिकेशन में Google Analytics SDK टूल भी है. ऐसे में, इन दोनों का इस्तेमाल करके कन्वर्ज़न मेज़र करना शुरू किया जा सकता है.

एपीआई को कॉल करना

सहमति वाले ईमेल पते या फ़ोन नंबर की मदद से, कन्वर्ज़न मेज़रमेंट एपीआई को कॉल करें. यह जानकारी, पहले चरण में इकट्ठा की जाती है. इसका इस्तेमाल, विज्ञापनों से होने वाले कन्वर्ज़न को मेज़र करने के लिए किया जाता है. साथ ही, यह पक्का करें कि उपयोगकर्ता के डिवाइस से, व्यक्तिगत पहचान से जुड़ी कोई भी जानकारी न भेजी जाए.

मेज़रमेंट शुरू करने के दो तरीके हैं:

• क्रेडेंशियल का इस्तेमाल करना
• हैश किए गए क्रेडेंशियल का इस्तेमाल करना

ईमेल पते या फ़ोन नंबर का इस्तेमाल करना

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

हैश किए गए ईमेल पते या फ़ोन नंबर का इस्तेमाल करना

एपीआई, SHA256 का इस्तेमाल करके हैश किए गए ईमेल पतों और फ़ोन नंबरों को स्वीकार करेगा. एसडीके टूल को कॉल करने से पहले, अपने कोड में हैशिंग करके उपयोगकर्ता के डेटा पर कंट्रोल बनाए रखा जा सकता है.

हैश किए गए क्रेडेंशियल का इस्तेमाल करने के लिए, पतों और नंबरों को नॉर्मलाइज़ करें. इसके बाद, SHA256 का इस्तेमाल करके उन्हें हैश करें. फिर एपीआई को कॉल करें.

ईमेल पतों और फ़ोन नंबरों को नॉर्मलाइज़ करना

ईमेल पतों के लिए, Google Analytics API यह मानकर चलता है कि SHA2}101}खास तरह का नॉर्मलाइज़ेशन किया गया है. इसलिए, अपने डेटा को नॉर्मलाइज़ करने के लिए, यह तरीका अपनाएं:

1. पूरे ईमेल पते को लोअरकेस में बदलें.

2. अगर ईमेल पता डोमेन @googlemail.com पर खत्म होता है, तो डोमेन @googlemail.com को @gmail.com से बदलें.

3. @gmail.com डोमेन पर खत्म होने वाले पतों के लिए (इनमें वे पते भी शामिल हैं जिनमें पिछले चरण में बदलाव किया गया है):

   1. उपयोगकर्ता नाम वाले हिस्से से सभी पीरियड हटाएं.

   2. उपयोगकर्ता नाम वाले हिस्से में ये बदलाव करें:

      • अक्षर I या i या अंक 1 के लिए, अक्षर l का इस्तेमाल करें
      • अंक 0 के लिए, अक्षर o का इस्तेमाल करें
      • अंक 2 के लिए, अक्षर z का इस्तेमाल करें
      • अंक 5 के लिए, अक्षर s का इस्तेमाल करें

उदाहरण के लिए, नॉर्मलाइज़ेशन के बाद:

• an.email.user0125@googlemail.com बदलकर anemalluserolzs@gmail.com हो जाता है
• CAPSUSER0125@provider.net बदलकर capsuser0125@provider.net हो जाता है

फ़ोन नंबरों के लिए, SHA256 का इस्तेमाल करके हैश करने से पहले, नंबर E.164 फ़ॉर्मैट में होने चाहिए. इसका मतलब है कि इनमें सबसे पहले प्लस का निशान (+), फिर देश का कोड (1 से 3 अंक) और आखिर में ग्राहक का नंबर (ज़्यादा से ज़्यादा 12 अंक) होना चाहिए.

ध्यान दें कि SHA256 का इस्तेमाल करके हैश किए गए ईमेल या फ़ोन नंबर 32 बाइट के होने चाहिए. साथ ही, यह हेक्साडेसिमल स्ट्रिंग नहीं होनी चाहिए.

हैश किए गए क्रेडेंशियल की मदद से एपीआई को कॉल करना

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

इंटिग्रेशन की पुष्टि करना

डीबग मोड चालू करें. मेज़रमेंट एपीआई शुरू करने को कॉल करने के बाद, पक्का करें कि Xcode के डीबग कंसोल में, लॉग मैसेज इस तरह दिखे:

[FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

अगर आपने डीबग मोड चालू किया है और -DebugOnDeviceConversionMeasurement लॉन्च आर्ग्युमेंट शामिल किया है, तो initiateOnDeviceConversionMeasurement() एपीआई को कॉल करने पर, मैच की प्रोसेस सिम्युलेट की जाएगी.

[FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

arrow_back_iosदूसरा चरण: Google Analytics चौथा चरण: आम तौर पर होने वाली समस्याएं हल करनाarrow_forward_ios