Créer une campagne personnalisée de promotion d’applications

Outre la création d’une campagne publicitaire pour votre application qui s’exécutera dans des applications Windows, vous pouvez également promouvoir votre application à l’aide d’autres canaux. Par exemple, vous pouvez promouvoir votre application à l’aide d’un fournisseur de marketing d’application tiers, ou vous pouvez publier des liens vers votre application sur des sites de réseaux sociaux. Ces activités sont appelées campagnes personnalisées.

Si vous exécutez des campagnes personnalisées pour votre application, vous pouvez suivre les performances relatives de chaque campagne en créant une URL différente pour chaque campagne personnalisée, où chaque URL contient un ID de campagne différent. Lorsqu’un client exécutant Windows 10 clique sur une URL contenant un ID de campagne, Microsoft associe le clic à la campagne personnalisée correspondante et met ces données à votre disposition dans l’Espace partenaires.

Il existe deux types de données principaux associés à des campagnes personnalisées : les affichages de pages pour la description du Windows Store de votre application et les conversions. Une conversion est une acquisition d’application qui résulte d’un client qui consulte la page de référencement du Windows Store de votre application à partir d’une URL qui inclut un ID de campagne personnalisé. Pour plus d’informations sur les conversions, consultez Présentation de la façon dont les acquisitions d’applications sont qualifiées de conversions dans cette rubrique.

Vous pouvez récupérer des données de performances de campagne personnalisées pour votre application de la manière suivante :

• Vous pouvez afficher des données sur les affichages de page et les conversions pour votre application ou module complémentaire à partir des affichages et conversions de page d’application par ID de campagne et graphiques total de conversions de campagne dans le rapport Acquisitions.
• Si votre application est une application plateforme Windows universelle (UWP), vous pouvez utiliser des API dans le Kit de développement logiciel (SDK) Windows pour récupérer par programmation l’ID de campagne personnalisé qui a entraîné une conversion.

Exemple de scénario de campagne personnalisée

Considérez un développeur de jeux qui a fini de construire un nouveau jeu et aimerait le promouvoir aux joueurs de ses jeux existants. Elle publie l’annonce de la nouvelle version du jeu sur sa page Facebook, y compris un lien vers la description du store du jeu. Beaucoup de ses joueurs suivent également sur Twitter, donc elle tweete également une annonce avec le lien vers la description du store du jeu.

Pour suivre la réussite de chacun de ces canaux de promotion, le développeur crée deux variantes de l’URL de la description du Store du jeu :

• L’URL qu’elle publiera sur sa page Facebook inclut l’ID de campagne personnalisé my-facebook-campaign

• L’URL qu’elle publiera sur Twitter inclut l’ID de campagne personnalisé my-twitter-campaign

À mesure que ses abonnés Facebook et Twitter cliquent sur les URL, Microsoft effectue le suivi de chaque clic et l’associe à la campagne personnalisée correspondante. Les acquisitions éligibles ultérieures du jeu et tous les achats d’extensions sont associés à la campagne personnalisée et signalées comme conversions.

Comprendre comment les acquisitions sont qualifiées de conversions

Une conversion de campagne personnalisée est une acquisition qui résulte d’un clic sur une URL promue par le biais d’une campagne personnalisée. Il existe différents scénarios de qualification en tant que conversion pour les affichages et conversions de page d’application par ID de campagne et graphiques total de conversions de campagne dans le rapport Acquisitions et pour la qualification comme conversion pour récupérer par programme l’ID de campagne.

Conversions éligibles dans le rapport Acquisitions

Les scénarios suivants sont qualifiés de conversion pour les affichages et conversions de pages d’application par ID de campagne et graphiques Total des conversions de campagne dans le rapport Acquisitions :

• Un client disposant ou sans compte Microsoft reconnu clique sur une URL d’application qui contient un ID de campagne personnalisé et est redirigé vers la description du Windows Store pour l’application. Ensuite, ce même client acquiert l’application dans les 24 heures après avoir cliqué sur l’URL du Microsoft Store avec l’ID de campagne personnalisé.

• Si le client acquiert l’application sur un autre appareil que celui sur lequel il a cliqué sur l’URL avec l’ID de campagne personnalisé, la conversion est comptabilisée uniquement si le client est connecté avec le même compte Microsoft que lorsqu’il a cliqué sur l’URL.

Conversions éligibles lors de la récupération programmatique de l’ID de campagne

Pour être qualifié de conversion lors de la récupération par programmation de l’ID de campagne associé à l’application, les conditions suivantes doivent être remplies :

