Aracılığıyla paylaş

Microsoft Store Hizmetleri SDK'sı ile müşterilerle etkileşim kurma

Microsoft Store Hizmetleri SDK'sı, Evrensel Windows Platformu (UWP) uygulamalarınızda müşterilerle etkileşim kurmanıza yardımcı olan, uygulamalarınıza hedefli bildirimler gönderme ve uygulamalarınızda A/B denemeleri çalıştırma gibi özellikler sağlar. Bu SDK, Visual Studio 2015 ve Visual Studio'nun sonraki sürümleri için bir uzantıdır.

Uyarı

UWP uygulamalarınızda reklam görüntülemek için Microsoft Store Hizmetleri SDK'sı yerine Microsoft Reklam SDK'sını kullanın. Reklam kitaplıkları Microsoft Store Hizmetleri SDK'sından Microsoft Advertising SDK'sına taşındı. Daha fazla bilgi için bkz. uygulamanızda reklam görüntüleme.

Microsoft Store Hizmetleri SDK'sı tarafından desteklenen senaryolar

Microsoft Store Hizmetleri SDK'sı şu anda UWP uygulamaları için aşağıdaki senaryoları desteklemektedir. API referans belgeleri için bakınız Microsoft Store Services SDK API referans.

Senaryo Açıklama
A/B testi ile UWP uygulamanızda deneme çalıştırma Evrensel Windows Platformu (UWP) uygulamanızda A/B testleri çalıştırarak özellikleri herkese sunmadan önce bazı müşteriler üzerindeki özelliklerin verimliliğini ölçün. İş Ortağı Merkezi'nde bir deneme tanımladıktan sonra uygulamanızda denemenizin çeşitlemelerini almak için StoreServicesExperimentVariation sınıfını kullanın, test ettiğiniz özelliğin davranışını değiştirmek için bu verileri kullanın ve ardından LogForVariation yöntemini kullanarak olay ve dönüştürme olaylarını İş Ortağı Merkezi'ne gönderin. Son olarak, sonuçları görüntülemek ve denemeyi yönetmek için İş Ortağı Merkezi'ni kullanın.
UWP uygulamanızdan Geri Bildirim Merkezi'ni başlatın Windows 10 ve Windows 11 müşterilerinizi sorun, öneri ve destek oyu gönderebilecekleri Geri Bildirim Merkezi'ne yönlendirmek için UWP uygulamanızdaki StoreServicesFeedbackLauncher sınıfını kullanın. Ardından bu geri bildirimi İş Ortağı Merkezi'ndeki Geri Bildirim raporunda yönetin.
UWP uygulamanızı İş Ortağı Merkezi bildirimlerini alacak şekilde yapılandırma İş Ortağı Merkezi'ni kullanarak müşterilerinize gönderdiğiniz hedefli anında iletme bildirimlerini almak üzere uygulamanızı kaydetmek için UWP uygulamanızda StoreServicesEngagementManager sınıfını kullanın.
İş Ortağı Merkezi'nde Kullanım raporu için UWP uygulamanızda özel olaylar kaydedin İş Ortağı Merkezi'nde uygulamanızla ilişkili özel olayları günlüğe kaydetmek için UWP uygulamanızda StoreServicesCustomEventLogger sınıfını kullanın. Ardından, İş Ortağı Merkezi'ndeki Kullanım raporununÖzel etkinlikler bölümünde özel etkinliklerinizin toplam gerçekleşmelerini gözden geçirin.

Önkoşullar

Microsoft Store Hizmetleri SDK'sı şunları gerektirir:

  • Visual Studio 2015 veya sonraki bir sürüm.
  • Evrensel Windows Uygulamaları için Visual Studio Araçları, Visual Studio sürümünüzle birlikte yüklenir.

SDK’yı yükleyin

Geliştirme bilgisayarınıza Microsoft Store Hizmetleri SDK'sını yüklemek için iki seçenek vardır:

  • MSI yükleyicisi SDK'yiburada bulunan MSI yükleyicisi yükleyebilirsiniz.
  • NuGet paketi SDK'yi NuGet paketi olarak yükleyebilirsiniz.

Microsoft, performans iyileştirmeleri ve yeni özelliklerle düzenli aralıklarla Microsoft Store Hizmetleri SDK'sının yeni sürümlerini yayınlar. SDK'yı kullanan mevcut projeleriniz varsa ve en son sürümü kullanmak istiyorsanız geliştirme bilgisayarınıza SDK'nın en son sürümünü indirin ve yükleyin.

MSI aracılığıyla yükleme

MSI yükleyicisi aracılığıyla Microsoft Store Hizmetleri SDK'sını yüklemek için:

  1. Visual Studio'nun tüm örneklerini kapatın.

  2. Daha önce Microsoft Store Katılım ve Para Kazanma SDK'sı, Evrensel Ad İstemci SDK'sı veya Ad Mediator uzantısını yüklediyseniz, bu SDK'ları şimdi kaldırın. İsteğe bağlı olarak, Bir Komut İstemi penceresi açın ve Visual Studio ile yüklenmiş olabilecek ancak bilgisayarınızdaki yüklü programlar listesinde görünmeyebilir eski SDK sürümlerini temizlemek için şu komutları çalıştırın:

    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. Microsoft Store Hizmetleri SDK'sını indirin ve yükleyin. Yüklenmesi birkaç dakika sürebilir. İşlemin bitmesini bekleyin.

  4. Visual Studio'yu yeniden başlatın.

  5. Microsoft Store Hizmetleri SDK'sının, Microsoft Advertising SDK'sının, Evrensel Reklam İstemci SDK'sının veya Microsoft Store Katılım ve Para Kazanma SDK'sının önceki sürümlerinden kitaplıklara başvuran mevcut bir projeniz varsa, projenizi Visual Studio'da açmanızı ve projenizi temizleyip yeniden oluşturmanızı öneririz ( Çözüm Gezgini'nde proje düğümünüzü sağ tıklatın ve Temizle'yi seçin, ve ardından proje düğümünüzü yeniden sağ tıklatın ve Yeniden Oluştur'u seçin).

Aksi takdirde, projenizde SDK'yı ilk kez kullanıyorsanız, artıkprojenize derleme başvurusu eklemeye hazır olursunuz.

NuGet aracılığıyla yükleme

NuGet aracılığıyla Microsoft Store Hizmetleri SDK kitaplıklarını yüklemek için:

  1. Visual Studio'nun tüm örneklerini kapatın.

  2. Daha önce Microsoft Store Katılım ve Para Kazanma SDK'sı, Evrensel Ad İstemci SDK'sı veya Ad Mediator uzantısını yüklediyseniz, bu SDK'ları şimdi kaldırın. İsteğe bağlı olarak, Bir Komut İstemi penceresi açın ve Visual Studio ile yüklenmiş olabilecek ancak bilgisayarınızdaki yüklü programlar listesinde görünmeyebilir eski SDK sürümlerini temizlemek için şu komutları çalıştırın:

    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. Visual Studio'yu başlatın ve Microsoft Store Services SDK'sını kullanmak istediğiniz projeyi açın.

    Uyarı

    Projeniz sdk'nın önceki bir MSI yüklemesinden kitaplık başvuruları içeriyorsa, bu başvuruları projenizden kaldırın. Bu referansların yanında, referans verdikleri kitaplıklar önceki adımlarda kaldırıldığı için uyarı simgeleri bulunur.

  4. Visual Studio'da, Proje’e ve NuGet Paketlerini Yönet'e tıklayın.

  5. Arama kutusuna Microsoft.Services.Store.Engagement yazın ve Microsoft.Services.Store.Engagement paketini yükleyin. Paketin yüklenmesi bittiğinde çözümünüzü kaydedin.

    Uyarı

    Çıktı penceresi, belirtilen yolun çok uzun olduğunu belirten Bir Yükleme Paketi hatası bildirirse, NuGet'i paketleri varsayılan konumdan daha kısa bir yola sahip alternatif bir konuma ayıklamak için yapılandırmanız gerekebilir. Bunu yapmak için, repositoryPath değerini bilgisayarınızdaki bir nuget.config dosyasına ekleyin ve NuGet paketlerinin ayıklandığı kısa bir klasör yoluna atayın. Daha fazla bilgi için bu makaleye NuGet belgelerinde bakın. Alternatif olarak, Visual Studio projenizi daha kısa bir yolu olan alternatif bir klasöre taşımayı da deneyebilirsiniz. Sorunun nedeni genel paketler yolunuzun çok uzun olması da olabilir. Bu durumda, globalPackagesFolder değerini nuget.config dosyanıza ekleyin.

  6. Projenizi içeren Visual Studio çözümünü kapatın ve ardından çözümü yeniden açın.

  7. Projeniz zaten NuGet aracılığıyla yüklenen Microsoft Store Hizmetleri SDK'sının önceki bir sürümünden kitaplıklara başvuruyorsa ve projenizi SDK'nın daha yeni bir sürümüne güncelleştirdiyseniz, projenizi temizlemenizi ve yeniden oluşturmanızı öneririz ( Çözüm Gezgini'nde proje düğümünüzü sağ tıklatın ve Temizle'yi seçin ve sonra proje düğümünüzü yeniden sağ tıklatın ve Yeniden Oluştur'u seçin).

Aksi takdirde, projenizde SDK'yı ilk kez kullanıyorsanız, artıkprojenize derleme başvurusu eklemeye hazır olursunuz.

Projenize bütünleştirme başvurusu ekleyin

MSI yükleyicisi veya NuGet aracılığıyla Microsoft Store Hizmetleri SDK'sını yükledikten sonra UWP projenizdeki SDK derlemesine başvurmak için bu yönergeleri izleyin.

  1. Projenizi Visual Studio'da açın.

    Uyarı

    Projeniz Herhangi bir CPU'yı hedefleyen bir JavaScript uygulamasıysa, mimariye özgü bir derleme çıktısı (örneğin , x86) kullanmak için projenizi güncelleştirin.

  2. Çözüm Gezginiiçerisinde, Başvurular üzerinde sağ tıklayın ve Başvuru Ekle... seçin

  3. Başvuru Yöneticisi,Evrensel Windowsgenişletin,Uzantılar'a tıklayın ve microsoft engagement frameworkyanındaki onay kutusunu seçin. Bu, Microsoft.Services.Store.Engagement ad alanında API'leri kullanmanızı sağlar.

  4. Tamam'a tıklayın.

Uyarı

SDK kitaplıklarını NuGet aracılığıyla yüklediyseniz, projeniz bir Microsoft.Services.Store.Engagement başvurusu içerir. Microsoft.Services.Store.Engagement başvurusu NuGet paketini (içindeki kitaplıklar yerine) temsil eder ve bunu yoksayabilirsiniz.

SDK'daki çerçeve paketlerini anlama

Microsoft Store Hizmetleri SDK'sındaki Microsoft.Services.Store.Engagement.dll kitaplığı,olarak yapılandırılan bir çerçeve paketidir. Bu kitaplık , Microsoft.Services.Store.Engagement ad alanında API'leri içerir.

Bu kitaplık bir çerçeve paketi olduğundan, bir kullanıcı uygulamanızın bu kitaplığı kullanan bir sürümünü yükledikten sonra, kitaplığın yeni bir sürümünü düzeltmeler ve performans iyileştirmeleri ile yayımladığımız her durumda bu kitaplığın Windows Update aracılığıyla cihazında otomatik olarak güncelleştirildiği anlamına gelir. Bu, müşterilerinizin her zaman cihazlarında kitaplığın en son kullanılabilir sürümünün yüklü olduğundan emin olmanıza yardımcı olur.

BU kitaplıkta yeni API'ler veya özellikler sunan yeni bir SDK sürümü yayınlarsak, bu özellikleri kullanmak için SDK'nın en son sürümünü yüklemeniz gerekir. Bu senaryoda, güncelleştirilmiş uygulamanızı Mağaza'da yayımlamanız da gerekir.