Crear una campaña de promoción de la aplicación personalizada

Además de crear una campaña publicitaria para la aplicación que se ejecutará en aplicaciones de Windows, también puedes promocionar la aplicación mediante otros canales. Por ejemplo, puedes promocionar tu aplicación mediante un proveedor de marketing de aplicaciones de terceros, o puedes publicar vínculos a la aplicación en sitios de redes sociales. Estas actividades se denominan campañas personalizadas.

Si ejecuta campañas personalizadas para la aplicación, puede realizar un seguimiento del rendimiento relativo de cada campaña creando una dirección URL diferente para cada campaña personalizada, donde cada dirección URL contiene un identificador de campaña diferente. Cuando un cliente que ejecuta Windows 10 hace clic en una dirección URL que contiene un identificador de campaña, Microsoft asocia el clic a la campaña personalizada correspondiente y hace que estos datos estén disponibles en el Centro de partners.

Importante

Solo se realiza un seguimiento de estos datos para los clientes de Windows 10. Los clientes que usan otros sistemas operativos todavía pueden seguir el vínculo a la descripción de la aplicación, pero no se incluirán datos sobre las actividades de esos clientes.

Hay dos tipos principales de datos asociados a campañas personalizadas: vistas de página para la descripción de la Tienda de la aplicación y conversiones. Una conversión es una adquisición de aplicaciones que se obtiene de un cliente que ve la página de descripción de la Tienda de la aplicación desde una dirección URL que incluye un identificador de campaña personalizado. Para obtener más información sobre las conversiones, consulte Descripción de cómo las adquisiciones de aplicaciones se califican como conversiones en este tema.

Puede recuperar datos de rendimiento de campaña personalizados para la aplicación de las maneras siguientes:

• Puede ver datos sobre las vistas de página y las conversiones de la aplicación o el complemento desde las vistas de página de la aplicación y las conversiones por identificador de campaña y gráficos de conversiones de campaña total en el informe Adquisiciones.
• Si la aplicación es una aplicación de Plataforma universal de Windows (UWP), puedes usar las API en Windows SDK para recuperar mediante programación el identificador de campaña personalizado que dio lugar a una conversión.

Escenario de campaña personalizada de ejemplo

Considere un desarrollador de juegos que ha terminado de crear un nuevo juego y desea promoverlo a los jugadores de sus juegos existentes. Publica el anuncio de la nueva versión del juego en su página de Facebook, incluido un vínculo a la descripción de store del juego. Muchos de sus jugadores también la siguen en Twitter, por lo que también tweets un anuncio con el vínculo a la descripción de store del juego.

Para realizar un seguimiento del éxito de cada uno de estos canales de promoción, el desarrollador crea dos variantes de la dirección URL a la descripción de store del juego:

• La dirección URL que publicará en su página de Facebook incluye el identificador de campaña personalizado. my-facebook-campaign

• La dirección URL que publicará en Twitter incluye el identificador de campaña personalizado. my-twitter-campaign

A medida que sus seguidores de Facebook y Twitter hacen clic en las direcciones URL, Microsoft realiza un seguimiento de cada clic y lo asocia a la campaña personalizada correspondiente. Las adquisiciones de calificación posteriores del juego y las compras de complementos están asociadas a la campaña personalizada y se notifican como conversiones.

Descripción de cómo las adquisiciones se califican como conversiones

Una conversión de campaña personalizada es una adquisición que resulta de que un cliente hace clic en una dirección URL que se promueve a través de una campaña personalizada. Hay diferentes escenarios para calificar como una conversión para las vistas de página de la aplicación y conversiones por identificador de campaña y gráficos de conversiones de campaña total en el informe Adquisiciones y para calificar como conversión para recuperar mediante programación el identificador de campaña.

Conversiones aptas en el informe adquisiciones

Los siguientes escenarios se califican como una conversión para las vistas de página de la aplicación y conversiones por identificador de campaña y gráficos de conversiones de campaña total en el informe Adquisiciones:

