Créer une campagne personnalisée de promotion d’applications
En plus de créer une campagne publicitaire pour votre application qui s’exécutera dans les applications Windows, vous pouvez également promouvoir votre application à l’aide d’autres canaux. Par exemple, vous pouvez promouvoir votre application en faisant appel à un fournisseur de commercialisation d’applications tiers, ou en publiant des liens vers votre application sur des médias 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 qui contient un ID de campagne, Microsoft associe le clic à la campagne personnalisée correspondante et met ces données à votre disposition dans l’Espace partenaires.
Important
Ces données sont suivies uniquement pour les clients sur Windows 10. Les clients utilisant d’autres systèmes d’exploitation peuvent suivre le lien vers la description de votre application, mais les données sur les activités de ces clients ne seront pas incluses.
Il existe deux types de données main associés aux campagnes personnalisées : les vues de page pour la description de votre application dans le Windows Store et les conversions. Une conversion est une acquisition d’application qui résulte d’un client qui consulte la page d’annonce de votre application dans le Windows Store à 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.
Pour récupérer les données de performances de campagne personnalisée de votre application, procédez comme suit :
- Vous pouvez afficher des données sur les affichages et les conversions de page pour votre application ou votre complément à partir des graphiques Affichages et conversions de page d’application par ID de campagne et Nombre 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
Imaginez un développeur de jeu venant d’achever la création d’un jeu et désireux de promouvoir celui-ci auprès des joueurs de ses jeux existants. Elle publie l’annonce de la sortie du nouveau jeu sur sa page Facebook, y compris un lien vers la description du jeu dans le Store. Beaucoup de ses joueurs la suivent également sur Twitter, donc elle tweete également une annonce avec le lien vers la liste du jeu dans le Store.
Pour suivre le succès de chacun de ces canaux de promotion, le développeur crée deux variantes de l’URL de la description du Windows Store du jeu :
L’URL qu’elle publiera sur sa page Facebook inclut l’ID de campagne personnalisé
my-facebook-campaignL’URL qu’elle publiera sur Twitter inclut l’ID de campagne personnalisé
my-twitter-campaign
Lorsque ses abonnés Facebook et Twitter cliquent sur les URL, Microsoft suit chaque clic et l’associe à la campagne personnalisée correspondante. Les acquisitions éligibles du jeu et achats de modules complémentaires sont associés à la campagne personnalisée et déclarés comme autant de conversions.
Comprendre comment les acquisitions sont considérées comme des conversions
Une conversion de campagne personnalisée est une acquisition qui résulte d’un client qui clique sur une URL promue via une campagne personnalisée. Il existe différents scénarios de qualification en tant que conversion pour les graphiques Affichages et conversions de page d’application par ID de campagne et Nombre total de conversions de campagne dans le rapport Acquisitions , et pour la qualification en tant que conversion pour la récupération programmatique de l’ID de campagne.
Conversions éligibles dans le rapport Acquisitions
Les scénarios suivants sont qualifiés de conversion pour les affichages de page d’application et les conversions par ID de campagne et Nombre total de conversions de campagne dans le rapport Acquisitions :
Un client disposant ou non d’un compte Microsoft reconnu clique sur une URL d’application qui contient un ID de campagne personnalisé et est redirigé vers la description du Store pour l’application. Ensuite, ce même client acquiert l’application dans les 24 heures après avoir cliqué pour la première fois sur l’URL du Microsoft Store avec l’ID de campagne personnalisé.
Si le client acquiert l’application sur un appareil différent de celui sur lequel il a cliqué sur l’URL avec l’ID de campagne personnalisé, la conversion n’est comptabilisée que si le client est connecté avec le même compte Microsoft que lorsqu’il a cliqué sur l’URL.
Notes
Pour les acquisitions d’applications qui sont comptabilisées comme des conversions pour une campagne personnalisée, tous les achats de modules complémentaires dans cette application sont également comptabilisés comme des conversions pour la même campagne personnalisée.
Conversions de qualification lors de la récupération programmatique de l’ID de campagne
Pour être éligible en tant que conversion lors de la récupération par programme de l’ID de campagne associé à l’application, les conditions suivantes doivent être réunies :
Sur un appareil exécutant Windows 10, version 1607 ou ultérieure : un client (qu’il soit connecté ou non à un compte Microsoft reconnu) clique sur une URL qui contient un ID de campagne personnalisé et est redirigé vers la page de description du Store pour l’application. Le client acquiert l’application lors de l’affichage de la description du Store à la suite d’un clic 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 qui contient un ID de campagne personnalisé et est redirigé vers la page de description du Store pour l’application. Le client acquiert l’application lors de l’affichage de la description du Store à la suite d’un clic 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 puisse être considérée comme une conversion lors de la récupération programmatique de l’ID de campagne.
Notes
Si le client quitte la page d’affichage du Store, mais retourne à la page avec 24 heures (sur le même appareil ou sur un autre appareil lorsqu’il est connecté avec le même compte Microsoft) et acquiert l’application, cela sera considéré comme une conversion dans les graphiques affichages de la page application et conversions par ID de campagne etNombre total de conversions de campagne dans le rapport Acquisitions. Toutefois, cela ne sera pas considéré comme une conversion si vous récupérez par programmation l’ID de campagne.
Incorporer un ID de campagne personnalisé à l’URL de la page Microsoft Store de votre application
Pour créer une URL de page Microsoft Store pour votre application avec un ID de campagne personnalisé :
- Créez une chaîne d’ID pour la campagne personnalisée. Cette chaîne peut contenir jusqu’à 100 caractères, même s’il est recommandé de définir un ID de campagne court facilement identifiable.
Notes
La chaîne d’ID de campagne peut être visible par d’autres développeurs lorsqu’ils affichent le rapport Acquisitions pour leurs applications. Cela peut se produire lorsqu’un client clique sur votre ID de campagne personnalisé pour entrer dans le Store et achète l’application d’un autre développeur dans la même session, attribuant ainsi cette conversion à votre ID de campagne. Ce développeur verra le nombre de conversions de sa propre application résultant d’un clic initial sur votre ID de campagne, y compris le nom de l’ID de campagne, mais il ne verra pas de données sur le nombre d’utilisateurs ayant acheté vos propres applications (ou d’autres développeurs) après avoir cliqué sur votre ID de campagne.
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 liste du Windows Store basée sur le web de votre application dans un navigateur sur n’importe quel système d’exploitation. Sur les appareils Windows, l’application Du Store lance et affiche également la description de votre application. Cette URL est au format
https://www.microsoft.com/store/apps/*your app ID*. Par exemple, l’URL HTML pour Skype esthttps://www.microsoft.com/store/apps/9wzdncrfj364. Vous trouverez cette URL sur la page identité de votre application .Utilisez le format de protocole si vous faites la promotion de votre application à partir d’autres applications Windows qui s’exécutent sur un appareil ou un ordinateur sur lequel l’application UWP est installée, ou si vous savez que vos clients se trouvent sur un appareil qui prend en charge le Microsoft Store. Ce lien accède directement à la description de votre application dans le Windows Store sans ouvrir de navigateur. Cette URL est au format
ms-windows-store://pdp/?PRODUCTID=*your app id*. Par exemple, l’URL de protocole pour Skype estms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.
Ajouter 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, y compris l’ID de campagne, est :https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign.Pour une URL au 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, y compris l’ID de campagne, est :ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign.
Récupérer par programme l’ID de campagne personnalisée 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 possibles de nombreux scénarios d’analytique et de monétisation. 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. En guise d’alternative, si vous utilisez un fournisseur de commercialisation d’applications tiers, vous pouvez lui renvoyer des données.
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é, a consulté la page microsoft Store de votre application, puis acquiert votre application sans quitter la page d’annonce du Store. Si l’utilisateur quitte la page, puis retourne et acquiert l’application ultérieurement, cela ne sera pas considéré comme une conversion lors de l’utilisation de ces API.
Il existe différentes API à utiliser en fonction de la version de Windows cible par votre application :
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 lorsque l’utilisateur est connecté avec un compte Microsoft reconnu.
Notes
Bien que l’espace de noms Windows.ApplicationModel.Store soit disponible dans toutes les versions de Windows 10 ou Windows 11, nous vous recommandons d’utiliser les API dans l’espace de noms Windows.Services.Store si votre application cible Windows 10 version 1607 ou ultérieure. Pour plus d’informations sur les différences entre ces espaces de noms, consultez Achats et versions d’évaluation dans l’application. L’exemple de code suivant montre comment structurer votre code pour utiliser les deux API dans le même projet.
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 du système d’exploitation cible 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 les actions suivantes :
Tout d’abord, il vérifie si la classe StoreContext de 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 continue à utiliser cette classe.
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.
Le code tente ensuite de récupérer l’ID de campagne pour le cas où l’utilisateur actuel ne dispose pas d’un 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.
Si la classe StoreContext de l’espace de noms Windows.Services.Store n’est pas disponible, le code revient à 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 pour lesquelles l’utilisateur dispose d’un compte Microsoft reconnu.
Spécifier l’ID de campagne dans le fichier proxy pour 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 Store pour tester votre code avant de soumettre votre application au Windows Store. Cette classe récupère des données à partir 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-débogage 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 une classe que vous pouvez utiliser pour simuler des informations de licence lors d’un test. En revanche, 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 à des fins de test. Pour plus d’informations, consultez Versions d’évaluation et achats in-app.
Tester votre campagne personnalisée
Avant de promouvoir une URL de campagne personnalisée, nous vous recommandons de tester celle-ci en procédant comme suit :
Connectez-vous à un compte Microsoft sur l’appareil que vous utilisez pour le test.
Cliquez sur l’URL de votre campagne personnalisée. Vérifiez que vous êtes dirigé vers votre page d’application, puis fermez l’application UWP ou la page du navigateur.
Cliquez plusieurs fois sur l’URL, fermant l’application UWP ou la page du navigateur après chaque visite à la page de votre application. Lors de 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.
Vérifiez si les vues et conversions de page attendues s’affichent dans les graphiques Affichages et conversions de page d’application par ID de campagne et Nombre total de conversions de campagne dans le rapport Acquisitions, et testez le code de votre application pour vérifier si elle peut récupérer correctement l’ID de campagne à l’aide des API décrites ci-dessus.
Windows developer
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour