Vytvoření vlastní kampaně propagace aplikace

Článek
01/15/2025

Kromě vytváření reklamní kampaně pro vaši aplikaci, která se bude spouštět v aplikacích pro Windows, můžete aplikaci propagovat také pomocí jiných kanálů. Aplikaci můžete například propagovat pomocí jiného poskytovatele marketingu nebo můžete publikovat odkazy na aplikaci na webech sociálních médií. Tyto aktivity se nazývají vlastní kampaně.

Pokud pro svou aplikaci spouštíte vlastní kampaně, můžete sledovat relativní výkon každé kampaně vytvořením jiné adresy URL pro každou vlastní kampaň, kde každá adresa URL obsahuje jiné ID kampaně. Když zákazník s Windows 10 klikne na adresu URL, která obsahuje ID kampaně, Microsoft přidruží kliknutí k odpovídající vlastní kampani a zpřístupní vám tato data v partnerském centru .

Důležitý

Tato data se sledují jenom pro zákazníky ve Windows 10. Zákazníci, kteří používají jiné operační systémy, můžou dál sledovat odkaz na výpis vaší aplikace, ale data o aktivitách těchto zákazníků nebudou zahrnuta.

K vlastním kampaním jsou přidruženy dva hlavní typy dat: zobrazení stránek pro výpis z Obchodu vaší aplikace a převody. Převod je získání aplikace, které je výsledkem toho, že zákazník zhlédne stránku záznamu vaší aplikace v obchodě z adresy URL, která obsahuje vlastní ID kampaně. Další podrobnosti o převodech najdete v tématu Vysvětlení toho, jak se získání aplikací v tomto tématu kvalifikuje jako převody.

Data o výkonu vlastních kampaní pro vaši aplikaci můžete načíst následujícími způsoby:

Data o zobrazeních stránky a konverzích pro vaši aplikaci nebo doplněk můžete zobrazit z grafů Zobrazení stránek aplikace podle ID kampaně a Celkové konverze kampaní v sestavě Akvizice .
Pokud je vaše aplikace na platformě Universal Windows Platform (UWP), můžete pomocí API v sadě Windows SDK programově získat ID vlastní kampaně, které vedlo k konverzi.

Ukázkový scénář vlastní kampaně

Představte si vývojáře her, který dokončil tvorbu nové hry a chtěl by ji propagovat na hráče svých stávajících her. Publikuje oznámení o vydání nové hry na své Facebookové stránce, včetně odkazu na seznam hry v obchodě. Mnoho jejích hráčů ji také sleduje na Twitteru, takže také tweetuje oznámení s odkazem na stránku hry v obchodě.

Aby vývojář sledoval úspěch každého z těchto propagačních kanálů, vytvoří dvě varianty adresy URL výpisu z obchodu hry:

Adresa URL, která publikuje na své facebookové stránce, obsahuje ID vlastní kampaně my-facebook-campaign
Adresa URL, která publikuje na Twitter, obsahuje ID vlastní kampaně my-twitter-campaign

Když její sledující na Facebooku a Twitteru kliknou na adresy URL, Microsoft sleduje každé kliknutí a přidruží ho k odpovídající přizpůsobené kampani. Následné kvalifikující nákupy hry a všechny doplňkové nákupy jsou přidružené k vlastní kampani a oznamují se jako převody.

Vysvětlení toho, jak se akvizice kvalifikují jako převody

Vlastní konverze je získána, když zákazník klikne na URL adresu propagovanou prostřednictvím vlastní kampaně. Existují různé scénáře pro kvalifikaci jako konverze pro zobrazení stránek a konverze aplikace podle ID kampaně a grafy celkových konverzí kampaně v sestavě Acquisitions a pro kvalifikaci jako konverze při programovém získávání ID kampaně .

Kvalifikované konverze v sestavě akvizic

Následující scénáře se označují jako konverze pro zobrazení stránek a převody aplikace podle ID kampaně a grafy celkových převodů kampaní v sestavě Přehled Akvizic:

