Criar uma campanha personalizada de promoção de appCreate a custom app promotion campaign

Além de criar uma campanha do AD para seu aplicativo que será executado em aplicativos do Windows, você também pode promover seu aplicativo usando outros canais.In addition to creating an ad campaign for your app that will run in Windows apps, you can also promote your app using other channels. Por exemplo, você pode promover o aplicativo usando um provedor de marketing de aplicativos terceirizado, ou pode postar links para seu aplicativo em redes sociais.For example, you can promote your app using a third-party app marketing provider, or you might post links to your app on social media sites. Essas atividades são chamadas campanhas personalizadas.These activities are called custom campaigns.

Se você veicular campanhas personalizadas para seu aplicativo, é possível acompanhar o desempenho relativo de cada uma criando uma URL para cada campanha personalizada, na qual cada URL contém uma ID de campanha diferente.If you run custom campaigns for your app, you can track the relative performance of each campaign by creating a different URL for each custom campaign, where each URL contains a different campaign ID. Quando um cliente que executa o Windows 10 clica em uma URL que contém uma ID de campanha, a Microsoft associa o clique com a campanha personalizada correspondente e disponibiliza esses dados para você no Partner Center.When a customer running Windows 10 clicks a URL that contains a campaign ID, Microsoft associates the click with the corresponding custom campaign and makes this data available to you in Partner Center.

Importante

Esses dados serão acompanhados somente para clientes no Windows 10.This data is only tracked for customers on Windows 10. Os clientes que usam outros sistemas operacionais ainda podem seguir o link até a listagem do seu aplicativo, mas dados sobre as atividades esses clientes não serão incluídos.Customers using other operating systems can still follow the link to your app's listing, but data about those customers' activities will not be included.

Existem dois tipos principais de dados associados a campanhas personalizadas: visualizações de página da listagem da Store do aplicativo e conversões.There are two main types of data associated with custom campaigns: page views for your app's Store listing, and conversions. Uma conversão é uma aquisição do aplicativo resultante da visualização por um cliente na página de listagem da Loja da Windows Store a partir de uma URL que inclui uma ID de campanha personalizada.A conversion is an app acquisition that results from a customer viewing your app's Store listing page from a URL that includes a custom campaign ID. Para obter mais detalhes sobre conversões, confira Noções básicas sobre como aquisições do app se qualificam como conversões neste tópico.For more details about conversions, see Understanding how app acquisitions qualify as conversions in this topic.

Você pode recuperar dados de desempenho da campanha personalizada para o seu app das seguintes maneiras:You can retrieve custom campaign performance data for your app in the following ways:

  • Você pode exibir dados sobre exibições de página e conversões para seu aplicativo ou complemento de exibições de página de aplicativo e conversões por ID de campanha e gráficos de conversões de campanha totais no relatório de aquisições.You can view data about page views and conversions for your app or add-on from the App page views and conversions by campaign ID and Total campaign conversions charts in the Acquisitions report.
  • Se o aplicativo for aplicativo UWP (Plataforma Universal do Windows), é possível usar APIs no SDK do Windows para recuperar de forma programática a ID da campanha personalizada que resultou em uma conversão.If your app is a Universal Windows Platform (UWP) app, you can use APIs in the Windows SDK to programmatically retrieve the custom campaign ID that resulted in a conversion.

Exemplo de cenário de campanha personalizadaExample custom campaign scenario

Considere uma desenvolvedora de jogos que acabou de criar um novo jogo e gostaria de promovê-lo para jogadores de seus jogos existentes.Consider a game developer who has finished building a new game and would like to promote it to players of her existing games. Ela posta o lançamento do novo jogo na sua página do Facebook, incluindo um link para a página do jogo na listagem da Store do jogo.She posts the announcement of the new game release on her Facebook page, including a link to the game's Store listing. Muitos jogadores também a seguem no Twitter, portanto ela também tweeta o anúncio com o link da listagem da Store do jogo.Many of her players also follow her on Twitter, so she also tweets an announcement with the link to the game's Store listing.

