دليل تعليمي: استخدام بيانات الطرف الأول لقياس الإحالات الناجحة في "إعلانات Google" من "حملات تطبيقات iOS"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الدليل التعليمي لحلّ المشاكل
تحسِّن ميزة "قياس الإحالات الناجحة على الجهاز فقط" من Google عدد الإحالات الناجحة
القابلة للملاحظة من "حملات تطبيقات iOS" مع الحفاظ على خصوصية data
الشخصية للمستخدمين في الوقت نفسه. في هذا الدليل التعليمي، ستتعرّف على آلية عمل الحلّ وستتمكّن من اتّباع الخطوات اللازمة لتنفيذه.
كيف تعمل هذه الميزة؟
تساعد ميزة "قياس الإحالات الناجحة على الجهاز فقط" في قياس عمليات تثبيت التطبيقات والإجراءات داخلها
من "حملات تطبيقات iOS". تعمل حزمة تطوير البرامج (SDK) Google Analytics لبرنامج Firebase على تحديد مصدر الإحالة على الجهاز فقط باستخدام هوية المستخدِم التي تقدّمها تجربت تسجيل الدخول في تطبيقك. يتم إخفاء هوية المستخدم من خلال منهجنا المعنيّ بالإحالات الناجحة على الجهاز فقط حتى لا تخرج أي معلومات تحدِّد الهوية الشخصية من
جهاز المستخدم مطلقًا.
لاستخدام هذه التكنولوجيا، تحتاج إلى عنوان بريد إلكتروني أو
رقم هاتف يقدّمه المستخدم ويوافق عليه. من خلال واجهة برمجة التطبيقات initiateOnDeviceConversionMeasurement()، يتم استخدام عنوان البريد الإلكتروني أو رقم الهاتف من قِبل Google Analytics لحزمة تطوير البرامج (SDK) في Firebase لتحديد المصدر، بحيث لا يتم أبدًا إرسال هذه البيانات الشخصية خارج
الجهاز بطريقة يمكن من خلالها تحديد هوية المستخدم أو الجهاز. تعمل هذه الميزة على التطبيقات التي تعمل بالإصدار 12 من نظام التشغيل iOS والإصدارات الأحدث.
يمكنك استخدام Firebase Authentication للسماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام
طريقة واحدة أو أكثر من طرق تسجيل الدخول. بعد الدمج مع Firebase Authentication، يمكنك الحصول على
عنوان البريد الإلكتروني أو رقم الهاتف الخاص بالمستخدم الذي سجّل الدخول لإرساله إلى حزمة تطوير البرامج (SDK) لخدمة Google Analytics
لبرنامج Firebase.
المنتجات والميزات المستخدَمة في هذا البرنامج التعليمي
|
Google Ads
Google Ads تتيح لك زيادة عمليات التثبيت والحصول على
إحصاءات معمّقة عن الإحالات الناجحة للإعلانات وعرض حملات إعلانية مستهدفة باستخدام
شرائح جمهور Google Analytics للتفاعل مع قاعدة المستخدمين.
Google Analytics
Google Analytics تمنحك إحصاءات حول
مقاييس تفاعل المستخدمين والحفاظ عليهم وتحقيق الربح، مثل إجمالي الأرباح،
أرباح AdMob، وأرباح عمليات الشراء، وغير ذلك الكثير. ويسمح لك أيضًا ب
إنشاء شرائح جمهور وشرائح مستخدمين.
|
Firebase Authentication
تقدّم Firebase Authentication خدمات خلفية،
وحِزم تطوير برامج (SDK) سهلة الاستخدام، ومكتبات واجهة مستخدم جاهزة لمصادقة المستخدِمين على
تطبيقك. وتتيح هذه الخدمات المصادقة باستخدام كلمات المرور وأرقام الهواتف ومقدّمي هوية متحدّين مشهورين (مثل Google وFacebook وTwitter) وغير ذلك.
|
نظرة عامة على الدليل التعليمي
الانتقال
مباشرةً إلى الدليل التعليمي المفصّل
تنفيذ
تجربة تسجيل الدخول
استخدِم Firebase Authentication لإنشاء تجربة تسجيل الدخول.
أو يمكنك الجمع بين Firebase Authentication وتجربة تسجيل الدخول المخصّصة.
في واجهة تسجيل الدخول، احصل على عنوان البريد الإلكتروني أو رقم هاتف المستخدم.
دمج
Google Analytics في تطبيقك
اتّبِع خطوات الدمج الخاصة بـ Cocoapods أو Swift Package Manager أو التثبيت
اليدوي.
يمكنك اختياريًا تفعيل وضع تصحيح الأخطاء في Xcode.
بدء
قياس الإحالات الناجحة على الجهاز فقط
اطلب واجهة برمجة التطبيقات لقياس البيانات على الجهاز فقط باستخدام البريد الإلكتروني أو رقم الهاتف الذي جمعته.
تحقّق من وظيفة واجهة برمجة التطبيقات باستخدام سجلات تصحيح الأخطاء.
تحديد المشاكل الشائعة ومعالجتها
إذا لزم الأمر، يمكنك تحديد المشاكل وحلّها باستخدام موارد الدعم المخصّصة لتطبيقَي
Firebase Authentication وGoogle Analytics.
التعامل مع بعض المشاكل الشائعة
المتطلبات
الخطوة 1: تنفيذ تجربة تسجيل الدخولarrow_forward_ios
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["**Solution tutorial**\n\nGoogle's on-device conversion measurement improves the number of observable\nconversions from your iOS app campaigns while keeping users' personal data\nprivate. In this tutorial, you'll learn how the solution works and follow along\nwith the steps needed to implement it.\n\nHow does this work?\n\nOn-device conversion measurement helps measure app installs and in-app actions\nfrom your iOS app campaigns. The Google Analytics for Firebase SDK\nperforms on-device attribution using a user's identity provided by your app's\nsign-in experience. The user's identity is hidden through our on-device\nconversion approach so that no personally identifiable information ever leaves\nthe user's device.\n\nTo use this technology, you need a consented, user-provided email address or\nphone number. Through the `initiateOnDeviceConversionMeasurement()` API, the\nemail address or phone number is used by the Google Analytics for\nFirebase SDK for attribution such that this personal data is never sent off the\ndevice in a way that can identify the user or device. The feature works on apps\nrunning iOS 12+.\n\nYou can use Firebase Authentication to allow users to sign in to your app using\none or more sign-in methods. Once integrated with Firebase Authentication, you can get\nthe signed-in user's email or phone number to send to the Google Analytics\nfor Firebase SDK.\n\nProducts and features used in this tutorial\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Google Ads \u003e [Google Ads](/docs/ads) lets you drive installs, gain deep insights into ad conversions, and run targeted ad campaigns using Google Analytics audiences to engage your user base. Google Analytics \u003e [Google Analytics](/docs/analytics) gives you insight into user engagement, retention, and monetization metrics like total revenue, AdMob revenue, purchase revenue, and much more. It also allows you to create user audiences and segments. | Firebase Authentication \u003e [Firebase Authentication](/docs/auth) provides backend services, easy-to-use SDKs, and ready-made UI libraries to authenticate users to your app. It supports authentication using passwords, phone numbers, popular federated identity providers (like Google, Facebook, and Twitter), and more. |\n\n\u003cbr /\u003e\n\nTutorial overview\n\n[Go\ndirectly to the step-by-step tutorial](/docs/tutorials/ads-ios-on-device-measurement/step-1)\n\n1. [**Implement\n a sign-in experience**](/docs/tutorials/ads-ios-on-device-measurement/step-1)\n\n 1. Use Firebase Authentication to build a sign-in experience.\n\n 2. Or, combine Firebase Authentication with your custom sign-in experience.\n\n 3. In your sign-in interface, get the user's email address or phone number.\n\n2. [**Integrate\n Google Analytics into your app**](/docs/tutorials/ads-ios-on-device-measurement/step-2)\n\n 1. Follow integration steps for Cocoapods, Swift Package Manager or manual\n installation.\n\n 2. Optionally, enable debug mode in Xcode.\n\n3. [**Initiate\n on-device conversion measurement**](/docs/tutorials/ads-ios-on-device-measurement/step-3)\n\n 1. Call the on-device measurement API with the email or phone number you\n gathered.\n\n 2. Verify API function with debug logs.\n\n4. [**Troubleshoot and\n handle common issues**](/docs/tutorials/ads-ios-on-device-measurement/step-4)\n\n 1. If needed, troubleshoot with the help of support resources for\n Firebase Authentication and Google Analytics.\n\n 2. Handle some commonly-encountered issues.\n\nWhat you'll need\n\n- Your own app that can run on iOS 12 or higher\n\n- Your app registered as a Firebase App that's linked to Google Analytics\n and Ads\n\n- Your preferred IDE\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\n[**Step 1** : Implement a sign-in experiencearrow_forward_ios](/docs/tutorials/ads-ios-on-device-measurement/step-1)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n*** ** * ** ***"]]
