Учебное пособие: использование собственных данных для измерения конверсий Google Ads в ваших кампаниях приложений iOS
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Учебное пособие по решению
Измерение конверсий на устройстве от Google улучшает количество наблюдаемых конверсий из ваших кампаний приложений iOS, сохраняя при этом конфиденциальность персональных данных пользователей. В этом руководстве вы узнаете, как работает решение, и выполните шаги, необходимые для его внедрения.
Как это работает?
Измерение конверсий на устройстве помогает измерять установки приложений и действия в приложении из ваших кампаний приложений iOS. Google Analytics для Firebase SDK выполняет атрибуцию на устройстве, используя идентификационные данные пользователя, предоставленные при входе в приложение. Идентификационные данные пользователя скрыты благодаря нашему подходу к конверсиям на устройстве, так что никакая персонально идентифицируемая информация никогда не покидает устройство пользователя.
Чтобы использовать эту технологию, вам нужен согласованный, предоставленный пользователем адрес электронной почты или номер телефона. Через API initiateOnDeviceConversionMeasurement() адрес электронной почты или номер телефона используется Google Analytics for Firebase SDK для атрибуции, так что эти персональные данные никогда не отправляются с устройства таким образом, чтобы можно было идентифицировать пользователя или устройство. Функция работает в приложениях под управлением iOS 12+.
Вы можете использовать Firebase Authentication , чтобы разрешить пользователям входить в ваше приложение с помощью одного или нескольких методов входа. После интеграции с Firebase Authentication вы можете получить адрес электронной почты или номер телефона вошедшего в систему пользователя для отправки в Google Analytics для Firebase SDK.
Продукты и функции, используемые в этом руководстве
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.
Инициировать измерение конверсии на устройстве
Вызовите API измерения на устройстве, указав полученный вами адрес электронной почты или номер телефона.
Проверьте работу API с помощью журналов отладки.
Устранение неполадок и решение распространенных проблем
При необходимости устраните неполадки с помощью ресурсов поддержки Firebase Authentication и Google Analytics .
Решайте некоторые часто встречающиеся проблемы.
Что вам понадобится
Ваше собственное приложение, работающее на iOS 12 или выше
Ваше приложение зарегистрировано как приложение Firebase, связанное с Google Analytics и Ads
Ваша предпочтительная IDE
Шаг 1 : Реализация процесса входа в систему arrow_forward_ios
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# Tutorial: Use first-party data to measure Google Ads conversions from your iOS app campaigns\n\n### **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\n#### How 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|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\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\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*** ** * ** ***"]]
