Enviar notificações para clientes do seu aplicativoSend notifications to your app's customers

Interagir com seus clientes no momento certo e com a mensagem certa é essencial para o sucesso como um desenvolvedor de aplicativos.Engaging with your customers at the right time and with the right message is key to your success as an app developer. As notificações podem incentivar os clientes a executar uma ação, como classificar um aplicativo, comprar um complemento, experimentar um novo recurso ou baixar outro aplicativo (talvez gratuitamente com um código promocional fornecido por você).Notifications can encourage your customers to take an action, such as rating an app, buying an add-on, trying a new feature, or downloading another app (perhaps for free with a promotional code that you provide).

O Partner Center fornece uma plataforma de envolvimento do cliente controlada por dados que você pode usar para enviar notificações para todos os clientes do seu aplicativo ou direcionado apenas para um subconjunto dos clientes do Windows 10 do seu aplicativo que atendem aos critérios que você definiu em um segmento de cliente.Partner Center provides a data-driven customer engagement platform you can use to send notifications to all of your app's customers, or only targeted to a subset of your app's Windows 10 customers who meet the criteria you’ve defined in a customer segment. Você também pode criar uma notificação a ser enviada aos clientes de mais de um de seus aplicativos.You can also create a notification to be sent to customers of more than one of your apps.

Importante

Essas notificações podem ser usadas somente com aplicativos UWP.These notifications can only be used with UWP apps.

Ao considerar o conteúdo de suas notificações, tenha em mente:When considering the content of your notifications, keep in mind:

  • O conteúdo em suas notificações deve estar de acordo com as Políticas de Conteúdo da Loja.The content in your notifications must comply with the Store Content Policies.
  • Seu conteúdo da notificação não deve incluir informações confidenciais ou potencialmente sensíveis.Your notification content should not include confidential or potentially sensitive info.
  • Embora nos esforçamos para entregar a notificação conforme agendado, pode haver, ocasionalmente, problemas de latência que impactam a entrega.While we’ll make every effort to deliver your notification as scheduled, there may occasionally be latency issues that impact delivery.
  • Certifique-se de não enviar notificações muitas vezes.Be sure not to send notifications too often. Mais de uma vez a cada 30 minutos pode parecer intrusivo (e para muitos cenários, menos frequência do que isso é preferível).More than once every 30 minutes can seem intrusive (and for many scenarios, less frequently than that is preferable).
  • Saiba que, se um cliente que usa seu aplicativo (e está atribuído a sua conta da Microsoft no momento em que a associação de segmento é determinada), e o usuário da conta fornece seu dispositivo para outra pessoa usar, a outra pessoa pode ver a notificação que era para o cliente original.Be aware that if a customer who uses your app (and is signed in with their Microsoft account at the time the segment membership is determined) later gives their device to someone to use, the other person may see the notification that was targeted at the original customer. Para obter mais informações, consulte Configurar seu aplicativo para notificações por push direcionada.For more info, see Configure your app for targeted push notifications.
  • Se você enviar a mesma notificação para os clientes de vários aplicativos, você não poderá direcionar um segmento, a notificação será enviada para todos os clientes para os aplicativos que você selecionar.If you send the same notification to customers of multiple apps, you can't target a segment; the notification will be sent to all customers for the apps you select.

Introdução às notificaçõesGetting started with notifications

