Introdução à personalização da Configuração remota
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a personalização de Remote Config, você fornece automaticamente aos usuários
uma das várias experiências de usuário alternativas para fazer a otimização para um
objetivo de sua escolha.
Consulte a Visão geral desse recurso.
Veja como dar os primeiros passos.
1. Instrumentar o app com Analytics e Remote Config
Antes de começar a oferecer experiências personalizadas aos usuários, o app precisa
usar Analytics e Remote Config.
Se você não ativou Google Analytics ao criar
o projeto do Firebase, ative-o na página
Integrações do projeto.
Verifique se você está usando pelo menos as seguintes versões do
SDK de Remote Config:
iOS 7.5.0 e versões superiores
Android: 20.0.3 (BoM do Firebase 26.4.0) e versões superiores
C++ 7.1.1 e versões mais recentes
Unity: 7.1.0 e versões posteriores
Apenas essas versões e as mais recentes executam a geração de registros necessária para que o
sistema de personalização aprenda a otimizar seu objetivo.
Registre pelo menos um evento quando um usuário concluir a ação que você escolheu
para otimizar. Por exemplo, se quiser otimizar para envios de avaliações da Play Store, registre um evento sempre que um usuário avaliar seu app.
Além disso, é preciso registrar explicitamente todos
os eventos de Analytics relevantes para o app que não são
registrados automaticamente.
Ao registrar esses eventos contextuais, você pode melhorar a qualidade das suas personalizações.
Implemente as diferentes experiências do usuário que você quer disponibilizar no seu app. Isso pode ser tão simples quanto personalizar a frequência de exibição dos anúncios para cada usuário, mas também pode envolver alternativas mais significativas, como a implementação de layouts
diferentes.
Agora, implante o app na App Store ou na Play Store. Os usuários
ainda terão a experiência padrão que você configurou, mas, já que é possível
controlar a experiência com uma variável que pode ser configurada remotamente, você pode começar a fazer testes com a personalização automática de parâmetros.
Você precisará ter uma grande quantidade de usuários que utilizam o app atualizado para que o sistema de personalização comece a otimizar experiências individuais.
2. Configurar a personalização de parâmetros no console do Firebase
Agora que o app instrumentado pode ser usado pelos usuários, use o
console de Firebase para configurar a personalização.
Na página Remote Config do
console de Firebase, localize o parâmetro que controla a experiência
dos usuários que você quer personalizar e clique no ícone de lápis para fazer edições.
No painel Editar parâmetro, clique em Adicionar novo > Personalização.
Defina dois ou mais valores alternativos. Os valores alternativos são um nome especial
para os valores de parâmetro que o algoritmo de personalização pode escolher
para seus usuários. O formato dos valores usados aqui precisa corresponder ao
tipo de dados usado pelo
parâmetro de Remote Config.
Escolha um objetivo. Você pode escolher uma das seguintes opções:
Selecione de uma lista de objetivos pré-criados para métricas como receita e
engajamento.
Adicione uma métrica personalizada com base em qualquer outro evento de Google Analytics que
você queira otimizar. Para isso, digite o nome do evento no campo Objetivo e clique
em Criar evento.
Como esses eventos são dinâmicos ou personalizados, talvez eles não apareçam no
menu suspenso. Para garantir que a métrica especificada corresponda com precisão a um evento ativo
de Analytics, verifique o evento em Analytics > Eventos.
Selecione se você quer otimizar o número de eventos (COUNT) ou a soma
dos valores de todos os eventos (SUM).
Em alguns casos, essa opção é pré-selecionada para eventos integrados
de Analytics. Por exemplo, SUM está sempre selecionado no tempo de Engajamento do usuário
para otimizar o tempo total gasto. Se você escolher Cliques no anúncio,
as personalizações serão otimizadas para COUNT ou para o número total de eventos
de clique no anúncio.
Se você tiver selecionado SUM, insira o nome do parâmetro do evento para
agregar.
Na maioria dos casos, o nome do parâmetro de evento é value, mas você pode
ter uma métrica personalizada com um valor específico que gostaria de agregar. Por
exemplo, se você tivesse um evento com diferentes tipos de moeda com parâmetros
como USD, JPY, AUD e assim por diante, seria possível otimizar a receita australiana
especificando AUD como o parâmetro de evento. Além disso, na próxima etapa, configure uma condição de segmentação para usuários na Austrália.
Se preferir, escolha até duas outras métricas para fazer o acompanhamento. Embora eles não
afetem o algoritmo de personalização, esses resultados podem ajudar você a entender melhor
o desempenho e as tendências. Por exemplo, caso sua personalização
otimize cliques em anúncios, convém acompanhar o engajamento do usuário entre o
grupo de referência e os grupos personalizados.
As métricas rastreadas vão aparecer no resumo de resultados da personalização,
organizadas por guia.
Defina ou selecione uma condição de segmentação para o parâmetro personalizado.
Somente os usuários que atenderem a essa condição terão uma experiência personalizada.
Algumas das condições mais usadas são para limitar a personalização apenas a usuários
de uma determinada plataforma ou região.
Quando você achar que está tudo certo com as alternativas, o objetivo, as métricas adicionais e
a segmentação, o processo vai estar concluído. Salve e implante as mudanças que você fez para começar a personalizar as
experiências individuais dos usuários. Eles vão começar a receber valores
de parâmetros personalizados em algumas horas, mas vai levar até 14 dias para que o sistema
aprenda sobre os usuários e alcance o melhor desempenho.
Para conferir o desempenho de uma personalização, selecione-a na
página Personalizações
ou clique na condição de segmentação do parâmetro na
página Remote Config.
[null,null,["Última atualização 2025-08-12 UTC."],[],[],null,["\u003cbr /\u003e\n\nWith Remote Config personalization, you automatically provide users\none of several alternative user experiences, in order to optimize for an\nobjective of your choice.\nSee an [Overview](/docs/remote-config/personalization) of this feature.\n\nHere's how to get started.\n\n1. Instrument your app with Analytics and Remote Config\n\nBefore you can start providing personalized user experiences, your app needs to\nbe using Analytics and Remote Config.\n\n1. If you didn't enable [Google Analytics](/docs/analytics) when you\n created your Firebase project, enable it on your project's\n [Integrations](//console.firebase.google.com/project/_/settings/integrations) page.\n\n2. Make sure you're using at least the following versions of the\n Remote Config SDK:\n\n - iOS: 7.5.0 and above\n - Android: 20.0.3 (Firebase BoM 26.4.0) and above\n - C++ 7.1.1 and above\n - Unity: 7.1.0 and above\n\n Only these versions (and newer) perform the logging necessary for the\n personalization system to learn how to optimize for your objective.\n3. Add [event logging](/docs/analytics/events) calls to your app.\n\n At a minimum, log an event when a user completes the objective action you're\n optimizing for. For example, if you want to optimize for Play Store rating\n submissions, log an event every time a user rates your app.\n\n In addition, you should explicitly log any\n [Analytics events](https://support.google.com/analytics/answer/9267735)\n relevant to your app that aren't\n [automatically logged](https://support.google.com/analytics/answer/9234069).\n By logging these contextual events, you can improve the quality of your\n personalizations.\n4. Implement the different user experiences you want to be possible in your\n app. This could be as simple as personalizing how often ads are shown to\n each user, or more substantial alternatives, such as implementing different\n layouts.\n\n5. Make the different user experiences configurable based on the value of\n a Remote Config parameter.\n See [Get started with Remote Config](/docs/remote-config/get-started)\n and [Remote Config loading strategies](/docs/remote-config/loading).\n\nAt this point, you can deploy your app to the App Store or Play Store. Users\nwill continue to get the default experience you configured, but because you can\ncontrol the experience with a remotely configurable variable, you can start\nexperimenting with automatic parameter personalization.\n\nYou will need to have a critical mass of users using your updated app before the\npersonalization system can begin to optimize individual experiences.\n\n2. Configure parameter personalization in the Firebase console\n\nNow that your instrumented app is in users' hands, you can use the\nFirebase console to set up personalization.\n\n1. On the [Remote Config](//console.firebase.google.com/project/_/config) page of\n the Firebase console, find the parameter that controls the user\n experience you want to personalize, and click the pencil icon to edit it.\n\n2. On the **Edit parameter** pane, click **Add new \\\u003e Personalization**.\n\n3. Define two or more alternative values. \"Alternative values\" are a special\n name for the parameter values that the personalization algorithm can choose\n for your users. The format of the values you use here must match the\n [data type](/docs/remote-config/parameters#parameter_value_data_types) that\n your Remote Config parameter uses.\n\n | **Tip:** Choose alternatives that you expect to produce a large difference in outcomes. The system will learn faster and create more value when alternatives are less similar to each other.\n4. Choose an objective. You can choose one of the following:\n\n - Select from a list of prebuilt objectives for metrics like revenue and engagement.\n - Add a custom metric based on any other Google Analytics event that\n you'd like to optimize by typing the event name into the **Objective**\n field and clicking **Create event**.\n\n Because these events may be dynamic or custom, they may not appear in the\n drop-down. To ensure the metric you specify precisely matches an active\n Analytics event, verify the event in **Analytics** \\\u003e **Events**.\n\n | **Tip:** Choose an objective that fully captures the behavior you want to optimize. The algorithm only considers the objective when assigning alternatives and measuring performance.\n5. Select whether to optimize for the number of events (**COUNT** ) or the sum\n of all events' values (**SUM**).\n\n In some cases, this option is pre-selected for built-in Analytics\n events. For example, **SUM** will always be selected for **User engagement**\n time to optimize for total time spent. If you choose **Ad clicks** ,\n personalizations are optimized for **COUNT**, or total number of ad click\n events.\n6. If you selected **SUM**, enter the name of the event parameter to\n aggregate.\n\n In most cases, the event parameter name is `value`, but you might\n have a custom metric with a specific value you want to aggregate. For\n example, if you had an event with different currency types with parameters\n like `USD`, `JPY`, `AUD` and so on, you could optimize for Australian revenue\n by specifying `AUD` as the event parameter (and, in the next step, be sure to\n configure a targeting condition for users in Australia!).\n | **Important:** The value passed by the event must be an `int`, `double`, or `float` to be summed/aggregated.\n7. Optionally, choose up to two additional metrics to track. While these will\n not affect the personalization algorithm, these results can help you better\n understand performance and trends. For example, if your personalization\n optimizes for ad clicks, you may want to track user engagement between the\n baseline and personalized groups.\n\n Tracked metrics will appear in the Personalization results summary,\n organized by tab.\n8. Define or select a targeting condition for the personalized parameter.\n Only users who meet this condition will get a personalized experience.\n Some commonly used conditions are to limit personalization to only users\n of a particular platform or to only users in a particular region.\n\n |\n | **Tip:** Choose large enough target segments\n | to generate plenty of result data---personalization performs best\n | with at least 10,000 users and 1,000 successful outcomes per week.\n |\n |\n | You can use the **User exists** condition to ensure that\n | all users of all apps within your project are targeted for\n | personalization.\n\nWhen you're satisfied with your alternatives, objective, additional metrics, and\ntargeting, you're done! Save and deploy your changes to start personalizing your\nusers' individual experiences. Users will begin to receive personalized\nparameter values in a few hours, but it will take up to 14 days for the system\nto learn about your user and achieve the best performance.\n\nYou can see how a personalization is performing by selecting it from the\n[Personalizations page](//console.firebase.google.com/project/_config/personalizations)\nor by clicking on the parameter's targeting condition on the\n[Remote Config](//console.firebase.google.com/project/_/config) page.\n| **Tip:** You can use the [Personalizations list view](//console.firebase.google.com/project/_config/personalizations) to search for a specific personalization by name or objective, and can sort by Name, Start time, or Total lift.\n\nFor more information about interpreting results, see\n[Understand personalization results](/docs/remote-config/personalization/about#understand-personalization-results)."]]
