Delen via

Klanten betrekken met de Microsoft Store Services SDK

De Microsoft Store Services SDK biedt functies waarmee u contact kunt opnemen met klanten in uw UWP-apps (Universal Windows Platform), zoals het verzenden van gerichte meldingen naar uw apps en het uitvoeren van A/B-experimenten in uw apps. Deze SDK is een extensie voor Visual Studio 2015 en latere versies van Visual Studio.

Opmerking

Als u advertenties wilt weergeven in uw UWP-apps, gebruikt u de Microsoft Advertising SDK in plaats van de Microsoft Store Services SDK. De advertentiebibliotheken zijn verplaatst van de Microsoft Store Services SDK naar de Microsoft Advertising SDK. Zie Display-advertenties in uw app voor meer informatie.

Scenario's die worden ondersteund door de Microsoft Store Services SDK

De Microsoft Store Services SDK ondersteunt momenteel de volgende scenario's voor UWP-apps. Raadpleeg de API-referentie van SDK voor Microsoft Store Services voor documentatie.

Scenariobeschrijving Beschrijving
Aangepaste gebeurtenissen registreren in uw UWP-app voor het gebruiksrapport in Partnercentrum Gebruik de klasse StoreServicesCustomEventLogger in uw UWP-app om aangepaste gebeurtenissen te registreren die zijn gekoppeld aan uw app in Partnercentrum. Controleer vervolgens het totale aantal voorkomen voor uw aangepaste gebeurtenissen in de sectie Aangepaste gebeurtenissen van het gebruiksoverzicht in Partner Center.

Vereiste voorwaarden

Voor de Microsoft Store Services SDK is het volgende vereist:

  • Visual Studio 2015 of een nieuwere versie.
  • Visual Studio Tools for Universal Windows Apps geïnstalleerd met uw versie van Visual Studio.

De SDK installeren

Er zijn twee opties voor het installeren van de Microsoft Store Services SDK op uw ontwikkelcomputer:

  • MSI-installatieprogramma U kunt de SDK installeren via het MSI-installatieprogramma dat hier beschikbaar is.
  • NuGet-pakket U kunt de SDK installeren als een NuGet-pakket.

Microsoft brengt regelmatig nieuwe versies van de Microsoft Store Services SDK uit met prestatieverbeteringen en nieuwe functies. Als u bestaande projecten hebt die gebruikmaken van de SDK en u de nieuwste versie wilt gebruiken, downloadt en installeert u de nieuwste versie van de SDK op uw ontwikkelcomputer.

Installeren via MSI

De Microsoft Store Services SDK installeren via het MSI-installatieprogramma:

  1. Sluit alle exemplaren van Visual Studio.

  2. Als u eerder de Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK of Ad Mediator-extensie hebt geïnstalleerd, moet u deze SDK's nu verwijderen. U kunt desgewenst een opdrachtpromptvenster openen en deze opdrachten uitvoeren om oudere SDK-versies op te schonen die mogelijk zijn geïnstalleerd met Visual Studio, maar die mogelijk niet worden weergegeven in de lijst met geïnstalleerde programma's op uw computer:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Download en installeer de Microsoft Store Services SDK. Het kan enkele minuten duren voordat deze is geïnstalleerd. Zorg ervoor dat u wacht totdat het proces is voltooid.

  4. Start Visual Studio opnieuw.

  5. Als u een bestaand project hebt dat verwijst naar bibliotheken uit een eerdere versie van de Microsoft Store Services SDK, Microsoft Advertising SDK, Universal Ad Client SDK of Microsoft Store Engagement and Monetization SDK, raden we u aan uw project te openen in Visual Studio en uw project op te schonen en opnieuw te bouwen (klik in Solution Explorer met de rechtermuisknop op uw projectknooppunt en kies Schoon, en klik vervolgens opnieuw met de rechtermuisknop op het projectknooppunt en kies Opnieuw opbouwen).

Als u de SDK voor het eerst in uw project gebruikt, kunt u nu de assemblyreferentie toevoegen aan uw project.

Installeren via NuGet