Em um nível superior, você precisa executar três ações para usar notificações e interagir com seus clientes.At a high-level, you need to do three things to use notifications to engage with your customers.

  1. Registre seu aplicativo para receber notificações por push.Register your app to receive push notifications. Você faz isso adicionando uma referência ao SDK dos serviços de Microsoft Store em seu aplicativo e, em seguida, adicionando algumas linhas de código que registram um canal de notificação entre o Partner Center e seu aplicativo.You do this by adding a reference to the Microsoft Store Services SDK in your app and then adding a few lines of code that registers a notification channel between Partner Center and your app. Usaremos este canal para disponibilizar as notificações para seus clientes.We’ll use that channel to deliver your notifications to your customers. Para obter mais detalhes, consulte Configurar seu aplicativo para notificações por push direcionadas.For details, see Configure your app for targeted push notifications.
  2. Decida quais clientes direcionam.Decide which customers to target. Você pode enviar a notificação para todos os clientes do seu app, ou (para notificações criadas para um único app) para um grupo de clientes chamado um segmento, que você pode definir com base em critérios demográficos ou de receita.You can send your notification to all of your app's customers, or (for notifications created for a single app) to a group of customers called a segment, which you can define based on demographic or revenue criteria. Para obter mais informações, consulte Criar segmentos de clientes.For more info, see Create customer segments.
  3. Crie o conteúdo da notificação e o envie. Por exemplo, você pode criar uma notificação que incentive os novos clientes a classificar seu app, ou pode enviar uma notificação que promova uma oferta especial para adquirir um complemento.Create your notification content and send it out. For example, you might create a notification that encourages new customers to rate your app, or send a notification promoting a special deal to purchase an add-on.

Para criar e enviar uma notificaçãoTo create and send a notification

Siga estas etapas para criar uma notificação no Partner Center e enviá-la a um segmento de cliente específico.Follow these steps to create a notification in Partner Center and send it to a particular customer segment.

Observação

