共用方式為


行銷活動半徑準則記錄 - 大量

定義可在大量檔案中上傳和下載的行銷活動半徑準則。

使用半徑準則,您可以選擇在郵遞區號、座標、地標或區域周圍,向潛在客戶顯示廣告、搜尋或檢視有關指定半徑的頁面。

每個半徑準則都會為隨附的準則比對調整定義半徑、緯度和經度。

您可以為每個行銷活動或廣告群組指定的半徑準則數目上限為 2,000。

注意事項

每個行銷活動只能有一筆 行銷活動位置意圖準則 記錄,以判斷適用于所有行銷 活動之行銷活動位置準則 和行銷活動 半徑準則 記錄的位置意圖選項。 當您建立行銷活動的第一個準則時,也會自動新增 行銷活動位置意圖準則 記錄,並將預設 目標 設定為 PeopleInOrSearchingForOrViewingPages。 無論行銷活動是否有任何其他準則,您都可以新增或更新行銷活動的行銷活動 位置意圖準則。 您無法刪除行銷 活動的行銷活動位置意圖準則,因為它沒有位置或半徑準則的目的。

如果指定廣告群組層級半徑準則,則會忽略該廣告群組的行銷活動層級半徑準則。 換句話說,廣告群組半徑準則會覆寫行銷活動半徑準則,而且不會套用為聯集。

另請注意,您必須將位置、負位置和半徑準則視為一組 地理準則。 如果廣告群組有任何地理準則,則不會繼承任何行銷活動的地理準則。 如果廣告群組沒有任何地理準則,則會繼承行銷活動的所有地理準則。 即使廣告群組具有位置意圖準則,也可以從行銷活動繼承地理準則。 如果使用廣告群組的地理準則,則會使用廣告群組的位置意圖準則;如果繼承行銷活動的地理準則,則會使用行銷活動的位置意圖準則,並忽略廣告群組的位置意圖準則。 您無法刪除行銷活動或廣告群組的位置意圖準則,雖然沒有位置或半徑準則沒有任何目的。

提示

如需如何使用目標準則的概觀,請參閱 向目標物件顯示廣告

您可以在DownloadCampaignsByAccountIdsDownloadCampaignsByCampaignIds服務要求中包含CampaignTargetCriterionsDownloadEntity值,以下載帳戶中的所有行銷活動半準則記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳

如果提供有效的 父標識 符值,下列大量 CSV 範例會新增行銷活動半徑準則。

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
    // '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 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

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

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

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

uploadEntities.Add(bulkCampaignRadiusCriterion);

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

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

針對 行銷活動半徑準則 記錄, 大量檔案架構中提供下列屬性欄位。

中標調整

您想要調整對應半徑準則之報價的百分比金額。

支援的值為負 90 (-90) 到正 900 (900) 。

添加: 選。 如果未包含,則會將中標調整設定為預設 值 0
更新: 必填
刪除: 唯讀

行銷活動

套用或移除此準則之行銷活動的名稱。

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

用戶端識別碼

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

添加:
更新:
刪除:

識別碼

準則的 Microsoft Advertising 唯一識別碼。

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

緯度

位置準則的緯度,以度為單位。

緯度必須大於或等於 -85.0,且小於或等於 +85.0。

您可以將緯度和經度指定為十進位值。 例如,一個 Redmond Way,Redmond, WA 的緯度和經度分別為 47.755367 和 -122.091827。 若要取得這些值,您可以將地理位置的位址輸入Bing 地圖服務,而座標會顯示在位址下方。

添加: 必填
更新: 必填
刪除: 唯讀

經度

位置準則的經度,以度為單位。

經度必須大於或等於 -180.0,且小於或等於 +180.0。

您可以將緯度和經度指定為十進位值。 例如,一個 Redmond Way,Redmond, WA 的緯度和經度分別為 47.755367 和 -122.091827。 若要取得這些值,您可以將地理位置的位址輸入Bing 地圖服務,而座標會顯示在位址下方。

添加: 必填
更新: 必填
刪除: 唯讀

修改時間

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

注意事項

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

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

名稱

目標地理位置的名稱。

名稱最多可以包含 50 個字元。

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

父項識別碼

套用或移除此準則之行銷活動的識別碼。

此大量欄位會對應至行銷活動記錄的 [標識符] 欄位。

添加: 唯讀和必要。 您必須指定現有的行銷活動識別碼,或指定等于父活動記錄之 [標識符] 欄位的負識別碼。 如果您要將新準則新增至相同大量檔案中的新行銷活動,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考金鑰
更新: 唯讀和必要
刪除: 唯讀和必要

Radius

半徑,指定地理位置周圍要設為目標的區域。

如果 Radius Unit 欄位設定為 Miles,則接受從 1 到 500 的正整數值。

如果 [ 半徑單位 ] 欄位設定為 [公里],則接受從 1 到 800 的正整數值。

注意事項

資料類型為雙精度浮點數,未來版本可能支援。 服務目前只接受並傳回整數值。

添加: 必填
更新: 必填
刪除: 唯讀

狀態

表示行銷活動與準則之間的關聯狀態。 如果準則套用至行銷活動,則此欄位的值為 Active。 若要刪除準則,請將狀態設定為 [已刪除]

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

Unit

指定之半徑的度量單位。

支援的值為 英吋 (預設) 和 公里

添加: 選。 如果未指定,則會設定 Miles 的預設值。
更新: 必填
刪除: 唯讀