Zákazník s účtem Microsoft, ať už rozpoznaným, nebo bez něj klikne na adresu URL aplikace, která obsahuje vlastní ID kampaně a je přesměrován na výpis ze Storu pro danou aplikaci. Stejný zákazník pak aplikaci získá do 24 hodin od prvního kliknutí na adresu URL Microsoft Storu s ID vlastní kampaně.
Pokud zákazník získá aplikaci na jiném zařízení než na zařízení, na kterém klikl na adresu URL s ID vlastní kampaně, bude převod počítán pouze v případě, že je zákazník přihlášený pomocí stejného účtu Microsoft jako při kliknutí na adresu URL.

Poznámka

U nákupů aplikací, které se počítají jako převody pro vlastní kampaň, se všechny nákupy doplňků v této aplikaci také počítají jako převody pro stejnou vlastní kampaň.

Kvalifikované konverze při programatickém získávání ID kampaně

Pokud chcete získat nárok na převod při programovém načítání ID kampaně přidružené k aplikaci, musí být splněny následující podmínky:

Na zařízení se systémem Windows 10 verze 1607 nebo novějším: Zákazník (bez ohledu na to, jestli se přihlásil k rozpoznanému účtu Microsoft, nebo ne) klikne na adresu URL, která obsahuje vlastní ID kampaně, a přesměruje se na stránku obchodu aplikace. Zákazník získá aplikaci při prohlížení výpisu ze Storu v důsledku kliknutí na adresu URL.
Na zařízení se systémem Windows 10 verze 1511 nebo starším: Zákazník (který se musí přihlásit pomocí rozpoznaného účtu Microsoft) klikne na adresu URL, která obsahuje vlastní ID kampaně, a přesměruje se na stránku výpisu ze Storu pro aplikaci. Zákazník získá aplikaci při prohlížení výpisu ze Storu v důsledku kliknutí na adresu URL. V těchto verzích Windows 10 nebo Windows 11 musí být uživatel přihlášený pomocí ověřeného účtu Microsoft, aby se při programatickém načítání ID kampaně kvalifikovalo získání jako převod.

Poznámka

Pokud zákazník odejde ze stránky výpisu z Obchodu, ale vrátí se na stránku do 24 hodin (buď na stejném zařízení, nebo na jiném zařízení po přihlášení pomocí stejného účtu Microsoft) a získá aplikaci, tato se kvalifikuje jako konverze v zobrazeních stránek aplikace a převodech podle ID kampaně a celkové konverze kampaně grafy v sestavě 'Získávání'. Tento však nebude kvalifikován jako převod, pokud programově načítáte ID kampaně.

Vložení ID vlastní kampaně na adresu URL stránky Microsoft Storu vaší aplikace

Vytvoření adresy URL stránky Microsoft Storu pro vaši aplikaci s vlastním ID kampaně:

Vytvořte řetězec ID pro vlastní kampaň. Tento řetězec může obsahovat až 100 znaků, i když doporučujeme definovat ID krátkých kampaní, které jsou snadno identifikovatelné.

Poznámka

Řetězec ID kampaně může být viditelný ostatním vývojářům, když zobrazí sestavu Acquisitions pro své aplikace. K tomu může dojít, když zákazník klikne na ID vaší kampaně, aby vstoupil do obchodu a v rámci stejné relace zakoupí aplikaci jiného vývojáře, čímž přiřadí tuto konverzi k vašemu ID kampaně. Vývojář uvidí, kolik převodů vlastní aplikace vzniklo počátečním kliknutím na ID kampaně, včetně názvu ID kampaně, ale po kliknutí na ID kampaně neuvidí žádná data o tom, kolik uživatelů zakoupilo vaše vlastní aplikace (nebo aplikace od jiných vývojářů).

