Agora que você vinculou sua conta do Google Ads, pode começar a integrar o
Google Analytics para o SDK do Firebase.
Integrar o SDK do Google Analytics para o Firebase
Faça a integração com a versão mais recente do SDK do Google Analytics para Firebase.
Usar o Cocoapods
Se o app usar o Cocoapods, verifique se o Podfile do projeto contém o
pod GoogleAppAdsOnDeviceConversion, usando o pod
FirebaseAnalytics principal ou incluindo-o explicitamente como um pod independente:
pod'FirebaseAnalytics'# includes GoogleAdsOnDeviceConversion
Em seguida, execute os comandos pod repo update e pod install.
Usar o Swift Package Manager
Se o app usar o Swift Package Manager, siga as etapas em
Swift Package Manager para Firebase.
Quando chegar à etapa "Escolher as bibliotecas do Firebase que você quer incluir no
app", marque FirebaseAnalytics antes de continuar para as próximas etapas.
Como alternativa, verifique FirebaseAnalytics/CoreeGoogleAdsOnDeviceConversion.
Integração alternativa
Se o app não usar o CocoaPods ou o Gerenciador de pacotes do Swift, faça a integração
da seguinte maneira:
Siga as instruções do README do arquivo zip público para adicionar os
frameworks diretamente ao projeto. Adicione os frameworks do
diretório FirebaseAnalytics.
No Xcode, adicione as flags -ObjC e -lc++ a Outras configurações do vinculador nas
configurações de build do destino do app.
Ativar o modo de depuração (opcional)
Ative o modo de depuração adicionando -FIRDebugEnabled em
Argumentos transmitidos na inicialização no editor de esquema do Xcode.
Ao iniciar o app no Xcode, verifique se uma mensagem como a seguinte
aparece no console de depuração do Xcode:
[Firebase/Analytics][I-ACS023007] Analytics v.X.X.X started
...
[Firebase/Analytics][I-ACS023009] Debug logging enabled
...
[FirebaseAnalytics][I-ACS023278] Conversion service GoogleAdsOnDeviceConversion framework is linked
Aguarde cerca de 15 segundos e verifique se a mensagem _psmvalue_gads aparece no
console de depuração do Xcode:
[FirebaseAnalytics][I-ACS023087] User property set. Name, value: _psmvalue_gads, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-06 UTC."],[],[],null,["Step 2: Integrate Google Analytics\n\n\u003cbr /\u003e\n\n|--------------------------------------------------------------------------------------------------------------------------|\n| Introduction: [Measure iOS Ads conversions](/docs/tutorials/ads-ios-on-device-measurement-event-data/index-event-driven) |\n| Step 1: [Link Your Ads Account with Google Analytics](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-1) |\n| **Step 2: Integrate Google Analytics** \u003cbr /\u003e |\n| Step 3: [Troubleshoot and handle common issues](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-3) |\n\n\u003cbr /\u003e\n\nNow that you've linked your Ads account, you can begin integrating the\nGoogle Analytics for Firebase SDK.\n\nIntegrate the Google Analytics for Firebase SDK\n\nIntegrate with the latest Google Analytics for Firebase SDK version.\n| **Note:** `GoogleAdsOnDeviceConversion` is not subject to [Apple's privacy manifest\n| requirements](//developer.apple.com/news/?id=3d8a9yyh) and does not include a privacy manifest. No additional action is required to enable on-device conversion measurement.\n\nUse Cocoapods\n\nIf your app uses Cocoapods, verify your project's Podfile contains the\n`GoogleAppAdsOnDeviceConversion` pod, through either the main\n`FirebaseAnalytics` pod or by including it explicitly as a standalone pod: \n\n pod 'FirebaseAnalytics' # includes GoogleAdsOnDeviceConversion\n\nor \n\n pod 'FirebaseAnalytics/Core'\n pod 'GoogleAdsOnDeviceConversion'\n\nThen, run the commands `pod repo update` and `pod install`.\n\nUse Swift Package Manager\n\nIf your app uses Swift Package Manager, follow the steps at\n[Swift Package Manager for Firebase](/docs/ios/installation-methods#swift-package-manager).\nWhen you reach the step \"Choose the Firebase libraries that you want include in\nyour app\", check `FirebaseAnalytics` before continuing to the next steps.\nAlternatively, check `FirebaseAnalytics/Core` *and*\n`GoogleAdsOnDeviceConversion`.\n\nAlternative integration\n\nIf your app does not use Cocoapods or Swift Package Manager, integrate as\nfollows:\n\n1. Download the public zip file of Firebase from the [firebase-ios-sdk GitHub repo](https://github.com/firebase/firebase-ios-sdk/releases).\n2. Follow the README instructions from the public zip file to add the frameworks to the project directly. Be sure to add the frameworks from the `FirebaseAnalytics`directory.\n3. In Xcode, add the `-ObjC` and `-lc++` flags to **Other Linker Settings** in your app target's build settings.\n\nEnable debug mode (optional)\n\nEnable debug mode by adding `-FIRDebugEnabled` under\n**Arguments Passed on Launch** in Xcode's scheme editor.\n\nUpon launching the app in Xcode, verify that a message like the following\nappears in the Xcode debug console: \n\n [Firebase/Analytics][I-ACS023007] Analytics v.X.X.X started\n ...\n [Firebase/Analytics][I-ACS023009] Debug logging enabled\n ...\n [FirebaseAnalytics][I-ACS023278] Conversion service GoogleAdsOnDeviceConversion framework is linked\n\nWait around 15 seconds and verify that the `_psmvalue_gads` message appears in\nthe Xcode debug console: \n\n [FirebaseAnalytics][I-ACS023087] User property set. Name, value: _psmvalue_gads, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\n\n| **Note:** This message won't appear for users/devices located in the European Economic Area (EEA), the United Kingdom, and Switzerland.\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\n[arrow_back_ios**Step 1** Link Your Ads Account with Google Analytics](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-1)\n[**Step 3** : Troubleshoot and handle common issuesarrow_forward_ios](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-3)\n\n\u003cbr /\u003e\n\n*** ** * ** ***"]]
