Share via

XAML 和 .NET 中的 AdControl

  • 發行項

警告

自 2020 年 6 月 1 日起，Windows UWP 應用程式的 Microsoft 廣告收益平台將會關閉。 深入了解

本逐步解說示範如何使用AdControl 類別，在使用 C# 實作的 Windows 10 或 Windows 11 通用 Windows 平台 (UWP) XAML 應用程式中顯示橫幅廣告。

注意

Microsoft Advertising SDK 也支援使用 C++ 實作的 XAML 應用程式。 如需完整的範例專案，請參閱 GitHub 上的廣告範例。

必要條件

將橫幅廣告整合到應用程式

  1. 在 Visual Studio 中，打開專案或建立新專案。

    注意

    如果您使用現有的專案，請在專案中開啟 Package.appxmanifest 檔案，並確定已選取 [網際網路 (用戶端)] 功能。 您的應用程式需要這項功能，才能接收測試廣告和即時廣告。

  2. 如果您的專案以 [任何 CPU] 為目標，請更新您的專案以使用架構特定的組建輸出 (例如 x86)。 如果您的專案以 [任何 CPU] 為目標，您將無法在下列步驟中成功新增 Microsoft Advertising 程式庫的參考。 如需詳細資訊，請參閱在專案中以任何 CPU 為目標所造成的參考錯誤。

  3. 在專案中新增 Microsoft Advertising SDK 的參考：

    1. 從 [方案總管] 視窗，以滑鼠右鍵按一下 [參考]，然後選取 [新增參考...]。
    2. 在 [參考管理員] 中，展開 [通用 Windows]，按一下 [延伸模組]，然後選取 Microsoft Advertising SDK for XAML (10.0 版) 旁的核取方塊。
    3. 在 [參考管理員] 中，按一下 [確定]。

  4. 修改您要內嵌廣告的頁面 XAML，以包含 Microsoft.Advertising.WinRT.UI 命名空間。 例如，在 Visual Studio 所產生的預設範例應用程式中 (在此應用程式中，名為 MyAdFundedWindows10AppXAML)，XAML 頁面為 MainPage.XAML。

    Visual Studio 所產生 MainPage.xaml 檔案的 Page 區段具有下列程式碼。

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

    新增命名空間參考 Microsoft.Advertising.WinRT.UI ，讓 MainPage.xaml 檔案的 Page 區段具有下列程式碼。

    <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. 在 Grid 標籤中，新增 AdControl 的程式碼。 將 AdUnitId 和 ApplicationId 屬性指派給測試廣告單元值。 同時調整控制項的 Height 和 Width，讓它是支援的橫幅廣告大小。

    注意

    每個 AdControl 都有 一個相對應的廣告單元，由我們的服務用來為控制項提供廣告，而每個廣告單元都包含廣告單元識別碼和應用程式識別碼。 在這些步驟中，您會將測試廣告單元識別碼和應用程式識別碼值指派給控制項。 這些測試值只能在應用程式的測試版本中使用。 將應用程式發佈至市集之前，您必須先將這些測試值取代為合作夥伴中心的即時值。

    完整的 Grid 標記類似於以下程式碼。

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

    MainPage.xaml 檔的完整程式碼應如下所示。

    <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. 編譯並執行應用程式，以查看附帶廣告的情況。

使用即時廣告發行您的應用程式

  1. 確定您遵循我們的橫幅廣告指導方針，在應用程式中使用橫幅廣告。

  2. 在合作夥伴中心中，前往 [應用程式內廣告] 頁面和 [建立廣告單元]。 針對廣告單元類型，指定 [橫幅]。 記下廣告單元識別碼和應用程式識別碼。

    注意

    測試廣告單元和即時 UWP 廣告單元的應用程式識別碼值格式不同。 測試應用程式識別碼值為 GUID。 當您在合作夥伴中心建立即時 UWP 廣告單元時，廣告單元的應用程式識別碼值一律符合您應用程式的 Store 標識碼（例如：Store 識別碼值看起來像 9NBLGGH4R315）。

  3. 您可以選擇啟用 AdControl 的廣告流量分配，方法是在 [應用程式內廣告] 頁面上的 [流量分配設定] 區段中配置設定。 廣告流量分配可讓您透過顯示來自多個廣告網路的廣告，充分提高您的廣告收益和應用程式推廣能力，這些廣告包括來自 Taboola 和 Smaato 等其他付費廣告網路的廣告，以及 Microsoft 應用程式宣傳行銷活動的廣告。

  4. 在您的程式碼中，將測試廣告單元值 (ApplicationId 和 AdUnitId) 取代為您在合作夥伴中心產生的即時值。

  5. 使用合作夥伴中心將您的應用程式提交至市集。

  6. 在合作夥伴中心檢閱您的廣告績效報告。

管理應用程式中多個廣告控制項的廣告單元

您可以在單一應用程式中使用多個 AdControl 物件 (例如，應用程式中的每個頁面可能會裝載不同的 AdControl 物件)。 在此案例中，我們建議您為每個控制項指派不同的廣告單元。 如果每個控制項使用不同的廣告單元，您就能個別調整流量分配設定，並取得每個控制項的離散報告資料。 這也可讓我們的服務更妥善地將放送到您應用程式的廣告最佳化。

重要

每個廣告單元只能用於一個應用程式中。 如果您在多個應用程式中使用同一個廣告單元，該廣告單元將不會放送廣告。