廣告群組放置準則記錄 - 大量

發行項
12/31/2024

定義可以在大量檔案中上傳和下載的廣告群組放置準則。

放置目標可讓您定義潛在使用者的位置，以及您想要顯示廣告的位置。

注意事項

我們現在只支援廣告群組層級放置準則。

提示

如需如何使用目標準則的概觀，請參閱向目標對象顯示廣告。

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

如果提供有效的父標識碼值，下列大量 CSV 範例會新增廣告群組放置準則。

Type,Status,Id,Parent Id,Target,Bid Adjustment,Name
Format Version,,,,,,6.0
Ad Group Placement Criterion,Active,,parentId,placementId,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupPlacementCriterion
var bulkAdGroupPlacementCriterion = new BulkAdGroupPlacementCriterion
{
    // 'Ad Group' column header in the Bulk file is read-only
    AdGroupName = null,

    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // 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 PlacementCriterion
        {
            // 'Target' column header in the Bulk file
            PlacementId = placementIdKey
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 0,
        },

        // 'Id' column header in the Bulk file
        Id = null,

        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkAdGroupPlacementCriterion);

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

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

針對 廣告群組放置準則 記錄，大量檔案架構中提供下列屬性欄位。

廣告群組
中標調整
行銷活動
用戶端識別碼
Id
父項識別碼
狀態
Target

廣告群組

套用或移除此準則的廣告組名。

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

中標調整

您想要調整對應目標之報價的百分比金額。

警告

我們目前不支援廣告群組放置準則的中標調整。中標調整值會重設為 0。

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

行銷活動

包含套用或移除此準則之廣告群組的營銷活動名稱。

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

用戶端識別碼

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

加：自選
更新： 自選
刪除： 自選

識別碼

準則的 Microsoft Advertising 唯一標識符。

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

父項識別碼

套用或移除此準則之廣告群組的標識碼。

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

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

狀態

表示廣告群組與準則之間的關聯狀態。如果準則套用至廣告群組，則此字段的值為 Active。若要刪除準則，請將狀態設定為 [已刪除]。

加：唯讀。當您新增準則時，狀態一律會設定為 [作用 中]。如果您上傳另一個值，例如 Foo ，結果檔案會包含相同的值，雖然準則為使用中。
更新： 自選
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。若要刪除特定的性別準則比對，您必須上傳狀態、標識碼和父標識符。

Target

您想要以對應的 「標定調整」為目標的位置。

支援的值為 12-NTP、 13-productivity、 14-Gaming、 15-MSN。

加：必填
更新： 必填
刪除： 唯讀

共用方式為