Antes que um aplicativo possa receber notificações do Partner Center, primeiro você deve chamar o método RegisterNotificationChannelAsync em seu aplicativo para registrar seu aplicativo para receber notificações.Before an app can receive notifications from Partner Center, you must first call the RegisterNotificationChannelAsync method in your app to register your app to receive notifications. Esse método está disponível no Microsoft Store Services SDK.This method is available in the Microsoft Store Services SDK. Para obter mais informações sobre como chamar esse método, incluindo um exemplo de código, consulte Configurar o aplicativo para notificações por push direcionadas.For more information about how to call this method, including a code example, see Configure your app for targeted push notifications.

  1. No Partner Center, expanda a seção envolver e, em seguida, selecione notificações.In Partner Center, expand the Engage section, and then select Notifications.

  2. Na página Notificações, selecione Nova notificação.On the Notifications page, select New notification.

  3. Na seção selecionar um modelo , escolha o tipo de notificação que você deseja enviar e clique em OK.In the Select a template section, choose the type of notification you want to send and then click OK.

  4. Na próxima página, use o menu suspenso para escolher um Único aplicativo ou Vários aplicativos para qual (quais) você deseja gerar uma notificação.On the next page, use the drop-down menu to choose either a Single app or Multiple apps for which you want to generate a notification. Você só pode selecionar aplicativos que foram configurados para receber notificações usando o SDK dos serviços Microsoft Stores.You can only select apps that have been configured to receive notifications using the Microsoft Store Services SDK.

  5. Na seção Configurações de notificação, escolha um Nome para a sua notificação e, se aplicável, escolha o Grupo de clientes para o qual você deseja enviar a notificação.In the Notification settings section, choose a Name for your notification and, if applicable, choose the Customer group to which you want to send the notification. (As notificações enviadas para vários aplicativos só podem ser enviadas para todos os clientes desses aplicativos). Se você quiser usar um segmento que você ainda não criou, selecione Criar novo grupo de cliente.(Notifications sent to multiple apps can only be sent to all customers of those apps.) If you wish to use a segment that you haven't created already, select Create new customer group. Observe que serão necessárias 24 horas para que você possa usar um novo segmento para notificações.Note that it takes 24 hours before you can use a new segment for notifications. Para obter mais informações, consulte Criar segmentos de clientes.For more info, see Create customer segments.

  6. Se você quiser especificar quando a notificação deverá ser enviada, desmarque a caixa de seleção Enviar a notificação imediatamente e escolha uma data e uma hora específicas (no horário UTC para todos os clientes, a menos que você especifique o uso do fuso horário local de cada cliente).If you want to specify when to send the notification, clear the Send notification immediately checkbox and choose a specific date and time (in UTC for all customers, unless you specify to use each customer's local time zone).

  7. Se você quiser que a notificação expire em algum momento, limpe a caixa de seleção Notificação nunca expira e escolha data e hora de expiração específicas (em UTC).If you want the notification to expire at some point, clear the Notification never expires checkbox and choose a specific expiration date and time (in UTC).

  8. Para notificações para um único aplicativo: se você deseja filtrar os destinatários para que sua notificação seja entregue apenas à pessoas que usam certos idiomas ou que estão em um fuso horário específico, marque a caixa de seleção Usar filtros.For notifications to a single app: If you want to filter the recipients so that your notification is only delivered to people who use certain languages or are in specific time zones, check the Use filters checkbox. Em seguida, você pode especificar as opções de idioma e/ou fuso horário que deseja usar.You can then specify the language and/or time zone options you want to use.

  9. Para notificações para vários aplicativos: especificar se deseja enviar a notificação somente para o último aplicativo ativo em cada dispositivo (por cliente), ou para todos os aplicativos em cada dispositivo.For notifications to multiple apps: Specify whether to send the notification only to the last active app on each device (per customer), or to all apps on each device.

  10. Na seção Conteúdo da notificação, no menu Idioma, escolha os idiomas em que você deseja que sua notificação seja exibida.In the Notification content section, in the Language menu, choose the languages in which you want your notification to be displayed. Para obter mais informações, consulte Traduzir suas notificações.For more info, see Translate your notifications.

  11. Na seção Opções, insira texto e configure as outras opções que desejar.In the Options section, enter text and configure any other options you’d like. Se você começou com um modelo, parte disso é fornecido por padrão, mas você pode fazer quaisquer alterações que desejar.If you started with a template, some of this is provided by default, but you can make any changes you'd like.

    As opções disponíveis variam, dependendo de qual tipo de notificação você está usando.The available options vary, depending on which notification type you are using. Algumas das opções são:Some of the options are:

    • Tipo de ativação (tipo de notificação do sistema interativa).Activation type (interactive toast type). Você pode escolher Em primeiro plano, Em segundo plano, ou Protocolo.You can choose Foreground, Background, or Protocol.
    • Iniciar (tipo de notificação do sistema interativa).Launch (interactive toast type). Você pode optar por ter a notificação abrir um aplicativo ou site.You can choose to have the notification open an app or website.
    • Acompanhar taxa de inicialização do aplicativo (tipo de notificação do sistema interativa).Track app launch rate (interactive toast type). Se desejar avaliar quão bem você está interagindo com seus clientes por meio de cada notificação, marque essa caixa de seleção.If you want to measure how well you’re engaging with your customers through each notification, select this checkbox. Para obter mais detalhes, consulte Avaliar o desempenho das notificações.For more details, see Measure notification performance.
    • Duração (tipo de notificação do sistema interativa).Duration (interactive toast type). Você pode escolher Curta ou Longa.You can choose Short or Long.
    • Cenário (tipo de notificação do sistema interativa).Scenario (interactive toast type). Você pode escolher Padrão, Alarme, Lembrete ou Chamada de entrada.You can choose Default, Alarm, Reminder, or Incoming call.
    • URI base (tipo de notificação do sistema interativa).Base URI (interactive toast type). Para obter mais detalhes, veja BaseUri.For more details, see BaseUri.
    • Adicionar consulta de imagem (tipo de notificação do sistema interativa).Add image query (interactive toast type). Para obter mais detalhes, consulte addImageQuery.For more details, see addImageQuery.
    • Visual.Visual. Uma imagem, vídeo ou som.An image, video, or sound. Para obter mais detalhes, consulte visual.For more details, see visual.
    • Entrada/Ação/Seleção (tipo de notificação do sistema interativa).Input/Action/Selection (interactive toast type). Permite que você possibilite aos usuários interagirem com a notificação.Allows you to let users interact with the notification. Para obter mais informações, consulte Notificações do sistema interativas e adaptáveis.For more info, see Adaptive and interactive toast notifications.
    • Associar (tipo de bloco interativo).Binding (interactive tile type). O modelo de notificação do sistema.The toast template. Para obter mais detalhes, veja binding.For more details, see binding.

    Dica

    Tente usar o aplicativo Visualizador de Notificações para projetar e testar os blocos adaptáveis e as notificações interativas do sistema.Try using the Notifications Visualizer app to design and test your adaptive tiles and interactive toast notifications.

  12. Selecione Salvar como rascunho para continuar trabalhando na notificação mais tarde, ou selecione Enviar se você tiver terminado.Select Save as draft to continue working on the notification later, or select Send if you’re all done.

Tipos de modelo de notificaçãoNotification template types

Você pode escolher dentre uma variedade de modelos de notificação.You can choose from a variety of notification templates.

  • Em branco (sistema de notificação).Blank (Toast). Comece com uma notificação do sistema vazia que você pode personalizar.Start with an empty toast notification that you can customize. Notificação do sistema é uma interface do usuário pop-up que aparece na tela para permitir que seu aplicativo se comunique com o cliente quando o cliente está em outro aplicativo, na tela inicial ou na área de trabalho.A toast notification is a pop-up UI that appears on your screen to allow your app to communicate with the customer when the customer is in another app, on the Start screen, or on the desktop.

  • Em branco (bloco).Blank (Tile). Comece com uma notificação de bloco vazia que você pode personalizar.Start with an empty tile notification that you can customize. Blocos são a representação de um aplicativo na tela inicial.Tiles are an app's representation on the Start screen. Os blocos são "dinâmicos", pois o conteúdo exibido se modifica em resposta às notificações.Tiles can be “live,” which means that the content that they display can change in response to notifications.

  • Solicitar classificações (notificação).Ask for ratings (Toast). Uma notificação do sistema que pede que seus clientes classifiquem seu aplicativo.A toast notification that asks your customers to rate your app. Quando o cliente seleciona a notificação, a página de classificações da Loja para seu aplicativo é exibida.When the customer selects the notification, the Store ratings page for your app is displayed.

  • Solicitar comentários (notificação).Ask for feedback (Toast). Uma notificação do sistema que pede que seus clientes façam comentários sobre o aplicativo.A toast notification that asks your customers to provide feedback for your app. Quando o cliente seleciona a notificação, a página do Hub de Feedback do seu aplicativo é exibida.When the customer selects the notification, the Feedback Hub page for your app is displayed.

    Observação

    Se você escolher esse tipo de modelo, na caixa Iniciar, lembre-se de substituir o valor de espaço reservado {PACKAGE_FAMILY_NAME} pelo PFN (Nome da Família de Pacotes) real do seu aplicativo.If you choose this template type, in the Launch box, remember to replace the {PACKAGE_FAMILY_NAME} placeholder value with your app’s actual Package Family Name (PFN). Você pode encontrar o PFN do seu aplicativo na página Identidade do aplicativo (Gerenciamento de aplicativo > Identidade de aplicativo).You can find your app’s PFN on the App identity page (App management > App identity).

    Caixa Iniciar da notificação do sistema de comentários

  • Promoção cruzada (notificação).Cross-promote (Toast). Uma notificação do sistema para promover um aplicativo diferente de sua escolha.A toast notification to promote a different app of your choosing. Quando o cliente seleciona a notificação, os detalhes da listagem da Loja do outro aplicativo são exibidos.When the customer selects the notification, the other app’s Store listing is displayed.

    Observação

    Se você escolher esse tipo de modelo, na caixa Iniciar, lembre-se de substituir o valor de espaço reservado {ProductId que você deseja promover aqui} pela ID da Loja real do item que você deseja promover.If you choose this template type, in the Launch box, remember to replace the {ProductId you want to promote here} placeholder value with the actual Store ID of the item you want to cross promote. Você pode encontrar a ID da Loja na página Identidade do aplicativo (Gerenciamento de aplicativo > Identidade do aplicativo).You can find the Store ID on the App identity page (App management > App identity).

    Caixa Iniciar da notificação do sistema de promover

  • Promover uma venda (notificação).Promote a sale (Toast). Uma notificação do sistema que você pode usar para anunciar uma promoção para seu aplicativo.A toast notification that you can use to announce a deal for your app. Quando o cliente seleciona a notificação, os detalhes de seu aplicativo na Loja são exibidos.When the customer selects the notification, your app’s Store listing is displayed.

  • Solicitar atualização (notificação).Prompt for update (Toast). Uma notificação do sistema que incentiva os clientes que estejam executando uma versão mais antiga do seu aplicativo a instalarem a versão mais recente.A toast notification that encourages customers who are running an older version of your app to install the latest version. Quando o cliente seleciona a notificação, o app da Store é iniciado, mostrando a lista Downloads e atualizações.When the customer selects the notification, the Store app will launch, showing the Downloads and updates list. Observe que esse modelo só pode ser usado com um único app, e você não pode direcionar para um determinado segmento de clientes ou definir um tempo para enviá-lo; sempre agendaremos essa notificação para que ela seja enviada dentro de 24 horas e estamos fazendo nosso melhor esforço para termos como destino todos os usuários que ainda não estejam executando a última versão do seu app.Note that this template can only be used with a single app, and you can't target a particular customer segment or define a time to send it; we’ll always schedule this notification to be sent within 24 hours, and making our best effort to target all users who are not yet running the latest version of your app.

Avalie o desempenho das notificaçõesMeasure notification performance

Você pode avaliar quão bem está interagindo com seus clientes por meio de cada notificação.You can measure how well you’re engaging with your customers through each notification.

Avaliar o desempenho das notificaçõesTo measure notification performance

  1. Quando você cria uma notificação, na seção Conteúdo da notificação, selecione a caixa de diálogo Acompanhar taxa de inicialização do aplicativo.When you create a notification, in the Notification content section, select the Track app launch rate checkbox.
  2. Em seu aplicativo, chame o método ParseArgumentsAndTrackAppLaunch para notificar o Partner Center de que seu aplicativo foi iniciado em resposta a uma notificação de destino.In your app, call the ParseArgumentsAndTrackAppLaunch method to notify Partner Center that your app was launched in response to a targeted notification. Esse método é fornecido pelo Microsoft Store Services SDK.This method is provided by the Microsoft Store Services SDK. Para obter mais informações sobre como chamar esse método, consulte configurar seu aplicativo para receber notificações do Partner Center.For more information about how to call this method, see Configure your app to receive Partner Center notifications.

Para exibir o desempenho de notificaçãoTo view notification performance

Quando você configurou a notificação e seu aplicativo para medir o desempenho de notificação conforme descrito acima, você pode ver como suas notificações estão sendo executadas.When you’ve configured the notification and your app to measure notification performance as described above, you can see how well your notifications are performing.

Para examinar os dados detalhados de cada notificação:To review detailed data for each notification:

  1. No Partner Center, expanda a seção envolver e selecione notificações.In Partner Center, expand the Engage section and select Notifications.
  2. Na tabela de notificações existentes, selecione em andamento ou concluídoe, em seguida, examine as colunas taxa de entrega e taxa de inicialização do aplicativo para ver o desempenho de alto nível de cada notificação.In the table of existing notifications, select In progress or Completed, and then look at the Delivery rate and App launch rate columns to see the high-level performance of each notification.
  3. Para ver mais detalhes de desempenho granular, selecione um nome de notificação.To see more granular performance details, select a notification name. Na seção Estatísticas de entrega, você pode exibir as informações Contagem e Porcentagem para os seguintes tipos de Status de notificação:In the Delivery statistics section, you can view Count and Percentage info for the following notification Status types:
    • Falha: A notificação não foi enviada por algum motivo.Failed: The notification was not delivered for some reason. Isso pode acontecer, por exemplo, se ocorrer um problema no Serviço de Notificação do Windows (WNS).This can happen, for example, if an issue occurs in the Windows Notification Service.
    • Falha de expiração do canal: a notificação não pôde ser entregue porque o canal entre o aplicativo e o Partner Center expirou.Channel expiration failure: The notification could not be delivered because the channel between the app and Partner Center has expired. Isso pode acontecer, por exemplo, se o cliente não abre o aplicativo há muito tempo.This can happen, for example, if the customer has not opened your app in a long time.
    • Enviando: A notificação está na fila para ser enviada.Sending: The notification is in the queue to be sent.
    • Enviada: A notificação foi enviada.Sent: The notification was sent.
    • Inicia: A notificação foi enviada, o cliente clicou nela e o aplicativo foi aberto em resultado disso.Launches: The notification was sent, the customer clicked it, and your app was opened as a result. Observe que isso apenas rastreia inicializações de aplicativos.Note that this only tracks app launches. Notificações que convidam o cliente para realizar outras ações, como iniciar a Loja para deixar uma classificação, não são incluídas nesse status.Notifications that invite the customer to take other actions, such as launching the Store to leave a rating, are not included in this status.
    • Desconhecido: Não foi possível determinar o status dessa notificação.Unknown: We weren’t able to determine the status of this notification.

Para analisar dados de atividade do usuário para todas as suas notificações:To analyze user activity data for all your notifications:

  1. No Partner Center, expanda a seção envolver e selecione notificações.In Partner Center, expand the Engage section and select Notifications.
  2. Na página notificações , clique na guia analisar . Essa guia exibe os seguintes dados:On the Notifications page, click the Analyze tab. This tab displays the following data:
    • Exibições de grafo dos vários Estados de ação do usuário para suas notificações de notificação e da central de ações.Graph views of the various user action states for your toasts and action center notifications.
    • Exibições do World Map das taxas de cliques para suas notificações de notificação e da central de ações.World map views of the click-through-rates for your toasts and action center notifications.
  3. Na parte superior da página, você pode selecionar o período para o qual você deseja mostrar os dados.Near the top of the page, you can select the time period for which you want to show data. A seleção padrão é 30D (30 dias), mas você pode optar por mostrar dados para 3, 6 ou 12 meses, ou para um intervalo de datas personalizado que você especificar.The default selection is 30D (30 days), but you can choose to show data for 3, 6, or 12 months, or for a custom data range that you specify. Você também pode expandir filtros para filtrar todos os dados por aplicativo e mercado.You can also expand Filters to filter all of the data by app and market.

Traduza suas notificaçõesTranslate your notifications

Para maximizar o impacto de suas notificações, considere traduzi-las para os idiomas que seus clientes preferem.To maximize the impact of your notifications, consider translating them into the languages that your customers prefer. O Partner Center facilita a tradução automática de suas notificações, aproveitando o poder do serviço Microsoft Translator .Partner Center makes it easy for you to translate your notifications automatically by leveraging the power of the Microsoft Translator service.

  1. Depois de escrever sua notificação em seu idioma padrão, selecione Adicionar idiomas (abaixo do menu Idiomas na seção Conteúdo da notificação).After you’ve written your notification in your default language, select Add languages (beneath the Languages menu in the Notification content section).
  2. Na janela Adicionar idiomas, selecione os idiomas adicionais em que você deseja que suas notificações apareçam e selecione Atualizar.In the Add languages window, select the additional languages that you want your notifications to appear in, and then select Update. Sua notificação será automaticamente traduzida para os idiomas que você escolheu na janela Adicionar idiomas e os idiomas serão adicionados ao menu Idioma.Your notification will be automatically translated into the languages you chose in the Add languages window and those languages will be added to the Language menu.
  3. Para ver a tradução da notificação, no menu Idioma, selecione o idioma que você acabou de adicionar.To see the translation of your notification, in the Language menu, select the language that you just added.

Coisas a serem lembradas sobre tradução:Things to keep in mind about translation:

  • Você pode substituir a tradução automática inserindo algo diferente na caixa Conteúdo para aquele idioma.You can override the automatic translation by entering something different in the Content box for that language.
  • Se você adicionar outra caixa de texto para a versão em inglês da notificação depois de ter substituído uma tradução automática, a nova caixa de texto não será adicionada à notificação traduzida.If you add another text box to the English version of the notification after you’ve overridden an automatic translation, the new text box will not be added to translated notification. Nesse caso, você precisaria adicionar manualmente a nova caixa de texto para cada uma das notificações traduzidas.In that case, you would need to manually add the new text box to each of translated notifications.
  • Se você alterar o texto em inglês depois que a notificação for traduzida, vamos atualizar automaticamente as notificações traduzidas para corresponder à alteração.If you change the English text after the notification has been translated, we’ll automatically update the translated notifications to match the change. No entanto, isso não vai acontecer se você tiver escolhido previamente substituir a tradução inicial.However, this won’t happen if you previously chose to override the initial translation.