Delen via

Een aangepaste campagne voor app-promotie maken

  • Artikel

Naast het maken van een advertentiecampagne voor uw app die wordt uitgevoerd in Windows-apps, kunt u uw app ook promoveren met behulp van andere kanalen. U kunt uw app bijvoorbeeld promoveren met behulp van een externe app-marketingprovider of u kunt koppelingen naar uw app posten op sociale mediasites. Deze activiteiten worden aangepaste campagnesgenoemd.

Als u aangepaste campagnes uitvoert voor uw app, kunt u de relatieve prestaties van elke campagne bijhouden door een andere URL te maken voor elke aangepaste campagne, waarbij elke URL een andere campagne-idbevat. Wanneer een klant met Windows 10 op een URL klikt die een campagne-id bevat, koppelt Microsoft de klik aan de bijbehorende aangepaste campagne en maakt deze gegevens beschikbaar in Partnercentrum.

Belangrijk

Deze gegevens worden alleen bijgehouden voor klanten in Windows 10. Klanten die andere besturingssystemen gebruiken, kunnen nog steeds de koppeling naar de vermelding van uw app volgen, maar gegevens over de activiteiten van die klanten worden niet opgenomen.

Er zijn twee hoofdtypen gegevens die zijn gekoppeld aan aangepaste campagnes: paginaweergaven voor de Store-vermelding van uw app en conversies. Een conversie is een app-aankoop die het resultaat is van een klant die de store-vermeldingspagina van uw app bekijkt vanuit een URL die een aangepaste campagne-id bevat. Zie Begrijpen hoe app-acquisities in aanmerking komen als conversies in dit onderwerp voor meer informatie over conversies.

U kunt op de volgende manieren aangepaste campagneprestatiegegevens voor uw app ophalen:

  • U kunt gegevens over paginaweergaven en conversies voor uw app of invoegtoepassing bekijken vanuit de App-paginaweergaven en -conversies per campagne-id en Totaal aantal campagneconversies grafieken in het rapport Overnames.
  • Als uw app een UWP-app (Universal Windows Platform) is, kunt u API's in de Windows SDK gebruiken om programmatisch de aangepaste campagne-id op te halen die tot een conversie heeft geleid.

Voorbeeld van aangepast campagnescenario

Overweeg een gameontwikkelaar die klaar is met het bouwen van een nieuw spel en deze wil promoveren naar spelers van haar bestaande games. Ze plaatst de aankondiging van de nieuwe gamerelease op haar Facebook-pagina, inclusief een koppeling naar de Store-vermelding van de game. Veel van haar spelers volgen haar ook op Twitter, dus ze tweets ook een aankondiging met de koppeling naar de Store-vermelding van de game.

Om het succes van elk van deze promotiekanalen bij te houden, maakt de ontwikkelaar twee varianten van de URL naar de Store-vermelding van de game:

  • De URL die ze op haar Facebook-pagina plaatst, bevat de aangepaste campagne-id my-facebook-campaign

  • De URL die ze op Twitter plaatst, bevat de aangepaste campagne-id my-twitter-campaign

Terwijl haar Facebook- en Twitter-volgers op de URL's klikken, houdt Microsoft elke klik bij en koppelt ze deze aan de bijbehorende aangepaste campagne. Latere in aanmerking komende aankopen van het spel en eventuele uitbreidingen zijn gerelateerd aan de aangepaste campagne en worden gerapporteerd als conversies.

Begrijpen hoe overnames in aanmerking komen als conversies

Een aangepaste campagne conversie is een aankoop die het resultaat is van een klant die op een URL klikt die wordt gepromoveerd via een aangepaste campagne. Er zijn verschillende scenario's voor kwalificatie als conversie voor de App-paginaweergaven en -conversies per campagne-id en Totaal aantal campagneconversies grafieken in het rapport Overnames en om in aanmerking te komen als conversie voor programmatisch ophalen van de campagne-id.

In aanmerking komende conversies in het rapport Overnames