Para acompanhar o sucesso de cada um desses canais de promoção, a desenvolvedora cria duas variantes da URL da listagem da Store do jogo:To track the success of each of these promotion channels, the developer creates two variants of the URL to the game's Store listing:

  • A URL que publicará em sua página do Facebook incluirá a ID da campanha personalizada my-facebook-campaignThe URL she will post to her Facebook page includes the custom campaign ID my-facebook-campaign

  • A URL que publicará no Twitter incluirá a ID da campanha personalizada my-twitter-campaignThe URL she will post to Twitter includes the custom campaign ID my-twitter-campaign

Assim que os seguidores no Facebook e no Twitter clicam nas URLs, a Microsoft rastreia cada clique e o associa à campanha personalizada correspondente.As her Facebook and Twitter followers click the URLs, Microsoft tracks each click and associates it with the corresponding custom campaign. As aquisições subsequentes qualificadas do jogo e quaisquer compras de complementos são associadas à campanha personalizada e reportadas como conversões.Subsequent qualifying acquisitions of the game and any add-on purchases are associated with the custom campaign and reported as conversions.

Noções básicas sobre a qualificação de aquisições de aplicativo como conversõesUnderstanding how acquisitions qualify as conversions

Uma conversão de campanha personalizada é uma aquisição que resulta do clique de um cliente a partir de uma URL promovida por uma campanha personalizada.A custom campaign conversion is an acquisition that results from a customer clicking a URL that is promoted via a custom campaign. Há diferentes cenários para qualificação como uma conversão para as exibições de página de aplicativo e conversões por ID de campanha e gráficos de conversões de campanha totais no relatório de aquisições e para qualificação como uma conversão para recuperar programaticamente a ID da campanha.There are different scenarios for qualifying as a conversion for the App page views and conversions by campaign ID and Total campaign conversions charts in the Acquisitions report and for qualifying as a conversion for programmatically retrieving the campaign ID.

Conversões qualificadas no relatório de aquisiçõesQualifying conversions in the Acquisitions report

Os cenários a seguir se qualificam como uma conversão para os gráficos Visualizações de página e conversões de aplicativo por ID da campanha e Total de conversões da campanha no Relatório de aquisições:The following scenarios qualify as a conversion for the App page views and conversions by campaign ID and Total campaign conversions charts in the Acquisitions report:

  • Um cliente com ou sem uma conta da Microsoft reconhecida clica em uma URL do aplicativo que contém uma ID de campanha personalizada e é redirecionado para listagem da Loja para o aplicativo.A customer with or without a recognized Microsoft account clicks an app URL that contains a custom campaign ID and is redirected to the Store listing for the app. Em seguida, o mesmo cliente adquire o aplicativo em 24 horas após clicar pela primeira vez na URL da Microsoft Store com a ID de campanha personalizada.Then, that same customer acquires the app within 24 hours after they first clicked the Microsoft Store URL with the custom campaign ID.

  • Se o cliente adquirir o aplicativo em um computador ou dispositivo diferente daquele que usado para clicar na URL com a ID de campanha personalizada, a conversão será considerada somente se o cliente estiver conectado com a mesma conta da Microsoft usada ao clicar na URL.If the customer acquires the app on a different device than the one on which they clicked the URL with the custom campaign ID, the conversion will only be counted if the customer is signed in with the same Microsoft account as when they clicked the URL.

Observação

Para aquisições de aplicativo contabilizadas como conversões para uma campanha personalizada, as compras de complementos nele também são contabilizadas como conversões para a mesma campanha personalizada.For app acquisitions that are counted as conversions for a custom campaign, any add-on purchases in that app are also counted as conversions for the same custom campaign.

Conversões de qualificação ao recuperar programaticamente a ID da campanhaQualifying conversions when programmatically retrieving the campaign ID

Para se qualificar como uma conversão ao recuperar de forma programática a ID de campanha associada ao app, as seguintes condições devem ser atendidas:To qualify as a conversion when programmatically retrieving the campaign ID associated with the app, the following conditions must be met:

  • Em um dispositivo executando Windows 10, versão 1607 ou posterior: um cliente (conectado como uma conta da Microsoft reconhecida ou não) clica em uma URL com uma ID de campanha personalizada e é redirecionada para a página de listagem da Loja do aplicativo.On a device running Windows 10, version 1607, or later: A customer (whether signed in to a recognized Microsoft account or not) clicks a URL that contains a custom campaign ID and is redirected to the Store listing page for the app. O cliente adquire o aplicativo enquanto visualiza a listagem da Loja ao clicar na URL.The customer acquires the app while viewing the Store listing as a result of clicking the URL.

  • Em um dispositivo executando o Windows 10, versão 1511 ou anterior: um cliente (que deve estar conectado com uma conta da Microsoft reconhecida) clica em uma URL de aplicativo que contém uma ID de campanha personalizada e é redirecionado para a página de listagem da Loja do aplicativo.On a device running Windows 10, version 1511, or earlier: A customer (who must be signed in with a recognized Microsoft account) clicks a URL that contains a custom campaign ID and is redirected to the Store listing page for the app. O cliente adquire o aplicativo enquanto visualiza a listagem da Loja ao clicar na URL.The customer acquires the app while viewing the Store listing as a result of clicking the URL. Nessas versões do Windows 10, o usuário deve se conectar com uma conta da Microsoft reconhecida para que a aquisição seja qualificada como conversão ao recuperar de forma programática a ID da campanha.On these versions of Windows 10, the user must be signed in with a recognized Microsoft account in order for the acquisition to qualify as a conversion when programmatically retrieving the campaign ID.

Observação

Se o cliente sai da página de listagem da Loja, mas retorna à página em 24 horas (seja no mesmo dispositivo ou em um diferente quando conectado com a mesma conta da Microsoft) e adquire o aplicativo, isso é qualificado como uma conversão nos gráficos Visualizações de página e conversões do aplicativo por ID da campanha e Total de conversões de campanha no Relatório de aquisições.If the customer leaves the Store listing page, but returns to the page with 24 hours (either on the same device, or on a different device when signed in with the same a Microsoft account) and acquires the app, this will qualify as a conversion in the App page views and conversions by campaign ID and Total campaign conversions charts in the Acquisitions report. No entanto, isso não será qualificado como uma conversão se você recuperar programaticamente a ID da campanha.However, this will not qualify as a conversion if you programmatically retrieve the campaign ID.

Incorporar uma ID de campanha personalizada à URL da página do seu app da Microsoft StoreEmbed a custom campaign ID to your app's Microsoft Store page URL

Para criar uma URL da página da Microsoft Store para o seu app com uma ID de campanha personalizada:To create a Microsoft Store page URL for your app with a custom campaign ID:

  1. Crie uma cadeia de caracteres de ID para a campanha personalizada.Create an ID string for your custom campaign. Essa cadeia de caracteres pode conter até 100 caracteres, embora recomendemos que você defina IDs de campanha curtas, que sejam facilmente identificáveis.This string can contain up to 100 characters, although we recommend that you define short campaign IDs that are easily identifiable.

Observação

A cadeia de caracteres da ID de campanha pode estar visível para outros desenvolvedores ao exibirem o Relatório de aquisições para seus aplicativos.The campaign ID string may be visible to other developers when they view the Acquisitions report for their apps. Isso pode ocorrer quando um cliente clica na ID de campanha personalizada para entrar na Loja, mas acaba comprando o aplicativo de outro desenvolvedor na mesma sessão, atribuindo a conversão à sua ID de campanha.This can occur when a customer clicks your custom campaign ID to enter the Store and purchases another developer’s app within the same session, thus attributing that conversion to your campaign ID. Esse desenvolvedor visualizará quantas conversões de seu próprio aplicativo resultaram de um clique inicial na ID de campanha, incluindo o nome da ID da campanha, mas não visualizarão os dados sobre como muitos usuários compraram seus aplicativos (ou aplicativos de quaisquer outros desenvolvedores) depois de clicar na sua ID de campanha.That developer will see how many conversions of their own app resulted from an initial click on your campaign ID, including the name of the campaign ID, but they will not see any data about how many users purchased your own apps (or apps from any other developers) after clicking your campaign ID.

  1. Obtenha o link da listagem da Store do seu app no formato HTML ou de protocolo.Get the link for your app's Store listing in HTML or protocol format.

    • Use a URL HTML se você deseja que os clientes naveguem até a listagem da Loja com base na Web do aplicativo em um navegador de qualquer sistema operacional.Use the HTML URL if you want customers to navigate to your app's web-based Store listing in a browser on any operating system. Em dispositivos Windows, o aplicativo da Loja também inicia e exiba a listagem do aplicativo.On Windows devices, the Store app will also launch and display your app's listing. Esta URL tem o formato https://www.microsoft.com/store/apps/*your app ID* .This URL has the format https://www.microsoft.com/store/apps/*your app ID*. Por exemplo, a URL HTML para o Skype é https://www.microsoft.com/store/apps/9wzdncrfj364.For example, the HTML URL for Skype is https://www.microsoft.com/store/apps/9wzdncrfj364. Você pode encontrar essa URL na página Identidade do aplicativo.You can find this URL on your App identity page.

    • Use o formato de protocolo se for promover o app em outros aplicativos do Windows em execução em um computador ou um dispositivo com o aplicativo UWP instalado, ou quando você sabe que os clientes estão em um dispositivo com suporte à Microsoft Store.Use the protocol format if you are promoting your app from within other Windows apps that are running on a device or computer with the UWP app installed, or when you know that your customers are on a device which supports the Microsoft Store. Esse link entrará diretamente na listagem da Loja do seu aplicativo sem abrir um navegador.This link will go directly to your app's Store listing without opening a browser. Esta URL tem o formato ms-windows-store://pdp/?PRODUCTID=*your app id* .This URL has the format ms-windows-store://pdp/?PRODUCTID=*your app id*. Por exemplo, a URL do protocolo para o Skype é ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.For example, the protocol URL for Skype is ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.

  2. Acrescente a seguinte cadeia de caracteres ao final da URL de seu aplicativo:Append the following string to the end of the URL for your app:

    • Para uma URL de formato HTML, acrescente ?cid=*my custom campaign ID* .For an HTML format URL, append ?cid=*my custom campaign ID*. Por exemplo, se o Skype apresentar uma ID de campanha com o valor ** _ campanha personalizada**, a nova URL, incluindo a ID da campanha, será: https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign .For example, if Skype introduces a campaign ID with the value custom_campaign, the new URL including the campaign ID would be: https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign.

    • Para uma URL de formato de protocolo, acrescente &cid=*my custom campaign ID* .For a protocol format URL, append &cid=*my custom campaign ID*. Por exemplo, se o Skype apresentar uma ID de campanha com o valor ** _ campanha personalizada**, a nova URL de protocolo, incluindo a ID da campanha, será: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign .For example, if Skype introduces a campaign ID with the value custom_campaign, the new protocol URL including the campaign ID would be: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign.

Recuperar a ID da campanha personalizada para um app de forma programáticaProgrammatically retrieve the custom campaign ID for an app

Se o aplicativo for um aplicativo UWP, é possível recuperar de modo programático a ID da campanha personalizada associada à aquisição do aplicativo usando APIs no SDK do Windows.If your app is a UWP app, you can programmatically retrieve the custom campaign ID associated with an app's acquisition by using APIs in the Windows SDK. Essas APIs possibilitam muitos cenários de análise e monetização.These APIs make many analytics and monetization scenarios possible. Por exemplo, você poderá descobrir se o usuário atual adquiriu seu aplicativo depois de descobri-lo por meio de sua campanha no Facebook e, em seguida, personalizar a experiência do aplicativo de modo correspondente.For example, you can find out if the current user acquired your app after discovering it through your Facebook campaign, and then customize the app experience accordingly. Como alternativa, se estiver usando um provedor de marketing de app terceirizado, você poderá enviar dados de volta ao provedor.Alternatively, if you are using a third-party app marketing provider, you can send data back to the provider.

