Compartir a través de

Creación de una campaña de promoción de aplicaciones personalizada

  • Artículo

Además de crear una campaña de anuncios de para tu aplicación que se ejecutará en aplicaciones de Windows, también puedes promocionar la aplicación con 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 Store y conversiones. Una conversión es una adquisición de una aplicación que resulta de la visita de un cliente a la página de descripción de Store de su aplicación desde una URL que incluye un ID de campaña personalizada. 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 los datos sobre las vistas de página y las conversiones de su aplicación o complemento en los gráficos de Vistas de páginas y conversiones de la aplicación por identificador de campaña y Total de conversiones de campaña en el Informe de adquisiciones.
  • Si la aplicación es una aplicación para la 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 del lanzamiento del nuevo juego en su página de Facebook, incluyendo un enlace a la página de la tienda del juego. Muchos de sus jugadores también la siguen en Twitter, por lo que también publica un anuncio con el vínculo al listado en la tienda 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 página de la Tienda 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 posteriores del juego que cumplan los requisitos y cualquier compra complementaria se asocian a la campaña personalizada y se contabilizan 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 se produce cuando un cliente hace clic en una URL promocionada a través de una campaña personalizada. Hay diferentes escenarios para calificar como una conversión para los gráficos de Vistas de páginas y conversiones de la aplicación por identificador de campaña y Total de conversiones de campaña en el Informe de adquisiciones y para calificar como conversión para recuperar mediante programación el identificador de campaña.

Conversiones calificadas en el informe de adquisiciones

Los siguientes escenarios se consideran una conversión para los gráficos de Vistas de páginas y conversiones de la aplicación por identificador de campaña y Total de conversiones de campaña en el Informe de 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 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 sale de la página de descripción de Store, pero vuelve en 24 horas (ya sea en el mismo dispositivo o en otro dispositivo cuando haya iniciado sesión con la misma cuenta de Microsoft) y adquiere la aplicación, se calificará como una conversión en los gráficos Vistas de páginas y conversiones de la aplicación por identificador de campaña y Total de conversiones de campaña en el Informe de adquisiciones. Sin embargo, no se calificará como conversión si recupera por programación el identificador de 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 de adquisiciones para 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.

  1. Obtenga el enlace de la descripción de Store de su aplicación en formato HTML o de protocolo.

    • Usa la URL HTML si quieres que los clientes naveguen a la página de la Tienda en la web de la aplicación en un navegador en cualquier sistema operativo. En los dispositivos Windows, la aplicación de la Tienda también se iniciará y mostrará la descripción de la aplicación. Esta dirección URL tiene el formato https://apps.microsoft.com/detail/*your app ID*. Por ejemplo, la dirección URL HTML de Skype es https://apps.microsoft.com/detail/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 al listado en la Tienda de tu 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.

  2. 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 que incluye el identificador de campaña sería: https://apps.microsoft.com/detail/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 del 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 APIs devolverán una cadena de ID de campaña solo si el cliente hizo clic en la URL con el identificador de campaña incrustado, ve la página de la Microsoft Store de tu aplicación y luego adquiere la aplicación sin salir de la página de listado de la Tienda. Si el usuario sale de la página y, a continuación, vuelve y adquiere la aplicación, 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 personalizada para cualquier adquisición calificada, tanto si el usuario ha iniciado sesión con una cuenta de Microsoft reconocida como si no.

  • Windows 10, versión 1511 o anterior: usa la clase CurrentApp en el espacio de nombres Windows.ApplicationModel.Store. Al usar esta API, solo puede obtener identificadores de campaña personalizados para las adquisiciones calificadas en las cuales 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 dentro de 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 StoreSku objeto 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 alguno 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 de 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 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 personalizada para adquisiciones calificadas donde el usuario tiene una cuenta Microsoft reconocida.

Especificación del 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, añada un elemento AppPurchaseCampaignId al archivo WindowsStoreProxy.xml en su equipo de desarrollo, tal como se muestra en el ejemplo a continuación. 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 puede 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 su aplicación, compre 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 los gráficos de vistas y conversiones de la aplicación por ID de campaña, y en los gráficos de conversiones totales de campaña en el informe de Adquisiciones . Pruebe el código de su aplicación para confirmar si puede obtener con éxito el ID de campaña utilizando las API mencionadas anteriormente.