• Sur un appareil exécutant Windows 10, version 1607 ou ultérieure : un client (connecté à un compte Microsoft reconnu ou non) clique sur une URL contenant un ID de campagne personnalisé et est redirigé vers la page de description du Windows Store pour l’application. Le client acquiert l’application lors de l’affichage de la description du Windows Store en cliquant sur l’URL.

• Sur un appareil exécutant Windows 10, version 1511 ou antérieure : un client (qui doit être connecté avec un compte Microsoft reconnu) clique sur une URL contenant un ID de campagne personnalisé et est redirigé vers la page de description du Windows Store pour l’application. Le client acquiert l’application lors de l’affichage de la description du Windows Store en cliquant sur l’URL. Sur ces versions de Windows 10 ou Windows 11, l’utilisateur doit être connecté avec un compte Microsoft reconnu pour que l’acquisition soit qualifiée de conversion lors de la récupération par programme de l’ID de campagne.

Incorporer un ID de campagne personnalisé à l’URL de la page du Microsoft Store de votre application

Pour créer une URL de page du Microsoft Store pour votre application avec un ID de campagne personnalisé :

1. Créez une chaîne d’ID pour votre campagne personnalisée. Cette chaîne peut contenir jusqu’à 100 caractères, bien que nous vous recommandons de définir des ID de campagne courts facilement identifiables.

2. Obtenez le lien pour la description du Windows Store de votre application au format HTML ou protocole.

   • Utilisez l’URL HTML si vous souhaitez que les clients accèdent à la description du Windows Store web de votre application dans un navigateur sur n’importe quel système d’exploitation. Sur les appareils Windows, l’application Store lance et affiche également la description de votre application. Cette URL a le format https://www.microsoft.com/store/apps/*your app ID*. Par exemple, l’URL HTML pour Skype est https://www.microsoft.com/store/apps/9wzdncrfj364. Vous trouverez cette URL sur la page d’identité de votre application.

   • Utilisez le format de protocole si vous promouez votre application à partir d’autres applications Windows qui s’exécutent sur un appareil ou un ordinateur avec l’application UWP installée, ou lorsque vous savez que vos clients se trouvent sur un appareil prenant en charge le Microsoft Store. Ce lien accède directement à la description du Windows Store de votre application sans ouvrir un navigateur. Cette URL a le format ms-windows-store://pdp/?PRODUCTID=*your app id*. Par exemple, l’URL du protocole pour Skype est ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.

3. Ajoutez la chaîne suivante à la fin de l’URL de votre application :

   • Pour une URL de format HTML, ajoutez ?cid=*my custom campaign ID*. Par exemple, si Skype introduit un ID de campagne avec la valeur custom_campaign, la nouvelle URL incluant l’ID de campagne est : https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign.

   • Pour une URL de format de protocole, ajoutez &cid=*my custom campaign ID*. Par exemple, si Skype introduit un ID de campagne avec la valeur custom_campaign, la nouvelle URL de protocole incluant l’ID de campagne est : ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign.

Récupérer par programmation l’ID de campagne personnalisé pour une application

Si votre application est une application UWP, vous pouvez récupérer par programmation l’ID de campagne personnalisé associé à l’acquisition d’une application à l’aide d’API dans le Kit de développement logiciel (SDK) Windows. Ces API rendent de nombreux scénarios d’analytique et de monétisation possibles. Par exemple, vous pouvez déterminer si l’utilisateur actuel a acquis votre application après l’avoir découverte via votre campagne Facebook, puis personnaliser l’expérience de l’application en conséquence. Sinon, si vous utilisez un fournisseur de marketing d’application tiers, vous pouvez renvoyer des données au fournisseur.

Ces API retournent une chaîne d’ID de campagne uniquement si le client a cliqué sur votre URL avec l’ID de campagne incorporé, consulté la page Du Microsoft Store pour votre application, puis acquiert votre application sans quitter la page de description du Windows Store. Si l’utilisateur quitte la page, puis retourne et acquiert l’application, cela ne sera pas qualifié de conversion lors de l’utilisation de ces API.

Vous pouvez utiliser différentes API en fonction de la version de Windows que votre application cible :

• Windows 10, version 1607 ou ultérieure : utilisez la classe StoreContext dans l’espace de noms Windows.Services.Store. Lorsque vous utilisez cette API, vous pouvez récupérer des ID de campagne personnalisés pour toutes les acquisitions qualifiées, que l’utilisateur soit connecté ou non avec un compte Microsoft reconnu.

• Windows 10, version 1511 ou antérieure : utilisez la classe CurrentApp dans l’espace de noms Windows.ApplicationModel.Store. Lorsque vous utilisez cette API, vous pouvez uniquement récupérer des ID de campagne personnalisés pour les acquisitions qualifiées où l’utilisateur est connecté avec un compte Microsoft reconnu.

Exemple de code

L’exemple de code suivant montre comment récupérer l’ID de campagne personnalisé. Cet exemple utilise les deux ensembles d’API dans les espaces de noms Windows.Services.Store et Windows.ApplicationModel.Store à l’aide du code adaptatif de version. En suivant ce processus, votre code peut s’exécuter sur n’importe quelle version de Windows 10 ou Windows 11. Pour utiliser ce code, la version cible du système d’exploitation de votre projet doit être Windows 10 Édition anniversaire (10.0 ; Build 14394) ou version ultérieure, bien que la version minimale du système d’exploitation puisse être une version antérieure.

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

Ce code effectue ce qui suit :

1. Tout d’abord, il vérifie si la classe StoreContext dans l’espace de noms Windows.Services.Store est disponible sur l’appareil actuel (cela signifie que l’appareil exécute Windows 10, version 1607 ou ultérieure). Si c’est le cas, le code passe à l’utilisation de cette classe.

2. Ensuite, il tente d’obtenir l’ID de campagne personnalisé pour le cas où l’utilisateur actuel a un compte Microsoft reconnu. Pour ce faire, le code obtient un objet StoreSku qui représente la référence SKU de l’application actuelle, puis accède à la propriété CampaignId pour récupérer l’ID de campagne, le cas échéant.

3. Le code tente ensuite de récupérer l’ID de campagne pour le cas où l’utilisateur actuel n’a pas de compte Microsoft reconnu. Dans ce cas, l’ID de campagne est incorporé dans la licence d’application. Le code récupère la licence à l’aide de la méthode GetAppLicenseAsync, puis analyse le contenu JSON de la licence pour la valeur d’une clé nommée customPolicyField1. Cette valeur contient l’ID de campagne.

4. Si la classe StoreContext dans l’espace de noms Windows.Services.Store n’est pas disponible, le code revient ensuite à utiliser la méthode GetAppPurchaseCampaignIdAsync dans l’espace de noms Windows.ApplicationModel.Store pour récupérer l’ID de campagne personnalisé (cet espace de noms est disponible dans toutes les versions de Windows 10 ou Windows 11). Notez que lorsque vous utilisez cette méthode, vous pouvez uniquement récupérer des ID de campagne personnalisés pour les acquisitions qualifiées où l’utilisateur a un compte Microsoft reconnu.

Spécifiez l’ID de campagne dans le fichier proxy de l’espace de noms Windows.ApplicationModel.Store

L’espace de noms Windows.ApplicationModel.Store inclut CurrentAppSimulator, une classe spéciale qui simule les opérations du Windows Store pour tester votre code avant de soumettre votre application au Windows Store. Cette classe récupère les données d’un fichier local nommé Windows.StoreProxy.xml fichier. L’exemple de code précédent montre comment inclure l’utilisation de CurrentApp et CurrentAppSimulator dans le code de débogage et non-debug dans votre projet. Pour tester ce code dans un environnement de débogage, ajoutez un élément AppPurchaseCampaignId au fichier WindowsStoreProxy.xml sur votre ordinateur de développement, comme illustré dans l’exemple suivant. Lorsque vous exécutez l’application, la méthode GetAppPurchaseCampaignIdAsync retourne toujours cette valeur.

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

L’espace de noms Windows.Services.Store ne fournit pas de classe que vous pouvez utiliser pour simuler des informations de licence pendant les tests. Au lieu de cela, vous devez publier une application dans le Windows Store et télécharger cette application sur votre appareil de développement pour utiliser sa licence pour les tests. Pour plus d’informations, consultez Achats in-app et versions d’évaluation.

Tester votre campagne personnalisée

Avant de promouvoir une URL de campagne personnalisée, nous vous recommandons de tester votre campagne personnalisée en procédant comme suit :

1. Connectez-vous à un compte Microsoft sur l’appareil que vous utilisez pour les tests.

2. Cliquez sur votre URL de campagne personnalisée. Vérifiez que vous êtes dirigé vers votre page d’application, puis fermez l’application UWP ou la page du navigateur.

3. Cliquez sur l’URL plusieurs fois, fermant l’application UWP ou la page du navigateur après chaque visite de la page de votre application. Pendant l’une des visites sur la page de votre application, achetez votre application pour générer une conversion. Comptez le nombre total de fois où vous avez cliqué sur l’URL.

4. Vérifiez si les affichages et conversions de pages attendus apparaissent dans les affichages et conversions de page d’application par ID de campagne et nombre total de conversions de campagne dans le rapport Acquisitions, puis testez le code de votre application pour vérifier s’il peut récupérer correctement l’ID de campagne à l’aide des API décrites ci-dessus.