De Microsoft Store Services SDK-bibliotheken installeren via NuGet:

  1. Sluit alle exemplaren van Visual Studio.

  2. Als u eerder de Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK of Ad Mediator-extensie hebt geïnstalleerd, moet u deze SDK's nu verwijderen. U kunt desgewenst een opdrachtpromptvenster openen en deze opdrachten uitvoeren om oudere SDK-versies op te schonen die mogelijk zijn geïnstalleerd met Visual Studio, maar die mogelijk niet worden weergegeven in de lijst met geïnstalleerde programma's op uw computer:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Start Visual Studio en open het project waarin u de Microsoft Store Services SDK wilt gebruiken.

    Opmerking

    Als uw project al bibliotheekverwijzingen bevat van een eerdere MSI-installatie van de SDK, verwijdert u deze verwijzingen uit uw project. Deze verwijzingen bevatten waarschuwingspictogrammen naast deze verwijzingen, omdat de bibliotheken waarnaar ze verwijzen in de vorige stappen zijn verwijderd.

  4. Klik in Visual Studio op Project en NuGet-pakketten beheren.

  5. Typ Microsoft.Services.Store.Engagement in het zoekvak en installeer het pakket Microsoft.Services.Store.Engagement. Sla uw oplossing op wanneer het pakket is geïnstalleerd.

    Opmerking

    Als in het uitvoervenster een installatiepakketfout wordt gerapporteerd die aangeeft dat het opgegeven pad te lang is, moet u NuGet mogelijk configureren om pakketten te extraheren naar een alternatieve locatie met een korter pad dan de standaardlocatie. Hiervoor voegt u de repositoryPath waarde toe aan een nuget.config-bestand op uw computer en wijst u deze toe aan een kort mappad waar NuGet-pakketten kunnen worden geëxtraheerd. Zie dit artikel in de NuGet-documentatie voor meer informatie. U kunt ook proberen om uw Visual Studio-project te verplaatsen naar een alternatieve map met een korter pad. Het probleem kan ook worden veroorzaakt doordat het pad voor globale pakketten te lang is. In dit geval voegt u de globalPackagesFolder waarde toe aan het nuget.config-bestand.

  6. Sluit de Visual Studio-oplossing die uw project bevat en open vervolgens de oplossing opnieuw.

  7. Als uw project al verwijst naar bibliotheken uit een eerdere versie van de Microsoft Store Services SDK die is geïnstalleerd via NuGet en u uw project hebt bijgewerkt naar een nieuwere versie van de SDK, raden we u aan uw project op te schonen en opnieuw te bouwen (klik in Solution Explorer met de rechtermuisknop op het projectknooppunt en kies Opschonen en klik vervolgens opnieuw op het projectknooppunt en kies Opnieuw opbouwen).

Als u de SDK voor het eerst in uw project gebruikt, kunt u nu de assemblyreferentie toevoegen aan uw project.

De assembly-verwijzing toevoegen aan uw project

Nadat u de Microsoft Store Services SDK hebt geïnstalleerd via het MSI-installatieprogramma of NuGet, volgt u deze instructies om te verwijzen naar de SDK-assembly in uw UWP-project.

  1. Open uw project in Visual Studio.

    Opmerking

    Als uw project een JavaScript-app is die gericht is op elke CPU, werkt u uw project bij om een architectuurspecifieke build-uitvoer te gebruiken (bijvoorbeeld x86).

  2. Klik in Solution Explorer met de rechtermuisknop op Verwijzingen en selecteer Verwijzing toevoegen...

  3. Vouw in Reference ManagerUniversal Windows uit, klik op Extensies en schakel het selectievakje naast Microsoft Engagement Framework in. Hiermee kunt u de API's gebruiken in de naamruimte Microsoft.Services.Store.Engagement .

  4. Klik op OK.

Opmerking

Als u de SDK-bibliotheken hebt geïnstalleerd via NuGet, bevat uw project een naslaginformatie over Microsoft.Services.Store.Engagement . De naslaginformatie Microsoft.Services.Store.Engagement vertegenwoordigt het NuGet-pakket (in plaats van de bibliotheken erin) en u kunt dit negeren.

Frameworkpakketten in de SDK begrijpen

De Microsoft.Services.Store.Engagement.dll-bibliotheek in de Microsoft Store Services SDK is geconfigureerd als een frameworkpakket. Deze bibliotheek bevat de API's in de naamruimte Microsoft.Services.Store.Engagement .

Omdat deze bibliotheek een frameworkpakket is, betekent dit dat nadat een gebruiker een versie van uw app heeft geïnstalleerd die gebruikmaakt van deze bibliotheek, deze bibliotheek automatisch wordt bijgewerkt op het apparaat via Windows Update wanneer we een nieuwe versie van de bibliotheek publiceren met oplossingen en prestatieverbeteringen. Dit helpt ervoor te zorgen dat uw klanten altijd beschikken over de nieuwste beschikbare versie van de bibliotheek die op hun apparaten is geïnstalleerd.

Als we een nieuwe versie van de SDK vrijgeven waarin nieuwe API's of functies in deze bibliotheek worden geïntroduceerd, moet u de nieuwste versie van de SDK installeren om deze functies te kunnen gebruiken. In dit scenario moet u ook uw bijgewerkte app publiceren naar de Store.

  • Last updated on