應用程式安裝廣告記錄 - 大量

發行項
02/08/2024

定義可在大量檔案中下載及上傳的應用程式安裝廣告。

應用程式安裝廣告與文字廣告類似，但會使用按鈕提供您應用程式的直接連結，將客戶直接傳送至適用的市集以下載應用程式。這是理想的解決方案，適用於想要管理和推動其應用程式下載的廣告商，而不是網站流量。

應用程式安裝廣告會自動偵測客戶的行動裝置和操作系統，並將它們傳送至對應的 Apple App Store 或 Google Play。您也可以使用與應用程式延伸模組相同的轉換追蹤夥伴來追蹤轉換：AppsFlyer、Kochava、Tune、Singular、Adjust 和 Branch。

注意事項

應用程式安裝廣告僅適用於澳洲、巴西、加拿大、法國、德國、印度、英國，以及iOS和Android上的美國。目前僅支援 Apple App Store 和 Google Play 商店中美國提供的應用程式。不支援 Windows。

並非每個人都有這項功能。如果沒有，別擔心。即將推出。

注意事項

應用程式安裝廣告只能在廣告群組類型設定為「SearchStandard」的搜尋活動中建立。如果廣告群組類型設定為「SearchDynamic」，則廣告群組不支援應用程式安裝廣告。

您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 AppInstallAds 的 DownloadEntity 值，以下載帳戶中的所有 App Install Ad 記錄。此外，下載要求必須包含 EntityData 範圍。如需大量服務的詳細資訊，包括最佳做法，請參閱大量下載和上傳。

如果提供有效的父標識碼值，下列大量 CSV 範例會新增應用程式安裝廣告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer

如果您使用適用於 .NET、Java 或 Python 的 Bing 廣告 SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAppInstallAd 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // AppInstallAd object of the Campaign Management service.
    AppInstallAd = new AppInstallAd
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Android",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "FinalUrlGoesHere"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAppInstallAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 應用程式安裝廣告 記錄，大量檔案架構中提供下列屬性欄位。 [應用程式識別符]、[應用程式平臺]、[文字] 和 [標題] 字段的組合，可讓應用程式安裝廣告成為唯一的。

廣告群組
應用程式識別碼
應用程式平臺
行銷活動
用戶端識別碼
自定義參數
裝置喜好設定
編輯訴求狀態
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
最終 URL
最終 URL 後綴
Id
修改時間
父項識別碼
發行者國家/地區
狀態
文字
Title
追蹤範本

廣告群組

包含廣告的廣告組名。

添加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 廣告群組] 字段。

應用程式識別碼

應用程式市集所提供的應用程式識別碼。

如果應用程式是新的，請等候 4-7 天，廣告才會符合傳遞資格。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

應用程式平臺

應用程式平臺。

可能的值包括 iOS 和 Android。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行銷活動

包含廣告群組和廣告的營銷活動名稱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為100的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

自定義參數

用於 URL 追蹤的自訂索引鍵和值參數集合。

在大量檔案中，自定義參數清單的格式如下。

將每個自定義參數位格式化為 Key=Value，例如 {_promoCode}=PROMO1。
Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，如果您包含超過 8 個自定義參數，則會傳回錯誤。每個索引鍵和值組都會以分號和空格 ( 分隔」;“) ，例如 {_promoCode}=PROMO1;{_season}=summer。
索引鍵不能包含分號。如果 Value 包含分號，則必須以 '\;' 逸出。此外，如果 Value 包含反斜杠，也必須以『\』逸出。
密鑰不能超過 16 UTF-8 位元組，而且值不能超過 250 UTF-8 位元組。索引鍵是必要的，而 Value 是選擇性的。密鑰的大小上限不包含大括弧和底線，也就是 '{'、'_' 和 '}'。

注意事項

使用大量服務時，密鑰必須以括弧和前置底線格式化，例如，如果 Key 為 promoCode，則必須格式化為 {_promoCode}。使用行銷活動管理服務時，您無法指定括弧和底線。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。若要移除所有自定義參數，請將此字段設定 為 delete_value。 delete_value關鍵詞會移除先前的設定。若要移除自定義參數的子集，請指定您想要保留的自定義參數，並省略任何您不想要保留的參數。新的自定義參數集將取代任何先前的自定義參數集。
刪除： 唯讀

裝置喜好設定

此欄位會決定應用程式安裝廣告的喜好設定是要顯示在行動裝置和 Tablet 裝置上，還是只在行動裝置上顯示。 (桌面電腦目前不支援應用程式安裝廣告。)

