共用方式為

展開的文字廣告標籤記錄 - 大量

  • 發行項

定義 展開文字廣告 與標籤之間的關聯記錄，該卷 標 可在大量檔案中上傳和下載。 若要上傳或下載展開的文字廣告或標籤，請使用 展開的文字廣告 或 標籤 記錄。

注意事項

  • 在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。 在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。 如需詳細資訊，請 參閱關於回應式搜尋廣告。
  • 現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
  • 您仍然可以暫停、啟用或移除展開的文字廣告。 否則，嘗試新增或更新展開的文字廣告會導致 CampaignServiceAdTypeInvalid 錯誤。
  • 深入瞭解這項變更。

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

如果 提供有效的標識 符和 父 識別碼值，下列大量 CSV 範例會將標籤套用至展開的文字廣告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Expanded Text Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExpandedTextAdLabel
var bulkExpandedTextAdLabel = new BulkExpandedTextAdLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = expandedTextAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

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

uploadEntities.Add(bulkExpandedTextAdLabel);

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 和 Deleted。 如果標籤套用至展開的文字廣告，則此欄位的值為 Active。

添加： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。