• Un cliente con o sin una cuenta Microsoft reconocida hace clic en una dirección URL de aplicación que contiene un identificador de campaña personalizado y se redirige a la descripción de la Tienda para la aplicación. A continuación, ese mismo cliente adquiere la aplicación en un plazo de 24 horas después de hacer clic en la dirección URL de Microsoft Store con el identificador de campaña personalizado.

• Si el cliente adquiere la aplicación en un dispositivo diferente al del que hace clic en la dirección URL con el identificador de campaña personalizado, la conversión solo se contará si el cliente ha iniciado sesión con la misma cuenta de Microsoft que al hacer clic en la dirección URL.

Nota:

En el caso de las adquisiciones de aplicaciones que se cuentan como conversiones para una campaña personalizada, las compras de complementos de esa aplicación también se cuentan como conversiones para la misma campaña personalizada.

Calificar conversiones al recuperar mediante programación el identificador de campaña

Para calificar como una conversión al recuperar mediante programación el identificador de campaña asociado a la aplicación, se deben cumplir las condiciones siguientes:

• En un dispositivo que ejecuta Windows 10, versión 1607 o posterior: un cliente (independientemente de si ha iniciado sesión en una cuenta microsoft reconocida o no) hace clic en una dirección URL que contiene un identificador de campaña personalizado y se redirige a la página de descripción de la Tienda para la aplicación. El cliente adquiere la aplicación mientras ve la descripción de la Tienda como resultado de hacer clic en la dirección URL.

• En un dispositivo que ejecuta Windows 10, versión 1511 o versiones anteriores: un cliente (que debe iniciar sesión con una cuenta microsoft reconocida) hace clic en una dirección URL que contiene un identificador de campaña personalizado y se redirige a la página de descripción de la Tienda para la aplicación. El cliente adquiere la aplicación mientras ve la descripción de la Tienda como resultado de hacer clic en la dirección URL. En estas versiones de Windows 10 o Windows 11, el usuario debe iniciar sesión con una cuenta de Microsoft reconocida para que la adquisición se califique como una conversión al recuperar mediante programación el identificador de campaña.

Nota:

Si el cliente deja la página de descripción de la Tienda, pero vuelve a la página con 24 horas (ya sea en el mismo dispositivo o en otro dispositivo cuando haya iniciado sesión con la misma cuenta microsoft) y adquiera la aplicación, esto se calificará como una conversión en las vistas de página de la aplicación y conversiones por identificador de campaña y gráficos de conversiones de campaña total en el informe Adquisiciones. Sin embargo, esto no se calificará como una conversión si recupera mediante programación el identificador de la campaña.

Insertar un identificador de campaña personalizado en la dirección URL de la página de Microsoft Store de la aplicación

Para crear una dirección URL de página de Microsoft Store para la aplicación con un identificador de campaña personalizado:

1. Cree una cadena de identificador para la campaña personalizada. Esta cadena puede contener hasta 100 caracteres, aunque se recomienda definir identificadores de campaña corta que sean fácilmente identificables.

Nota:

La cadena de identificador de campaña puede ser visible para otros desarrolladores cuando vean el informe adquisiciones de sus aplicaciones. Esto puede ocurrir cuando un cliente hace clic en tu id. de campaña personalizada para entrar en la Tienda y compra la aplicación de otro desarrollador dentro de la misma sesión, lo que atribuye esa conversión a tu identificador de campaña. Ese desarrollador verá cuántas conversiones de su propia aplicación tuvieron como resultado un clic inicial en el identificador de campaña, incluido el nombre del identificador de campaña, pero no verán ningún dato sobre cuántos usuarios compraron sus propias aplicaciones (o aplicaciones de cualquier otro desarrollador) después de hacer clic en el identificador de la campaña.

2. Obtén el vínculo de la descripción de la Tienda de tu aplicación en formato HTML o de protocolo.

   • Usa la dirección URL HTML si quieres que los clientes naveguen a la descripción de la Tienda basada en web de la aplicación en un explorador en cualquier sistema operativo. En los dispositivos Windows, la aplicación Store también se iniciará y mostrará la descripción de su aplicación. Esta dirección URL tiene el formato https://www.microsoft.com/store/apps/*your app ID*. Por ejemplo, la dirección URL HTML de Skype es https://www.microsoft.com/store/apps/9wzdncrfj364. Puede encontrar esta dirección URL en la página Identidad de la aplicación.

   • Usa el formato de protocolo si estás promocionando tu aplicación desde otras aplicaciones de Windows que se ejecutan en un dispositivo o equipo con la aplicación para UWP instalada, o cuando sepas que tus clientes están en un dispositivo que admita Microsoft Store. Este vínculo irá directamente a la descripción de la Tienda de la aplicación sin abrir un explorador. Esta dirección URL tiene el formato ms-windows-store://pdp/?PRODUCTID=*your app id*. Por ejemplo, la dirección URL del protocolo para Skype es ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.

3. Anexe la cadena siguiente al final de la dirección URL de la aplicación:

   • Para una dirección URL de formato HTML, anexe ?cid=*my custom campaign ID*. Por ejemplo, si Skype introduce un identificador de campaña con el valor custom_campaign, la nueva dirección URL, incluido el identificador de campaña, sería: https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign.

   • Para una dirección URL de formato de protocolo, anexe &cid=*my custom campaign ID*. Por ejemplo, si Skype introduce un identificador de campaña con el valor custom_campaign, la nueva dirección URL de protocolo, incluido el identificador de campaña sería: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign.

Recuperación mediante programación del identificador de campaña personalizado de una aplicación

Si la aplicación es una aplicación para UWP, puedes recuperar mediante programación el identificador de campaña personalizado asociado a la adquisición de una aplicación mediante API en Windows SDK. Estas API hacen posible muchos escenarios de análisis y monetización. Por ejemplo, puedes averiguar si el usuario actual adquirió tu aplicación después de descubrirla a través de tu campaña de Facebook y, a continuación, personalizar la experiencia de la aplicación en consecuencia. Como alternativa, si usa un proveedor de marketing de aplicaciones de terceros, puede devolver datos al proveedor.

Estas API devolverán una cadena de id. de campaña solo si el cliente ha clic en la dirección URL con el identificador de campaña incrustado, se ve la página de Microsoft Store de la aplicación y, a continuación, adquiere la aplicación sin salir de la página de descripción de la Tienda. Si el usuario deja la página y, a continuación, devuelve y adquiere la aplicación, esto no se calificará como una conversión al usar estas API.

Hay diferentes API que puedes usar en función de la versión de Windows a la que se dirige la aplicación:

• Windows 10, versión 1607 o posterior: usa la clase StoreContext en el espacio de nombres Windows.Services.Store. Al usar esta API, puede recuperar identificadores de campaña personalizados para cualquier adquisición calificada, independientemente de si el usuario ha iniciado sesión con una cuenta de Microsoft reconocida.

• Windows 10, versión 1511 o versiones anteriores: use la clase CurrentApp en el espacio de nombres Windows.ApplicationModel.Store. Al usar esta API, solo puede recuperar identificadores de campaña personalizados para adquisiciones calificadas en las que el usuario ha iniciado sesión con una cuenta de Microsoft reconocida.

Nota:

Aunque el espacio de nombres Windows.ApplicationModel.Store está disponible en todas las versiones de Windows 10 o Windows 11, se recomienda usar las API en el espacio de nombres Windows.Services.Store si la aplicación tiene como destino Windows 10, versión 1607 o posterior. Para obtener más información sobre las diferencias entre estos espacios de nombres, consulte Compras desde la aplicación y pruebas. En el ejemplo de código siguiente se muestra cómo estructurar el código para usar ambas API en el mismo proyecto.

Ejemplo de código

En el ejemplo de código siguiente se muestra cómo recuperar el identificador de campaña personalizado. En este ejemplo se usan ambos conjuntos de API en los espacios de nombres Windows.Services.Store y Windows.ApplicationModel.Store mediante código adaptable de versión. Al seguir este proceso, el código se puede ejecutar en cualquier versión de Windows 10 o Windows 11. Para usar este código, la versión del sistema operativo de destino del proyecto debe ser Windows 10 Anniversary Edition (10.0; Compilación 14394) o posterior, aunque la versión mínima del sistema operativo puede ser una versión anterior.