可能的值為 ) 的所有 (行動裝置和 Tablet 裝置和行動裝置 (也就是排除) 的 tablet，這與行銷活動管理服務中使用的值不同。

SixMonths

在大量下載和上傳結果檔案中，此字段永遠不會是空的。如果您未指定裝置喜好設定，則會傳回預設值 All 。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。如果您將此欄位設定 為 delete_value，則實際上會重設為預設值 All。
刪除： 唯讀

編輯訴求狀態

判斷您是否可以對編輯檢閱所發現的問題發出意見反應。

下表說明可能的值。

值	描述
上訴	編輯問題很吸引人。
訴求附加	編輯問題是可訴求的，而且已提交訴求。
NotAppealable	編輯問題無法吸引人。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯位置

編輯檢閱失敗的廣告元件或屬性。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯原因代碼

識別失敗原因的程序代碼。如需可能的原因代碼清單，請參閱編輯原因代碼。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯狀態

廣告的編輯狀態。

下表說明可能的值。

值	描述
作用中	廣告通過編輯檢閱。
ActiveLimited	廣告在一或多個市場中通過編輯檢閱，而廣告的一或多個元素正在另一個市場中進行編輯檢閱。例如，廣告已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對	廣告失敗的編輯檢閱。
非作用中	廣告的一或多個元素正在進行編輯檢閱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

如果字詞組合造成失敗，或失敗是以原則違規為基礎，則不會設定此字段。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

最終 URL

搜尋使用者登陸並可以選擇安裝應用程式的URL。

下列驗證規則適用於應用程式安裝廣告的 最終 URL 。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您可以在此欄位中只指定一個網址。
僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。
每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

最終 URL 後綴

最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。如需詳細資訊和驗證規則，請參閱技術指南中的最終 URL 後綴。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

識別碼

系統產生的廣告標識碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。接著可以在相依記錄類型的 [ 父標識符] 字段中參考廣告的負標識碼集，例如應用程式安裝廣告標籤。如果您要在同一個大量檔案中新增廣告和新的相依記錄，建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

修改時間

上次更新實體的日期和時間。值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關信息，請參閱基本 XML 數據類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

父項識別碼

包含廣告之廣告群組的系統產生標識碼。

此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。

添加： 唯讀和必要。您必須指定現有的廣告群組標識符，或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。如果您要將新廣告新增至相同大量檔案中的新廣告群組，建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀
刪除： 唯讀

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 廣告群組] 字段。

發行者國家/地區

發行者國家或地區的清單，其編輯指導方針不允許指定的詞彙。

在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

狀態

廣告的狀態。

可能的值為 Active、 Paused 或 Deleted。

添加： 選。預設值為 Active。
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

Text

廣告復本。此復本至少必須包含一個字。廣告的復本和標題組合必須至少有三個字組。

廣告復本不能包含動態文字字串，例如 {keyword}。

複製的最大輸入長度為 71 個字元。請注意，對於使用繁體中文的廣告群組，文字限製為38個字元。

廣告復本不能包含換行符 (\n) 字元。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

標題

廣告的標題。標題必須至少包含一個字。廣告的復本和標題組合必須至少有三個字組。

標題不能包含動態文字字串，例如 {keyword}。

標題的最大輸入長度為 25 個字元。請注意，對於使用繁體中文的廣告群組，標題限製為15個字元。

標題不能包含換行符 (\n) 字元。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

追蹤範本

要作為使用 FinalUrls 所指定 URL 預設值的追蹤範本。

下列驗證規則適用於追蹤範本。如需支援的範本和參數的詳細資訊，請參閱 Microsoft Advertising 說明文章我可以使用哪些追蹤或 URL 參數？

針對較低層級實體定義的追蹤範本，例如廣告會覆寫針對較高層級實體所設定的範本，例如營銷活動。如需詳細資訊，請參閱實體限制。
追蹤範本的長度限製為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
追蹤範本必須是格式正確的 URL，開頭為下列其中一項： http://、 https://、 {lpurl} 或 {unescapedlpurl}。
Microsoft Advertising 不會驗證自定義參數是否存在。如果您在追蹤範本中使用自定義參數，但它們不存在，則登陸頁面 URL 會包含自定義參數的索引鍵和值佔位元，而不需替代。例如，如果您的追蹤範本是 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}，且 { _season} 或 {_promocode} 都未定義於行銷活動、廣告群組、準則、關鍵詞或廣告層級，則登陸頁面 URL 會相同。

共用方式為

應用程式安裝廣告記錄 - 大量

廣告群組

應用程式識別碼

應用程式平臺

行銷活動

用戶端識別碼

自定義參數

裝置喜好設定

編輯訴求狀態

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

最終 URL

最終 URL 後綴

識別碼

修改時間

父項識別碼

發行者國家/地區

狀態

Text

標題

追蹤範本

意見反應

其他資源