共用方式為

營銷活動位置意圖準則記錄 - 大量

  • 發行項

定義可在大量檔案中上傳和下載的營銷活動位置準則。

每個位置意圖準則都會為營銷活動或廣告群組的所有位置和半徑準則定義意圖選項。 沒有任何伴隨的準則比對調整。

您可以為每個行銷活動或廣告群組指定的位置意圖準則數目上限為一。

注意事項

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

提示

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

您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 CampaignTargetCriterions 的 DownloadEntity 值，以下載帳戶中的所有營銷活動位置意圖準則記錄。 此外，下載要求必須包含 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 Location Intent Criterion,Active,,-111,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignLocationIntentCriterion
var bulkCampaignLocationIntentCriterion = new BulkCampaignLocationIntentCriterion
{
    // '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 LocationIntentCriterion
        {
            // 'Target' column header in the Bulk file
            IntentOption = IntentOption.PeopleIn
        },

        CriterionBid = null,

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

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

uploadEntities.Add(bulkCampaignLocationIntentCriterion);

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

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

針對 活動位置意圖準則 記錄， 大量檔案架構中提供下列屬性欄位。

行銷活動

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

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

用戶端識別碼

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

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

識別碼

準則的標識碼。

注意事項

目前位置意圖準則標識碼等於父標識符，但您不應該對該關聯性採取相依性。 最佳做法是將位置意圖準則標識碼視為相異。

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

修改時間

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

注意事項

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

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

父項識別碼

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

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

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

狀態

表示營銷活動與準則之間的關聯狀態。 如果針對營銷活動設定準則，則此字段的值為 Active。 若要刪除準則，請將狀態設定為 [已刪除]。

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

Target

判斷某個人是否必須實際位於目標位置，才能顯示廣告。

支援下列值。 預設值為 PeopleInOrSearchingForOrViewingPages。

  • 如果您想要向使用者顯示關於您目標位置的廣告、搜尋或檢視頁面，請使用 PeopleInOrSearchingForOrViewingPages 。
  • 如果您想要向目標位置中的人員顯示廣告，請使用 PeopleIn 。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您設定此欄位，則必須將它設定為有效的值，也就是 PeopleInOrSearchingForOrViewingPages 或 PeopleIn。
刪除： 唯讀