AdControl in XAML e .NET

  • Articolo

Avviso

A partire dal 1° giugno 2020, la piattaforma Microsoft Ad Monetization per le app Windows UWP verrà arrestata. Ulteriori informazioni

Questa procedura dettagliata illustra come usare la classe AdControl per visualizzare annunci banner in un'app XAML della piattaforma Universal Windows Platform (UWP) per Windows 10 o Windows 11 implementata con C#.

Nota

Microsoft Advertising SDK supporta anche le app XAML implementate con C++. Per un progetto di esempio completo, vedere gli esempi di annunci in GitHub.

Prerequisiti

Integrare un annuncio banner nell'app

  1. In Visual Studio aprire il progetto o crearne uno nuovo.

    Nota

    Se si usa un progetto esistente, aprire il file Package.appxmanifest nel progetto e assicurarsi che sia selezionata la funzionalità Internet (Client). L'app ha bisogno di questa funzionalità per ricevere annunci di test e annunci live.

  2. Se il progetto è destinato a qualsiasi CPU, aggiornare il progetto in modo da usare un output di compilazione specifico dell'architettura (ad esempio, x86). Se il progetto è mirato a Qualsiasi CPU, non sarà possibile aggiungere correttamente un riferimento alla libreria Microsoft Advertising nei passaggi seguenti. Per altre informazioni, vedere Errori di riferimento causati dalla destinazione Qualsiasi CPU nel progetto.

  3. Aggiungere un riferimento a Microsoft Advertising SDK nel progetto:

    1. Dalla finestra Solution Explorer, fare clic con il tasto destro del mouse su References e selezionare Aggiungi rifermento…
    2. In Gestione riferimenti, espandere Window universale, fare clic su Estensioni e quindi selezionare la casella di spunta accanto a Microsoft Advertising SDK per XAML (versione 10.0).
    3. In Gestione riferimenti fare clic su OK.

  4. Modificare il codice XAML per la pagina in cui si incorpora la pubblicità per includere lo spazio dei nomi Microsoft.Advertising.WinRT.UI. Ad esempio, nell'app di esempio predefinita generata da Visual Studio (denominata, in questa app, MyAdFundedWindows10AppXAML), la pagina XAML è MainPage.XAML.

    La sezione Pagina del file MainPage.xaml generato da Visual Studio include il codice seguente.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

    Aggiungere il riferimento allo spazio dei nomi Microsoft.Advertising.WinRT.UI in modo che la sezione Pagina del file MainPage.xaml abbia il codice seguente.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

  5. Nel tag Grigia, aggiungere il codice per AdControl. Assegnare le proprietà AdUnitId e ApplicationId ai valori di test e unità. Regolare anche l'altezza e la larghezza del controllo in modo che sia una delle dimensioni degli annunci supportate per gli annunci banner.

    Nota

    Ogni AdControl ha una unità pubblicitaria corrispondente usata dai nostri servizi per fornire annunci al controllo e ogni unità pubblicitaria è costituita da un ID unità pubblicitaria e un ID applicazione. In questi passaggi si assegnano i valori ID unità annunci di prova e ID applicazione al controllo. Questi valori di test possono essere usati solo in una versione di test dell'app. Prima di pubblicare l'app nello Store, è necessario sostituire questi valori di test con i valori dinamici del Partner Center.

    Il tag Griglia completo è simile a questo codice.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
        AdUnitId="test"
        HorizontalAlignment="Left"
        Height="250"
        VerticalAlignment="Top"
        Width="300"/>
</Grid>

    Il codice completo per il file MainPage.xaml dovrebbe essere simile al seguente.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

  6. Compilare ed eseguire l'app per visualizzarla con un annuncio.

Rilasciare l'app con annunci live

  1. Assicurarsi che l'uso degli annunci banner nella sua app segua le nostre linee guida per gli annunci banner.

  2. In Partner Center, andare alla pagina annunci In-app e creare una unità annuncio. Per il tipo di unità pubblicitaria, specificare Banner. Prendere nota sia dell'ID unità pubblicitaria che dell'ID applicazione.

    Nota

    I valori dell'ID applicazione per le unità annunci di test e le unità annunci UWP live hanno formati diversi. I valori id applicazione di test sono GUID. Quando crei un'unità annunci UWP live nel Centro per i partner, il valore dell'ID applicazione per l'unità annunci corrisponde sempre all'ID dello Store per la tua app (un valore di ID dello Store di esempio è 9NBLGGH4R315).

  3. Facoltativamente, è possibile abilitare l'aggregazione degli annunci pubblicitari per AdControl configurando le impostazioni nella sezione Impostazioni di aggregazione nella pagina Annunci in-app. L'aggregazione degli annunci pubblicitari ti consente di massimizzare le entrate pubblicitarie e le funzionalità di promozione delle app visualizzando annunci da più reti pubblicitarie, inclusi annunci di altre reti pubblicitarie a pagamento comeTaboola e Smaato e annunci per campagne di promozione di app Microsoft che non generano profitti.

  4. Nel codice, sostituire i valori delle unità annunci di test (ApplicationId e AdUnitId) con i valori dinamici generati nel Partner Center.

  5. Inviare l'app allo Store usando il Partner Center.

  6. Esaminare i report sulle prestazioni delle pubblicità nel Partner Center.

Gestire unità annunci per più controlli annunci nell'app

Si possono usare più oggetti AdControl in una singola app (ad esempio, ogni pagina dell'app potrebbe ospitare un oggetto AdControl diverso). In questo scenario, consigliamo di assegnare un'unità annunci diversa a ogni controllo. L'uso di unità annunci diverse per ogni controllo consente di configurare separatamente le impostazioni di aggregazione e ottenere dati di report discreti per ogni controllo. Ciò consente anche ai nostri servizi di ottimizzare meglio gli annunci che avremo usato per la tua app.

Importante

Puoi usare ogni unità annunci in una sola app. Se usi un'unità annunci in più app, gli annunci non verranno resi disponibili per tale unità annunci.