De volgende scenario's komen in aanmerking als conversie voor de App-paginaweergaven en -conversies per campagne-id en Totaal aantal campagneconversies grafieken in het rapport Overnames:

  • Een klant met of zonder een herkend Microsoft-account klikt op een app-URL die een aangepaste campagne-id bevat en wordt omgeleid naar de Store-vermelding voor de app. Vervolgens verkrijgt dezelfde klant de app binnen 24 uur nadat ze eerst op de URL van de Microsoft Store hebben geklikt met de aangepaste campagne-id.

  • Als de klant de app op een ander apparaat verkrijgt dan de app waarop de klant op de URL heeft geklikt met de aangepaste campagne-id, wordt de conversie alleen geteld als de klant is aangemeld met hetzelfde Microsoft-account als wanneer hij op de URL heeft geklikt.

Notitie

Voor app-acquisities die worden geteld als conversies voor een aangepaste campagne, worden eventuele invoegtoepassingsaankopen in die app ook geteld als conversies voor dezelfde aangepaste campagne.

Kwalificerende conversies bij het programmatisch ophalen van de campagne-ID

Om te kwalificeren als een conversie wanneer u via een programma de campagne-id die aan de app is gekoppeld wil ophalen, moet aan de volgende voorwaarden worden voldaan:

  • Op een apparaat met Windows 10, versie 1607 of hoger: een klant (of u nu bent aangemeld bij een herkend Microsoft-account of niet) klikt op een URL die een aangepaste campagne-id bevat en wordt omgeleid naar de store-vermeldingspagina voor de app. Door te klikken op de URL downloadt de klant de app bij het bekijken van de Store-pagina.

  • Op een apparaat met Windows 10, versie 1511 of eerder: Een klant (die moet zijn aangemeld met een herkend Microsoft-account) klikt op een URL die een aangepaste campagne-id bevat en wordt omgeleid naar de store-vermeldingspagina voor de app. De klant downloadt de app door de Store-vermelding te bekijken en op de URL te klikken. In deze versies van Windows 10 of Windows 11 moet de gebruiker zijn aangemeld met een herkend Microsoft-account om de verwerving als conversie te kunnen kwalificeren wanneer de campagne-id programmatisch wordt opgehaald.

Notitie

Als de klant de pagina met Store-vermelding verlaat, maar binnen 24 uur naar de pagina terugkeert (op hetzelfde apparaat of op een ander apparaat wanneer deze is aangemeld met hetzelfde Microsoft-account) en de app verkrijgt, zal dit als een conversie kwalificeren in de app-paginaweergaven en conversies per campagne-id en Totaal aantal campagneconversies grafieken in het Acquisities-rapport. Deze komt echter niet in aanmerking als een conversie als u de campagne-ID programmatisch ophaalt.

Een aangepaste campagne-id insluiten in de URL van de Microsoft Store-pagina van uw app

De URL van een Microsoft Store-pagina voor uw app maken met een aangepaste campagne-id:

  1. Maak een id-tekenreeks voor uw aangepaste campagne. Deze tekenreeks kan maximaal 100 tekens bevatten, hoewel u wordt aangeraden korte campagne-id's te definiëren die gemakkelijk kunnen worden geïdentificeerd.

Notitie

De campagne-ID-tekenreeks is mogelijk zichtbaar voor andere ontwikkelaars wanneer zij het rapport Acquisities van hun apps bekijken. Dit kan gebeuren wanneer een klant op uw aangepaste campagne-id klikt om de Store in te voeren en de app van een andere ontwikkelaar binnen dezelfde sessie koopt, waardoor deze conversie wordt toegerekend aan uw campagne-id. Die ontwikkelaar ziet hoeveel conversies van hun eigen app het gevolg zijn van een eerste klik op uw campagne-id, inclusief de naam van de campagne-id, maar ze zien geen gegevens over het aantal gebruikers dat uw eigen apps (of apps van andere ontwikkelaars) heeft gekocht nadat ze op uw campagne-id hebben geklikt.

  1. Haal de koppeling op voor de Store-vermelding van uw app in HTML- of protocolindeling.

    • Gebruik de HTML-URL als u wilt dat klanten naar de webgebaseerde Store-vermelding van uw app navigeren in een browser op elk besturingssysteem. Op Windows-apparaten wordt de Store-app ook gestart en wordt de vermelding van uw app weergegeven. Deze URL heeft de indeling https://apps.microsoft.com/detail/*your app ID*. De HTML-URL voor Skype is bijvoorbeeld https://apps.microsoft.com/detail/9wzdncrfj364. U vindt deze URL op uw app-identiteit pagina.

    • Gebruik de protocolindeling als u uw app promoveerde vanuit andere Windows-apps die worden uitgevoerd op een apparaat of computer waarop de UWP-app is geïnstalleerd, of wanneer u weet dat uw klanten zich op een apparaat bevinden dat ondersteuning biedt voor de Microsoft Store. Deze koppeling gaat rechtstreeks naar de Store-vermelding van uw app zonder een browser te openen. Deze URL heeft de indeling ms-windows-store://pdp/?PRODUCTID=*your app id*. De protocol-URL voor Skype is bijvoorbeeld ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.

  2. Voeg de volgende tekenreeks toe aan het einde van de URL voor uw app:

    • Voeg ?cid=*my custom campaign ID*toe voor een URL met HTML-indeling. Als Skype bijvoorbeeld een campagne-id introduceert met de waarde custom_campaign, is de nieuwe URL inclusief de campagne-id: https://apps.microsoft.com/detail/9wzdncrfj364?cid=custom_campaign.

    • Voeg &cid=*my custom campaign ID*toe voor een URL voor de protocolindeling. Als Skype bijvoorbeeld een campagne-id introduceert met de waarde custom_campaign, is de URL van het nieuwe protocol inclusief de campagne-id: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom_campaign.

Programmatisch de aangepaste campagne-id voor een app ophalen

Als uw app een UWP-app is, kunt u programmatisch de aangepaste campagne-id ophalen die is gekoppeld aan de verwerving van een app met behulp van API's in de Windows SDK. Deze API's maken veel analyse- en inkomstenscenario's mogelijk. U kunt bijvoorbeeld achterhalen of de huidige gebruiker uw app heeft verkregen nadat deze is gevonden via uw Facebook-campagne en vervolgens de app-ervaring dienovereenkomstig aanpassen. Als u een externe app-marketingprovider gebruikt, kunt u ook gegevens terugsturen naar de provider.

Deze API's retourneren alleen een campagne-id-tekenreeks als de klant op uw URL heeft geklikt met de id van de ingesloten campagne, de Microsoft Store-pagina voor uw app heeft bekeken en vervolgens uw app verkrijgt zonder de vermeldingspagina van de Store te verlaten. Als de gebruiker de pagina verlaat en vervolgens later terugkeert en de app aanschaft, zal dit niet als een conversie tellen wanneer deze API's worden gebruikt.

Er zijn verschillende API's die u kunt gebruiken, afhankelijk van de versie van Windows waarop uw app is gericht:

  • Windows 10, versie 1607 of hoger: gebruik de klasse StoreContext in de Windows.Services.Store naamruimte. Wanneer u deze API gebruikt, kunt u aangepaste campagne-id's ophalen voor alle gekwalificeerde overnames, ongeacht of de gebruiker is aangemeld met een herkend Microsoft-account.

  • Windows 10, versie 1511 of eerder: gebruik de klasse CurrentApp in de naamruimte Windows.ApplicationModel.Store. Wanneer u deze API gebruikt, kunt u alleen aangepaste campagne-id's ophalen voor gekwalificeerde overnames waarin de gebruiker is aangemeld met een herkend Microsoft-account.

Notitie

Hoewel de Windows.ApplicationModel.Store naamruimte beschikbaar is in alle versies van Windows 10 of Windows 11, raden we u aan de API's in de Windows.Services.Store naamruimte te gebruiken als uw app is gericht op Windows 10, versie 1607 of hoger. Zie In-app aankopen en proefversiesvoor meer informatie over de verschillen tussen deze naamruimten. In het volgende codevoorbeeld ziet u hoe u uw code structureert om beide API's in hetzelfde project te gebruiken.

Codevoorbeeld

In het volgende codevoorbeeld ziet u hoe u de aangepaste campagne-id ophaalt. In dit voorbeeld worden beide sets API's in de Windows.Services.Store- en Windows.ApplicationModel.Store-naamruimten gebruikt met behulp van adaptieve code voor versie. Door dit proces te volgen, kan uw code worden uitgevoerd op elke versie van Windows 10 of Windows 11. Als u deze code wilt gebruiken, moet de doelversie van het besturingssysteem van uw project zijn Windows 10 Jubileumeditie (10.0; Build 14394) of hoger, hoewel de minimale versie van het besturingssysteem een eerdere versie kan zijn.

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