Essas APIs retornarão uma cadeia de caracteres da ID da campanha somente se o cliente tiver clicado na URL com a ID da campanha incorporada, exibiu a página da Microsoft Store do app e então adquirido o app sem sair da página de listagem da Store.These APIs will return a campaign ID string only if the customer clicked your URL with the embedded campaign ID, viewed the Microsoft Store page for your app, and then acquires your app without leaving the Store listing page. Se o usuário sair da página e mais tarde retornar e adquirir o app, isso não se qualificará como uma conversão ao usar essas APIs.If the user leaves the page and then later returns and acquires the app, this will not qualify as a conversion when using these APIs.

Existem APIs diferentes para você usar dependendo da versão do Windows 10 a que se destina o seu app:There are different APIs for you to use depending on the version of Windows 10 that your app targets:

  • Windows 10, versão 1607 ou posterior: Use a classe StoreContext no namespace Windows.Services.Store.Windows 10, version 1607, or later: Use the StoreContext class in the Windows.Services.Store namespace. Ao usar essa API, é possível recuperar IDs de campanha personalizada para quaisquer aquisições qualificadas, independentemente do usuário se conectar com conta da Microsoft reconhecida.When using this API, you can retrieve custom campaign IDs for any qualified acquisitions, whether or not the user is signed in with a recognized Microsoft account.

  • Windows 10, versão 1511 ou anterior: Use a classe CurrentApp no namespace ApplicationModel.Windows 10, version 1511, or earlier: Use the CurrentApp class in the Windows.ApplicationModel.Store namespace. Ao usar essa API, é possível recuperar somente IDs de campanha personalizada para aquisições qualificadas, nas quais o usuário está conectado com uma conta da Microsoft reconhecida.When using this API, you can only retrieve custom campaign IDs for qualified acquisitions where the user is signed in with a recognized Microsoft account.

Observação

Embora o namespace Windows.ApplicationModel.Store esteja disponível em todas as versões do Windows 10, recomendamos que você use as APIs no namespace Windows.Services.Store se o aplicativo for direcionado para Windows 10, versão 1607 ou posterior.Although the Windows.ApplicationModel.Store namespace is available in all versions of Windows 10, we recommend that you use the APIs in the Windows.Services.Store namespace if your app targets Windows 10, version 1607, or later. Para obter mais informações sobre as diferenças entre esses namespaces, consulte Compras no aplicativo e avaliações.For more information about the differences between these namespaces, see In-app purchases and trials. O exemplo de código a seguir mostra como estruturar seu código para usar as duas APIs no mesmo projeto.The following code example shows how to structure your code to use both APIs in the same project.

Exemplo de códigoCode example

O exemplo de código a seguir mostra como recuperar a ID de campanha personalizada.The following code example shows how to retrieve the custom campaign ID. Este exemplo usa dois conjuntos de APIs nos namespaces Windows.Services.Store e Windows.ApplicationModel.Store usando código adaptável de versão.This example uses both sets of APIs in the Windows.Services.Store and Windows.ApplicationModel.Store namespaces by using version adaptive code. Ao seguir esse processo, seu código pode ser executado em qualquer versão do Windows 10.By following this process, your code can run on any version of Windows 10. Para usar esse código, a versão do sistema operacional de destino do seu projeto deve ser edição de aniversário do Windows 10 (10.0; Compilação 14394) ou posterior, no entanto, a versão mínima do sistema operacional pode ser uma versão anterior.To use this code, the target OS version of your project must be Windows 10 Anniversary Edition (10.0; Build 14394) or later, although the minimum OS version can be an earlier version.