Odkaz na výpis z Obchodu vaší aplikace získáte ve formátu HTML nebo protokolu.
- Adresu URL HTML použijte, pokud chcete, aby zákazníci přešli do webového výpisu z obchodu vaší aplikace v prohlížeči v libovolném operačním systému. Na zařízeních s Windows se také spustí aplikace Store a zobrazí stránku vaší aplikace. Tato adresa URL má formát https://apps.microsoft.com/detail/*your app ID*. Například adresa URL HTML pro Skype je https://apps.microsoft.com/detail/9wzdncrfj364. Tuto adresu URL najdete na stránce identity aplikace .
- Formát protokolu použijte, pokud propagujete aplikaci z jiných aplikací pro Windows, které běží na zařízení nebo počítači s nainstalovanou aplikací pro UPW, nebo když víte, že vaši zákazníci jsou na zařízení, které podporuje Microsoft Store. Tento odkaz přejde přímo do výpisu z Obchodu vaší aplikace bez otevření prohlížeče. Tato adresa URL má formát ms-windows-store://pdp/?PRODUCTID=*your app id*. Například adresa URL protokolu pro Skype je ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.
Na konec adresy URL aplikace připojte následující řetězec:
- Pro adresu URL formátu HTML připojte ?cid=*my custom campaign ID*. Pokud například Skype zavádí ID kampaně s hodnotou custom_campaign, bude nová adresa URL včetně ID kampaně: https://apps.microsoft.com/detail/9wzdncrfj364?cid=custom_campaign.
- Pro adresu URL formátu protokolu připojte &cid=*my custom campaign ID*. Pokud například Skype zavádí ID kampaně s hodnotou custom_campaign, bude nová adresa URL protokolu včetně ID kampaně: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom_campaign.

Programmaticky načíst ID vlastní kampaně pro aplikaci

Pokud je vaše aplikace aplikací UWP, můžete programově načíst ID vlastní kampaně spojované se získáním aplikace použitím rozhraní API v sadě Windows SDK. Tato rozhraní API umožňují mnoho scénářů analýzy a monetizace. Můžete například zjistit, jestli aktuální uživatel aplikaci získal po jejím zjištění prostřednictvím vaší facebookové kampaně, a odpovídajícím způsobem přizpůsobit prostředí aplikace. Pokud používáte jiného poskytovatele marketingu aplikací, můžete data odeslat zpět poskytovateli.

Tato rozhraní API vrátí řetězec ID kampaně jenom v případě, že zákazník klikl na vaši adresu URL s vloženým ID kampaně, zobrazil stránku Microsoft Storu pro vaši aplikaci a pak aplikaci získá bez opuštění stránky výpisu ze Storu. Pokud uživatel stránku opustí a později aplikaci vrátí a získá, nebude při použití těchto rozhraní API kvalifikovat jako převodní.

Existují různá rozhraní API, která můžete použít v závislosti na verzi Windows, kterou vaše aplikace cílí:

Windows 10 verze 1607 nebo novější: Použijte třídu StoreContext v oboru názvů Windows.Services.Store. Při použití tohoto rozhraní API můžete načíst ID vlastních kampaní pro všechny kvalifikované akvizice, ať už je uživatel přihlášen pomocí rozpoznaného účtu Microsoft.
Windows 10 verze 1511 nebo starší: Použijte třídu CurrentApp v oboru názvů Windows.ApplicationModel.Store. Při použití tohoto rozhraní API můžete načíst pouze ID vlastních kampaní pro kvalifikované akvizice, kde je uživatel přihlášen pomocí rozpoznaného účtu Microsoft.

Poznámka

Přestože je obor názvů Windows.ApplicationModel.Store dostupný ve všech verzích Windows 10 nebo Windows 11, doporučujeme používat rozhraní API v oboru názvů Windows.Services.Store, pokud vaše aplikace cílí na Windows 10, verzi 1607 nebo novější. Další informace o rozdílech mezi těmito jmennými prostory najdete v části Nákupy v aplikaci a zkušební verze. Následující příklad kódu ukazuje, jak strukturovat kód tak, aby používal obě rozhraní API ve stejném projektu.

Příklad kódu

Následující příklad kódu ukazuje, jak načíst ID vlastní kampaně. Tento příklad používá obě sady rozhraní API v Windows.Services.Store a Windows.ApplicationModel.Store oborů názvů pomocí adaptivního kódu verze. Po provedení tohoto procesu může váš kód běžet na libovolné verzi Windows 10 nebo Windows 11. Aby bylo možné tento kód použít, musí být cílová verze operačního systému projektu Windows 10 Anniversary Edition (10.0; Build 14394) nebo novější, i když minimální verze operačního systému může být starší.

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

Tento kód provede následující:

Nejprve zkontroluje, jestli je na aktuálním zařízení dostupná třída StoreContext v oboru názvů Windows.Services.Store (to znamená, že zařízení používá Windows 10, verze 1607 nebo novější). Pokud ano, kód bude pokračovat v použití této třídy.
V dalším kroku se pokusí získat ID vlastní kampaně pro případ, kdy má aktuální uživatel rozpoznaný účet Microsoft. K tomu kód získá objekt StoreSku, který představuje aktuální SKU aplikace, a poté získá přístup k vlastnosti CampaignId, aby načetl ID kampaně, pokud je k dispozici.
Kód se pak pokusí načíst ID kampaně pro případ, kdy aktuální uživatel nemá rozpoznaný účet Microsoft. V takovém případě se ID kampaně vloží do licence aplikace. Kód načte licenci pomocí metody GetAppLicenseAsync a pak parsuje obsah licence JSON pro hodnotu klíče s názvem customPolicyField1. Tato hodnota obsahuje ID kampaně.
Pokud StoreContext třída v oboru názvů Windows.Services.Store není dostupná, kód se vrátí zpět na použití metody GetAppPurchaseCampaignIdAsync v oboru názvů Windows.ApplicationModel.Store k načtení ID vlastní kampaně (tento obor názvů je k dispozici ve všech verzích Windows 10 nebo Windows 11). Všimněte si, že při použití této metody můžete načíst pouze ID vlastních kampaní pro kvalifikované akvizice, kde má uživatel rozpoznaný účet Microsoft.

Zadejte ID kampaně v proxy souboru pro obor názvů Windows.ApplicationModel.Store.

Obor názvů Windows.ApplicationModel.Store zahrnuje CurrentAppSimulator, speciální třídu, která simuluje operace Store pro testování kódu před odesláním aplikace do Storu. Tato třída načítá data z místního souboru s názvem Windows.StoreProxy.xml soubor. Předchozí příklad kódu ukazuje, jak zahrnout jak CurrentApp, tak CurrentAppSimulator do kódu projektu, a to jak pro ladící, tak pro neladící režim. Pokud chcete tento kód otestovat v ladicím prostředí, přidejte prvek AppPurchaseCampaignId do souboru WindowsStoreProxy.xml na svém vývojovém počítači, jak je znázorněno v následujícím příkladu. Při spuštění aplikace GetAppPurchaseCampaignIdAsync metoda vždy vrátí tuto hodnotu.

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

Obor názvů Windows.Services.Store neposkytuje třídu, kterou můžete použít k simulaci informací o licencích během testování. Místo toho musíte aplikaci publikovat do Storu a stáhnout ji do vývojového zařízení, aby používala svou licenci k testování. Další informace najdete v tématu nákupy v aplikaci a zkušební verze.

Testování vlastní kampaně

Než budete propagovat adresu URL vlastní kampaně, doporučujeme otestovat vlastní kampaň tak, že:

Přihlaste se k účtu Microsoft na zařízení, které používáte k testování.
Klikněte na adresu URL vlastní kampaně. Ujistěte se, že jste přesměrováni na stránku aplikace, a pak zavřete aplikaci pro UPW nebo stránku prohlížeče.
Několikrát klikněte na adresu URL, zavřete aplikaci pro UPW nebo stránku prohlížeče po každé návštěvě stránky aplikace. Během jedné z návštěv na stránce vaší aplikace zajistěte, aby aplikace vygenerovala konverzi. Spočítejte celkový počet kliknutí na adresu URL.
Ověřte, jestli se očekávaná zobrazení a převody stránek aplikace zobrazují v zobrazeních a převodech stránek aplikace podle ID kampaně a total campaign conversions grafy vsestavě Acquisitions , a otestujte kód vaší aplikace a ověřte, jestli může id kampaně úspěšně načíst pomocí výše popsaných rozhraní API.

Sdílet prostřednictvím

Vytvoření vlastní kampaně propagace aplikace

Ukázkový scénář vlastní kampaně

Vysvětlení toho, jak se akvizice kvalifikují jako převody

Kvalifikované konverze v sestavě akvizic

Kvalifikované konverze při programatickém získávání ID kampaně

Vložení ID vlastní kampaně na adresu URL stránky Microsoft Storu vaší aplikace

Programmaticky načíst ID vlastní kampaně pro aplikaci

Příklad kódu

Zadejte ID kampaně v proxy souboru pro obor názvů Windows.ApplicationModel.Store.

Testování vlastní kampaně

Další materiály