廣告群組動態搜尋廣告目標記錄 - 大量

發行項
12/21/2023

定義可在大量檔案中上傳和下載的廣告群組動態搜尋廣告目標。

[廣告群組動態搜尋廣告目標] 記錄只能在具有有效動態搜尋廣告設定的搜尋活動中建立， (由 [ 網域語言]、[ 已啟用動態描述]、[ 頁面摘要標識符]、[ 來源] 和 [ 網站] 欄位) 組成。必須設定行銷活動的實驗標識符，而且廣告群組類型必須設定為「SearchDynamic」。

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

如果提供有效的父標識符值，下列大量 CSV 範例會新增新的廣告群組動態搜尋廣告目標。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupDynamicSearchAdTarget 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // '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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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

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

針對 廣告群組動態搜尋廣告目標 記錄，大量檔案架構中提供下列屬性欄位。

廣告群組
出價
行銷活動
用戶端識別碼
自訂參數
動態廣告目標條件 1
動態廣告目標條件 2
動態廣告目標條件 3
動態廣告目標操作員 1
動態廣告目標操作員 2
動態廣告目標操作員 3
動態廣告目標值 1
動態廣告目標值 2
動態廣告目標值 3
最終 URL 尾碼
Id
修改時間
名稱
父項識別碼
狀態
追蹤範本

廣告群組

包含動態廣告目標的廣告組名， (網頁準則) 。

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

注意事項

若要新增、更新和刪除，您必須指定 [父識別碼 ] 或 [ 廣告群組] 欄位。

出價

要在銀場中進行成交的金額。

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

行銷活動

包含廣告群組和動態廣告目標的行銷活動名稱， (網頁準則) 。

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

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 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關鍵字會移除先前的設定。若要移除自訂參數的子集，請指定您想要保留的自訂參數，並省略任何您不想要保留的參數。新的自訂參數集將取代任何先前的自訂參數集。
刪除： 唯讀

注意事項

如果您未設定任何動態廣告目標條件、操作員或值欄位，則實際上是以所有網頁為目標。

動態廣告目標條件 1

最多 3 個網頁條件運算元中的第一個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 1 值 ，就會符合條件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle和 Url。

添加： 選。如果您未設定任何動態廣告目標條件或值欄位，則實際上是以所有網頁為目標。針對所有網頁，每個廣告群組只能有一個動態廣告目標。
更新： 不允許。您無法更新動態廣告目標條件或值欄位。若要更新網頁條件，您必須刪除動態廣告目標並新增一個新的目標。
刪除： 唯讀

動態廣告目標條件 2

最多 3 個網頁條件運算元的第二個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 2 值 ，就會符合條件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle和 Url。

動態廣告目標條件 3

最多 3 個網頁條件運算元中的第三個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 1 值 ，就會符合條件。

可能的值包括 Category、 CustomLabel、 PageContent、 PageTitle和 Url。

動態廣告目標操作員 1

最多 3 個網頁條件運算子中的第一個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 1 值 ，就會符合條件。

可能的值包括 Contains 和 Equals。

添加： 選。如果您未設定任何動態廣告目標條件、操作員或值欄位，則實際上是以所有網頁為目標。如果您設定動態廣告目標條件 1，但未設定動態廣告目標操作員 1，我們將會針對選取的運算元使用預設運算子。如果您想要建立 URL Equals，則必須傳遞運算子。 更新： 不允許。您無法更新動態廣告目標操作員或值欄位。若要更新網頁條件，您必須刪除動態廣告目標並新增一個新的目標。
刪除： 唯讀

動態廣告目標操作員 2

最多 3 個網頁條件運算子的第二個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 2 值 ，就會符合條件。

可能的值包括 Contains 和 Equals。

添加： 選。如果您未設定任何動態廣告目標條件、操作員或值欄位，則實際上是以所有網頁為目標。如果您設定動態廣告目標條件21，但未設定動態廣告目標操作員 2，我們將會針對選取的運算元使用預設運算子。如果您想要建立 URL Equals，則必須傳遞運算子。 更新： 不允許。您無法更新動態廣告目標操作員或值欄位。若要更新網頁條件，您必須刪除動態廣告目標並新增一個新的目標。
刪除： 唯讀

