Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Google Analytics tem uma chamada setUserID, que permite
armazenar um ID de usuário para quem usa seu aplicativo. Essa chamada é opcional e
geralmente é utilizada por organizações que querem usar o Analytics
com o BigQuery para associar dados de análise do mesmo usuário em
vários aplicativos, dispositivos ou provedores de estatísticas.
Há muitas formas de criar IDs de usuário válidos. Uma abordagem é usar um identificador que você atribuiu e somente você poderá rastrear de volta para um usuário individual. Por exemplo, considere uma desenvolvedora fictícia de jogos para dispositivos móveis, a AwesomeGameCompany, que tem seu próprio AwesomeGameCompanyID interno criado para cada usuário. Se não for possível que uma organização externa rastreie AwesomeGameCompanyID de volta para o usuário original, ela poderá usar AwesomeGameCompanyID ou, melhor ainda, uma versão hash de AwesomeGameCompanyID, como o valor do ID de usuário para o Analytics.
Isso permitiria que ela calculasse valores como o gasto total de um usuário em todos os seus jogos.
A definição de um ID do usuário nunca é necessária para que o Analytics funcione corretamente.
Se você quer apenas encontrar eventos que pertencem ao mesmo usuário no mesmo aplicativo em um único dispositivo, use user_pseudo_id.
Esse valor é gerado automaticamente pelo Analytics e é armazenado no BigQuery para cada evento.
Como configurar o User ID
Defina um User ID com o seguinte método:
Swift
Observação: este produto do Firebase não está disponível no destino macOS.
Analytics.setUserID("123456")
Objective-C
Observação: este produto do Firebase não está disponível no destino macOS.
Depois de definir um ID de usuário, todos os eventos futuros serão marcados automaticamente com esse valor, e você poderá acessá-lo ao consultar o valor user_id no BigQuery. Adicionar um ID do usuário não vai afetar nenhum
evento registrado anteriormente pelo Google Analytics.
Para saber mais sobre como acessar dados do Analytics no BigQuery, consulte
este guia de desenvolvimento.
[[["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-09 UTC."],[],[],null,["Google Analytics has a `setUserID` call, which allows you to\nstore a user ID for the individual using your app. This call is optional, and\nis generally used by organizations that want to use Analytics\nin conjunction with BigQuery to associate analytics data for the same user across\nmultiple apps, multiple devices, or multiple analytics providers.\n| **Note:** You are responsible for ensuring that your use of the user ID is in accordance with the [Google Analytics Terms of Service](https://www.google.com/analytics/terms/). This includes avoiding the use of impermissible personally identifiable information, and providing appropriate notice of your use of identifiers in your Privacy Policy. Your user ID must not contain information that a third party could use to determine the identity of an individual user. For example, you cannot use a user's email address or social security number as a user ID.\n\nThere are many ways you can construct valid user IDs. One approach is to use an\nidentifier you assign and only you can track back to an individual user. For one\npossible example, consider a hypothetical mobile game developer,\nAwesomeGameCompany, that has their own internal `AwesomeGameCompanyID` that they\ncreate for every user. If it isn't possible for an outside organization to track\nthat `AwesomeGameCompanyID` back to the original user, they might consider using\nthat `AwesomeGameCompanyID` --- or, better yet, a hashed version of\n`AwesomeGameCompanyID` --- as the user ID value for Analytics.\nThis would then allow them to calculate values such as a user's total spend\nacross all of their games.\n\nSetting a user ID is never required for Analytics to work correctly.\nIf you're only interested in finding events belonging to the same user for the\nsame app on a single device, you can use the `user_pseudo_id`.\nThis value is generated automatically by Analytics and is\nstored within BigQuery for each event.\n\nSetting the user ID\n\nYou can set a user ID with the following method: \n\nSwift\n\n\n**Note:** This Firebase product is not available on the macOS target. \n\n```swift\nAnalytics.setUserID(\"123456\")\n```\n\nObjective-C\n\n\n**Note:** This Firebase product is not available on the macOS target. \n\n```objective-c\n[FIRAnalytics setUserID:@\"123456\"]\n```\n\nAndroid \n\n```java\nmFirebaseAnalytics.setUserId(\"123456\");\n```\n\nWeb \n\n```java\nimport { getAnalytics, setUserId } from \"firebase/analytics\";\n\nconst analytics = getAnalytics();\nsetUserId(analytics, \"123456\");\n```\n\nWeb \n\n```java\nfirebase.analytics().setUserId(\"123456\");\n```\n\nDart \n\n```dart\nawait FirebaseAnalytics.instance.setUserId(id: '123456');\n```\n\nUnity \n\n```c#\nFirebase.Analytics.FirebaseAnalytics.SetUserID(\"123456\");\n```\n\nC++ \n\n```c++\nanalytics::SetUserId(\"123456\");\n```\n\nAfter setting a user ID, all future events will be automatically tagged\nwith this value, and you can access it by querying for the `user_id`\nvalue in BigQuery. Adding a user ID will not affect any\nevents previously recorded by Google Analytics.\n\nTo find out more about accessing Analytics data in BigQuery, please see\nthis [development guide](https://cloud.google.com/solutions/mobile/mobile-firebase-analytics-big-query)."]]