// 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
    }
}

Este código hace lo siguiente:

1. En primer lugar, comprueba si la clase StoreContext del espacio de nombres Windows.Services.Store está disponible en el dispositivo actual (esto significa que el dispositivo ejecuta Windows 10, versión 1607 o posterior). Si es así, el código continúa usando esta clase.

2. A continuación, intenta obtener el identificador de campaña personalizado para el caso en el que el usuario actual tiene una cuenta Microsoft reconocida. Para ello, el código obtiene un objeto StoreSku que representa la SKU de la aplicación actual y, a continuación, accede a la propiedad CampaignId para recuperar el identificador de campaña, si hay uno disponible.

3. A continuación, el código intenta recuperar el identificador de campaña para el caso en el que el usuario actual no tiene una cuenta Microsoft reconocida. En este caso, el identificador de campaña se inserta en la licencia de la aplicación. El código recupera la licencia mediante el método GetAppLicenseAsync y, a continuación, analiza el contenido JSON de la licencia para el valor de una clave denominada customPolicyField1. Este valor contiene el identificador de campaña.

4. Si la clase StoreContext del espacio de nombres de Windows.Services.Store no está disponible, el código vuelve a usar el método GetAppPurchaseCampaignIdAsync en el espacio de nombres Windows.ApplicationModel.Store para recuperar el identificador de campaña personalizado (este espacio de nombres está disponible en todas las versiones de Windows 10 o Windows 11). Tenga en cuenta que, al usar este método, solo puede recuperar identificadores de campaña personalizados para adquisiciones calificadas en las que el usuario tiene una cuenta Microsoft reconocida.

Especificar el identificador de campaña en el archivo proxy para el espacio de nombres Windows.ApplicationModel.Store

El espacio de nombres Windows.ApplicationModel.Store incluye CurrentAppSimulator, una clase especial que simula las operaciones de Store para probar el código antes de enviar la aplicación a la Tienda. Esta clase recupera datos de un archivo local denominado Windows.StoreProxy.xml archivo. En el ejemplo de código anterior se muestra cómo incluir el uso de CurrentApp y CurrentAppSimulator en el código de depuración y no depuración del proyecto. Para probar este código en un entorno de depuración, agregue un elemento AppPurchaseCampaignId al archivo WindowsStoreProxy.xml del equipo de desarrollo, como se muestra en el ejemplo siguiente. Al ejecutar la aplicación, el método GetAppPurchaseCampaignIdAsync siempre devolverá este valor.

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

El espacio de nombres Windows.Services.Store no proporciona una clase que puedas usar para simular información de licencia durante las pruebas. En su lugar, debes publicar una aplicación en la Tienda y descargar esa aplicación en el dispositivo de desarrollo para usar su licencia para las pruebas. Para obtener más información, consulte Pruebas y compras desde la aplicación.

Prueba de la campaña personalizada

Antes de promocionar una dirección URL de campaña personalizada, se recomienda probar la campaña personalizada haciendo lo siguiente:

1. Inicie sesión en una cuenta Microsoft en el dispositivo que usa para realizar pruebas.

2. Haga clic en la dirección URL de la campaña personalizada. Asegúrate de que te llevas a la página de la aplicación y, a continuación, cierra la aplicación para UWP o la página del explorador.

3. Haz clic en la dirección URL varias veces, cerrando la aplicación para UWP o la página del explorador después de cada visita a la página de la aplicación. Durante una de las visitas a la página de la aplicación, adquiera la aplicación para generar una conversión. Cuente el número total de veces que ha clic en la dirección URL.

4. Confirme si las vistas y conversiones de página esperadas aparecen en las vistas de página de la aplicación y conversiones por identificador de campaña y gráficos de conversiones de campaña total en el informe Adquisiciones y pruebe el código de la aplicación para confirmar si puede recuperar correctamente el identificador de campaña mediante las API descritas anteriormente.