// This example assumes the code file has using statements for
// System.Linq, System.Threading.Tasks, Windows.Data.Json,
// and Windows.Services.Store.
public async Task<string> GetCampaignId()
{
    // Use APIs in the Windows.Services.Store namespace if they are available
    // (the app is running on a device with Windows 10, version 1607, or later).
    if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent(
         "Windows.Services.Store.StoreContext"))
    {
        StoreContext context = StoreContext.GetDefault();

        // Try to get the campaign ID for users with a recognized Microsoft account.
        StoreProductResult result = await context.GetStoreProductForCurrentAppAsync();
        if (result.Product != null)
        {
            StoreSku sku = result.Product.Skus.FirstOrDefault(s => s.IsInUserCollection);

            if (sku != null)
            {
                return sku.CollectionData.CampaignId;
            }
        }

        // Try to get the campaign ID from the license data for users without a
        // recognized Microsoft account.
        StoreAppLicense license = await context.GetAppLicenseAsync();
        JsonObject json = JsonObject.Parse(license.ExtendedJsonData);
        if (json.ContainsKey("customPolicyField1"))
        {
            return json["customPolicyField1"].GetString();
        }

        // No campaign ID was found.
        return String.Empty;
    }
    // Fall back to using APIs in the Windows.ApplicationModel.Store namespace instead
    // (the app is running on a device with Windows 10, version 1577, or earlier).
    else
    {
#if DEBUG
        return await Windows.ApplicationModel.Store.CurrentAppSimulator.GetAppPurchaseCampaignIdAsync();
#else
        return await Windows.ApplicationModel.Store.CurrentApp.GetAppPurchaseCampaignIdAsync() ;
#endif
    }
}

O código faz o seguinte:This code does the following:

  1. Primeiro, ele verifica se a classe StoreContext no namespace Windows.Services.Store está disponível no dispositivo atual (isso significa que o dispositivo está executando o Windows 10, versão 1607 ou posterior).First, it checks to see if the StoreContext class in the Windows.Services.Store namespace is available on the current device (this means the device is running Windows 10, version 1607, or later). Em caso afirmativo, o código continua a usar essa classe.If so, the code proceeds to use this class.

  2. Em seguida, ele tenta obter a ID de campanha personalizada para o caso de o usuário atual ter uma conta da Microsoft reconhecida.Next, it attempts to get the custom campaign ID for the case where the current user has a recognized Microsoft account. Para fazer isso, o código obtém um objeto StoreSku que representa o app atual SKU e acessa a propriedade CampaignId para recuperar a ID da campanha, se houver uma disponível.To do this, the code gets a StoreSku object that represents the current app SKU, and then it accesses the CampaignId property to retrieve the campaign ID, if one is available.

  3. Em seguida, o código tenta recuperar a ID da campanha para o caso de o usuário atual não ter uma conta da Microsoft reconhecida.The code then attempts to retrieve the campaign ID for the case where the current user does not have a recognized Microsoft account. Nesse caso, a ID da campanha é inserida na licença do app.In this case, the campaign ID is embedded in the app license. O código recupera a licença usando o método GetAppLicenseAsync e, em seguida, analisa o conteúdo JSON de licença para o valor de uma chave denominada customPolicyField1.The code retrieves the license by using the GetAppLicenseAsync method and then parses the JSON contents of the license for the value of a key named customPolicyField1. Esse valor contém a ID da campanha.This value contains the campaign ID.

  4. Se a classe StoreContext no namespace Windows.Services.Store não estiver disponível, o código então recorrerá ao uso do método GetAppPurchaseCampaignIdAsync no namespace Windows.ApplicationModel.Store para recuperar a ID de campanha personalizada (esse namespace está disponível em todas as versões do Windows 10, incluindo versão 1511 e anteriores).If the StoreContext class in the Windows.Services.Store namespace is not available, the code then falls back to using the GetAppPurchaseCampaignIdAsync method in the Windows.ApplicationModel.Store namespace to retrieve the custom campaign ID (this namespace is available in all versions of Windows 10, including version 1511 and earlier). Observe que ao usar esse método, você só pode recuperar IDs de campanha personalizada para aquisições qualificadas, se o usuário tiver uma conta da Microsoft reconhecida.Note that when using this method, you can only retrieve custom campaign IDs for qualified acquisitions where the user has a recognized Microsoft account.

Especifique a ID de campanha no arquivo de proxy para o namespace Windows.ApplicationModel.Store.Specify the campaign ID in the proxy file for the Windows.ApplicationModel.Store namespace

O namespace ApplicationModel inclui CurrentAppSimulator, uma classe especial que simula operações de Loja para testar seu código antes de enviar o aplicativo para a Loja.The Windows.ApplicationModel.Store namespace includes CurrentAppSimulator, a special class that simulates Store operations for testing your code before you submit your app to the Store. Essa classe recupera os dados de um arquivo local chamado arquivo Windows.StoreProxy.xml.This class retrieves data from a local file named Windows.StoreProxy.xml file. O exemplo de código anterior mostra como incluir CurrentApp e CurrentAppSimulator em código de depuração e não depuração no seu projeto.The previous code example shows how to include use both CurrentApp and CurrentAppSimulator in debug and non-debug code in your project. Para testar esse código em um ambiente de depuração, adicione um elemento AppPurchaseCampaignId ao arquivo WindowsStoreProxy.xml no computador de desenvolvimento, conforme o exemplo a seguir.To test this code in a debug environment, add an AppPurchaseCampaignId element to the WindowsStoreProxy.xml file on your development computer, as shown in the following example. Quando você executar o app, o método GetAppPurchaseCampaignIdAsync sempre retornará esse valor.When you run the app, the GetAppPurchaseCampaignIdAsync method will always return this value.

<CurrentApp>
    ...
    <AppPurchaseCampaignId>your custom campaign ID</AppPurchaseCampaignId>
</CurrentApp>

O namespace Windows.Services.Store não fornece uma classe que seja possível usar para simular informações de licença durante o teste.The Windows.Services.Store namespace does not provide a class that you can use to simulate license info during testing. Em vez disso, você deve publicar um aplicativo na Loja e baixá-lo para seu dispositivo de desenvolvimento para usar sua licença para teste.Instead, you must publish an app to the Store and download that app to your development device to use its license for testing. Para obter mais informações, consulte Compras no aplicativo e avaliações.For more information, see In-app purchases and trials.

Testar sua campanha personalizadaTest your custom campaign

Antes de promover uma URL de campanha personalizada, recomendamos que você teste a campanha personalizada fazendo o seguinte:Before you promote a custom campaign URL, we recommend that you test your custom campaign by doing the following:

  1. Entre em sua conta da Microsoft no dispositivo que estiver usando para testes.Sign in to a Microsoft account on the device you are using for testing.

  2. Clique em sua URL de campanha personalizada.Click your custom campaign URL. Entre na página do app corretamente e feche o aplicativo UWP ou a página do navegador.Make sure you are taken to your app page, and then close the UWP app or the browser page.

  3. Clique na URL muitas vezes, fechando o aplicativo UWP ou a página do navegador após cada visita à página do seu app.Click the URL several more times, closing the UWP app or the browser page after each visit to your app's page. Em uma das visitas à página do aplicativo, adquira-o para gerar uma conversão.During one of the visits to your app's page, acquire your app to generate a conversion. Conte o número total de vezes que você clicou na URL.Count the total number of times you clicked the URL.

  4. Confirme se as exibições e conversões de página esperadas aparecem nas exibições de página do aplicativo e conversões por ID da campanha e gráficos de conversões de campanha totais no relatório de aquisiçõese teste o código do aplicativo para confirmar se ele pode recuperar com êxito a ID da campanha usando as APIs descritas acima.Confirm whether the expected page views and conversions appear in the App page views and conversions by campaign ID and Total campaign conversions charts in the Acquisitions report, and test your app's code to confirm whether it can successfully retrieve the campaign ID using the APIs described above.