動態廣告目標操作員 3

最多 3 個網頁條件運算子中的第三個。如果此欄位所參考的網頁屬性包含或等於 動態廣告目標值 3 值 ，就會符合條件。

可能的值包括 Contains 和 Equals。

添加： 選。如果您未設定任何動態廣告目標條件、操作員或值欄位，則實際上是以所有網頁為目標。如果您設定動態廣告目標條件 3，但未設定動態廣告目標操作員 3，我們會針對選取的運算元使用預設運算子。如果您想要建立 URL Equals，則必須傳遞運算子。 更新： 不允許。您無法更新動態廣告目標操作員或值欄位。若要更新網頁條件，您必須刪除動態廣告目標並新增一個新的目標。
刪除： 唯讀

動態廣告目標值 1

最多 3 個網頁條件或準則引數中的第一個。

您可以將此字串設定為網站的 URL、類別、頁面標題或頁面內容。例如，如果 [動態廣告目標條件 1 ] 欄位設定為 [URL]，則您可以將此欄位設定為 [contoso.com/flowers]。

動態廣告目標值 2

最多 3 個網頁條件或準則引數的第二個。

您可以將此字串設定為網站的 URL、類別、頁面標題或頁面內容。例如，如果 [動態廣告目標條件 2 ] 欄位設定為 [URL]，您可能會將此欄位設定 為 [contoso.com/flowers]。

動態廣告目標值 3

最多 3 個網頁條件或準則引數中的第三個。

您可以將此字串設定為網站的 URL、類別、頁面標題或頁面內容。例如，如果 [動態廣告目標條件 3 ] 欄位設定為 [URL]，您可能會將此欄位設定 為 [contoso.com/flowers]。

識別碼

動態廣告目標的系統產生識別碼 (網頁準則) 。

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

最終 URL 尾碼

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

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

修改時間

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

注意事項

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

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

名稱

您可以用來識別準則的準則名稱，例如您可以依字母順序篩選或排序。

準則名稱長度必須介於 1 到 2048 之間，包含在內。

添加： 選。如果您未指定任何名稱，預設會將名稱設定為串連的條件清單。每個條件都會以和關鍵字分隔。例如，如果條件是) URL 包含花卉 、b) URL 包含書籍 ，而 c) PageContent 包含 seattle，則預設準則名稱會是 Url 包含花卉，而 Url 包含書籍，而 PageContent 包含 seattle。如果所有條件和值欄位都是空的，則您實際上是以所有網頁為目標，且名稱會設定為 [所有網頁]。
更新： 選。如果未設定更新的值，則此設定不會變更。如果您指定 delete_value 關鍵字，則準則名稱會更新為預設值，也就是 所有網頁 或串連的準則清單。
刪除： 唯讀

父項識別碼

系統產生的廣告群組識別碼，其中包含動態廣告目標 (網頁準則) 。

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

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

注意事項

若要新增、更新和刪除，您必須指定 [父識別碼 ] 或 [ 廣告群組] 欄位。

狀態

動態廣告目標的狀態 (網頁準則) 。

可能的值為 Active、 Paused或 Deleted。

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

追蹤範本

追蹤範本可以與從您為動態搜尋廣告行銷活動指定的網域動態產生的登陸頁面 URL 搭配使用。藉由結合網域與追蹤範本，登陸頁面 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 會相同。

共用方式為

廣告群組動態搜尋廣告目標記錄 - 大量

廣告群組

出價

行銷活動

用戶端識別碼

自訂參數

動態廣告目標條件 1

動態廣告目標條件 2

動態廣告目標條件 3

動態廣告目標操作員 1

動態廣告目標操作員 2

動態廣告目標操作員 3

動態廣告目標值 1

動態廣告目標值 2

動態廣告目標值 3

識別碼

最終 URL 尾碼

修改時間

名稱

父項識別碼

狀態

追蹤範本

意見反應

其他資源