Deze code doet het volgende:

  1. Eerst wordt gecontroleerd of de klasse StoreContext in de Windows.Services.Store naamruimte beschikbaar is op het huidige apparaat (dit betekent dat het apparaat Windows 10, versie 1607 of hoger gebruikt). Zo ja, dan gaat de code verder met het gebruik van deze klasse.

  2. Vervolgens wordt geprobeerd de aangepaste campagne-id op te halen voor het geval de huidige gebruiker een herkend Microsoft-account heeft. Hiervoor krijgt de code een StoreSku--object dat de huidige app-SKU vertegenwoordigt. Vervolgens krijgt de code toegang tot de eigenschap CampaignId om de campagne-id op te halen, indien beschikbaar.

  3. De code probeert vervolgens de campagne-id op te halen voor het geval de huidige gebruiker geen herkend Microsoft-account heeft. In dit geval wordt de campagne-id ingesloten in de app-licentie. De code haalt de licentie op met behulp van de methode GetAppLicenseAsync en parseert vervolgens de JSON-inhoud van de licentie voor de waarde van een sleutel met de naam customPolicyField1. Deze waarde bevat de campagne-id.

  4. Als de klasse StoreContext in de Windows.Services.Store naamruimte niet beschikbaar is, valt de code terug op het gebruik van de methode GetAppPurchaseCampaignIdAsync in de Windows.ApplicationModel.Store naamruimte om de aangepaste campagne-id op te halen (deze naamruimte is beschikbaar in alle versies van Windows 10 of Windows 11). Houd er rekening mee dat u bij het gebruik van deze methode alleen aangepaste campagne-id's kunt ophalen voor gekwalificeerde overnames waar de gebruiker een herkend Microsoft-account heeft.

Geef de campagne-id op in het proxybestand voor de Windows.ApplicationModel.Store naamruimte

De Windows.ApplicationModel.Store-naamruimte bevat CurrentAppSimulator, een speciale klasse waarmee Store-bewerkingen worden gesimuleerd voor het testen van uw code voordat u uw app naar de Store verzendt. Met deze klasse worden gegevens opgehaald uit een lokaal bestand met de naam Windows.StoreProxy.xml bestand. In het vorige codevoorbeeld ziet u hoe u zowel CurrentApp- als CurrentAppSimulator- kunt opnemen in foutopsporing en niet-foutopsporingscode in uw project. Als u deze code wilt testen in een foutopsporingsomgeving, voegt u een element AppPurchaseCampaignId toe aan het WindowsStoreProxy.xml-bestand op uw ontwikkelcomputer, zoals wordt weergegeven in het volgende voorbeeld. Wanneer u de app uitvoert, retourneert de GetAppPurchaseCampaignIdAsync methode altijd deze waarde.

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

De Windows.Services.Store naamruimte biedt geen klasse die u kunt gebruiken om licentiegegevens tijdens het testen te simuleren. In plaats daarvan moet u een app publiceren naar de Store en die app downloaden naar uw ontwikkelapparaat om de licentie voor testen te gebruiken. Zie in-app aankopen en proefversiesvoor meer informatie.

Uw aangepaste campagne testen

Voordat u een aangepaste campagne-URL promoveren, raden we u aan om uw aangepaste campagne als volgt te testen:

  1. Meld u aan bij een Microsoft-account op het apparaat dat u gebruikt om te testen.

  2. Klik op de URL van uw aangepaste campagne. Zorg ervoor dat u naar uw app-pagina gaat en sluit vervolgens de UWP-app of de browserpagina.

  3. Klik nog meerdere keren op de URL, sluit de UWP-app of de browserpagina na elk bezoek aan de pagina van uw app. Tijdens één van de bezoeken aan de pagina van uw app, stimuleert u het downloaden van uw app om een conversie te genereren. Tel het totale aantal keren dat u op de URL hebt geklikt.

  4. Controleer of de verwachte paginaweergaven en -conversies worden weergegeven in de app-paginaweergaven en conversies per campagne-id en Totaal aantal campagneconversies grafieken in het rapport Overnamesen test de code van uw app om te controleren of de campagne-id kan worden opgehaald met behulp van de hierboven beschreven API's.