Condividi tramite

AdControl in XAML e .NET

  • Articolo

Avvertimento

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

Questa procedura dettagliata illustra come usare la classe AdControl per visualizzare annunci banner in un'app XAML UWP (Universal Windows Platform) 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 su GitHub.

Prerequisiti

Integrare un annuncio banner nella tua app

  1. In Visual Studio aprire il progetto o creare un nuovo progetto.

    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 è impostato su Any CPU, aggiornare il progetto per utilizzare un output di compilazione specifico per l'architettura (ad esempio, x86). Se il progetto è destinato Qualsiasi CPU, non sarà possibile aggiungere correttamente un riferimento alla libreria Microsoft Advertising nei passaggi seguenti. Per altre informazioni, vedere Errori di riferimento causati dal targeting di Qualsiasi CPU nel progetto.

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

    1. Nella finestra esplora soluzioni fare clic con il pulsante destro del mouse su riferimenti e selezionare Aggiungi riferimento...
    2. In Gestione riferimenti, espandere Windows Universale, fare clic su Estensioni , e quindi selezionare la casella di controllo accanto a Microsoft Advertising SDK per XAML (versione 10.0).
    3. In Gestione riferimentifare clic su OK.

  4. Modificare il codice XAML per la pagina in cui si incorporano annunci 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 Page 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 Page 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 grid, aggiungere il codice per il AdControl. Assegnare le proprietà adUnitId e ApplicationId ai valori unità annunci di test. Regolare anche l'altezza e la larghezza del controllo in modo che sia una delle dimensioni supportate per gli annunci banner.

    Nota

    Ogni AdControl ha un'unità pubblicitaria corrispondente utilizzata 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 di ID di unità di annunci di test e ID di 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 valori dinamici dal Centro per i partner.

    Il tag di Grid completo è simile al codice seguente.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="00001111-aaaa-2222-bbbb-3333cccc4444"
        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="00001111-aaaa-2222-bbbb-3333cccc4444"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

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

Rilascia l'app con annunci in diretta

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

  2. Nel Centro per i partner passare alla pagina Annunci in-app e creare un'unità pubblicitaria. 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à pubblicitarie di test e le unità pubblicitarie UWP live hanno formati diversi. I valori id applicazione di test sono GUID. Quando crei un'unità pubblicitaria UWP live nel Centro per i partner, il valore dell'ID applicazione per l'unità pubblicitaria corrisponde sempre all'ID dello Store per la tua app (un valore di ID dello Store di esempio è 9NBLGGH4R315).

  3. Puoi abilitare opzionalmente la mediazione annunci per AdControl configurando le impostazioni nella sezione Impostazioni di mediazione sulla pagina Annunci in-app. L'aggregazione degli annunci pubblicitari consente di ottimizzare le funzionalità di ricavi e promozioni delle app visualizzando annunci da più reti pubblicitarie, inclusi annunci di altre reti pubblicitarie a pagamento, ad esempio Taboola e Smaato e annunci per le campagne promozionali di app Microsoft.

  4. Nel tuo codice, sostituisci i valori delle unità annunci di test (ApplicationId e AdUnitId) con i tuoi valori effettivi generati nel Partner Center.

  5. Inviare l'app allo Store usando il Centro per i partner.

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

Gestisci unità pubblicitarie per più controlli annunci nella tua app

Puoi usare più oggetti AdControl in una singola app, ad esempio ogni pagina dell'app potrebbe ospitare un oggetto AdControl diverso. In questo scenario, ti consigliamo di assegnare un'unità pubblicitaria diversa a ogni controllo. L'uso di unità pubblicitarie 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à pubblicitaria in una sola app. Se usi un'unità pubblicitaria in più app, gli annunci non verranno resi disponibili per tale unità pubblicitaria.