資產群組記錄 - 大量

發行項
02/08/2024

定義可在大量檔案中下載及上傳的資產群組。

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

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

針對 資產群組 記錄，大量檔案架構中提供下列屬性欄位。

資產群組
商務名稱
呼叫動作
行銷活動
用戶端識別碼
描述
編輯訴求狀態
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
結束日期
最終 URL
標題
Id
Images
長標題
行動裝置最終 URL
修改時間
父項識別碼
路徑 1
路徑 2
狀態
開始日期

資產群組

資產群組的名稱。

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

商務名稱

企業名稱。

視您的物件廣告位置而定，您的企業名稱可能會出現在您的廣告中。

字串的長度限制為 25 個字元。

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

呼叫動作

讓客戶立即按下您廣告的簡短、吋笛原因。

可能的值為 ActNow、AddToCart、ApplyNow、Automated、BetNow、BidNow、BookACar、BookHotel、BookNow、BookTravel、Browse、BuildNow、Buy、BuyNow、ChatNow、Compare、ContactUs、Coupon、Coupon、 Default、Directions、Directions、Download、EmailNow、EnrollNow、Explore、FileNow、FindJob、FindStore、FreePlay、FreeQuote、FreeTrial、GetDeals、GetDemo、GetNow、GetOffer、GetQuote、GoToDemo、Install、JoinNow、LearnMore、ListenNow、LogIn、Message、NewCars、NoButton、OpenLink、OrderNow、PlayGame、PlayNow、 PlayNow PostJob、Register、RegisterNow、RenewNow、RentACar、RentNow、Reorder、Reserve、Sale、SaveNow、Schedule、 SeeDemo、SeeMenu、SeeModels、SeeMore、SeeOffer、SeeOffers、SellNow、ShopNow、Showtimes、SignIn、SignUp、StartFree、StartNow、Subscribe、SwitchNow、TestDrive、TryNow、Unknown、UsedCars、ViewCars、ViewDemo、ViewNow、ViewPlans、VisitSite、VisitStore、VoteNow、Watch、WatchMore、WatchNow。

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

行銷活動

包含資產群組的活動名稱。

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

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

用戶端識別碼

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

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。若要移除所有自定義參數，請將此字段設定 為 delete_value。 delete_value關鍵詞會移除先前的設定。若要移除自定義參數的子集，請指定您想要保留的自定義參數，並省略任何您不想要保留的參數。新的自定義參數集將取代任何先前的自定義參數集。
刪除： 唯讀

描述

Bing 可用來優化廣告版面配置的描述清單。

為了將所有廣告格式的曝光率最大化，描述不一定會顯示在您的廣告中。

從數據模型的觀點來看，描述會儲存為文字資產。多個廣告可以使用相同的資產。例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。

您必須設定 2-5 個描述。這些描述會在大量檔案中以 JSON 字串表示。下列範例 JSON 包含兩個描述，第一個描述會釘選到特定位置。和 idtext 是資產的屬性，而 editorialStatus 和 assetPerformanceLabel 是資產鏈接的屬性，也就是資產與廣告之間的關聯性。如需詳細資訊，請參閱下方的 assetPerformanceLabel、編輯狀態、標識碼和文字。

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

注意事項

在逗號分隔的大量檔案中，您必須用一組額外的雙引號括住資產連結清單、每個屬性索引鍵，以及每個屬性字串值，例如，上述 JSON 字符串會寫成 “[{”“text”“：”“Find New Customers & Increase Sales！”“}，{”“text”“：”“Start Advertising on Contoso Today.”“}]”。

以下是大量下載範例，您也會在其中取得唯讀屬性， id 例如和 editorialStatus：

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加： 如果其父活動未與市集相關聯，則為必要，如果父活動與市集相關聯，則為選擇性。如果父活動與商店相關聯，而且您指定了 [描述]，您也必須指定 [標題]、[長標題] 和 [影像]。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
更新： 選。若要保留所有現有的資產連結，請將此字段設定或保留空白。如果您設定此欄位，則會取代先前連結至此廣告的任何描述。如果您指定此欄位，則需要 2-5 個描述的清單。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
刪除： 唯讀

assetPerformanceLabel

這可讓您知道資產的執行效能。

當 assetPerformanceLabel 您下載回應式搜尋廣告時，屬性是唯讀的。下表說明可能的值。

值	描述
低	此資產的效能很低，建議您取代此資產以改善廣告效能。
良好	此資產的效能良好。建議您保留此資產並新增更多資產，以改善您的廣告效能。
最佳	此資產的效能是最佳的其中之一，建議您新增更類似的資產。
未分級	此資產沒有任何效能評等。這可能是因為資產處於非作用中狀態、沒有足夠的資訊來判斷其效能，或是沒有足夠的類似資產可與其進行比較。
學習	正在主動評估資產的效能。評估完成後，資產評等會是低、良好、最佳或未分級。

編輯狀態

當 editorialStatus 您下載回應式搜尋廣告時，屬性是唯讀的。下表說明可能的值。

值	描述
作用中	資產通過編輯檢閱。
ActiveLimited	資產已在一或多個市場中通過編輯檢閱，而資產的一或多個元素正在另一個市場中進行編輯檢閱。例如，資產已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對	資產失敗的編輯檢閱。
非作用中	資產的一或多個元素正在進行編輯檢閱。
Unknown	保留供日後使用。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

多個廣告可以使用相同的資產。例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。上傳文字資產之後，結果檔案會包含資產標識符，例如， ""id:""123不論資產是新的還是已經存在於帳戶的資產庫中。

文字

每個描述的 text 屬性至少必須包含一個字。每個描述屬性的最大 text 輸入長度為90個字元。對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 45 個字元。雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

屬性 text 不能包含換行符 (\n) 字元。

編輯訴求狀態

判斷您是否可以對編輯檢閱所發現的問題發出意見反應。

下表說明可能的值。

值	描述
上訴	編輯問題很吸引人。
訴求附加	編輯問題是可訴求的，而且已提交訴求。
NotAppealable	編輯問題無法吸引人。

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

編輯位置

編輯檢閱失敗的廣告元件或屬性。

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

編輯原因代碼

識別失敗原因的程序代碼。如需可能的原因代碼清單，請參閱編輯原因代碼。

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

編輯狀態

資產群組的編輯狀態。

下表說明可能的值。

值	描述
作用中	資產群組已通過編輯檢閱。
ActiveLimited	資產群組已在一或多個市場中通過編輯檢閱，而資產群組的一或多個元素正在另一個市場中進行編輯檢閱。例如，資產群組已通過加拿大的編輯檢閱，但仍在美國中擱置檢閱。
反對	資產群組失敗的編輯檢閱。
非作用中	資產群組的一或多個元素正在進行編輯檢閱。

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

編輯詞彙

失敗的編輯檢閱詞彙。

如果字詞組合造成失敗，或失敗是以原則違規為基礎，則不會設定此字段。

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

結束日期

資產群組到期的日期。

如果您未指定結束日期，資產群組將不會過期。結束日期可以延長，讓資產群組符合傳遞資格，即使在資產群組過期之後也一樣。

結束日期包含在內。例如，如果您將 結束日期 設定為 2020/12/31，資產群組將會在 2020 年 12 月 31 日下午 11：59 到期。時間是以您在營銷活動層級指定的時區為基礎。

添加： 選。若要在新增資產群組時未設定結束日期，請勿設定此欄位。
更新： 選。如果未設定更新的值，則此設定不會變更。若要刪除目前的結束日期，且實際上未設定結束日期，請將此字段設定為 “delete_value” 字串。當您下次擷取資產群組時，將不會設定此字段。
刪除： 唯讀

最終 URL

登陸頁面 URL。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

下列驗證規則適用於最終 URL 和最終行動 URL。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。此服務最多可允許 10 個，以取得潛在的向前相容性。
每個 URL 都會以分號和空格分隔 (」;“) 。
僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。
每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。
如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

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

標題

Bing 可用來優化廣告版面配置的標題清單。

若要將所有廣告格式的效能最大化，標題不一定會顯示在您的廣告中。

從數據模型的觀點來看，標題會儲存為文字資產。多個廣告可以使用相同的資產。例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。

您必須設定 3-15 個標題。標題會在大量檔案中以 JSON 字串表示。下列範例 JSON 包含兩個標題。和 idtext 是資產的屬性，而 editorialStatus 和 assetPerformanceLabel 是資產鏈接的屬性，也就是資產與廣告之間的關聯性。如需詳細資訊，請參閱下方的 assetPerformanceLabel、編輯狀態、標識碼和文字。

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

注意事項

在逗號分隔的大量檔案中，您必須用一組額外的雙引號括住資產連結清單、每個屬性索引鍵，以及每個屬性字串值，例如，上述 JSON 字串會寫成 “[{”“text”“：”“Contoso”“}，{”“text”“”：“”無縫整合“”}]“。

以下是大量下載範例，您也會在其中取得唯讀屬性， id 例如和 editorialStatus：

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加： 如果其父活動未與市集相關聯，則為必要，如果父活動與市集相關聯，則為選擇性。如果父活動與商店相關聯，而且您指定了標題，您也必須指定 LongHeadlines、Descriptions 和 Images。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
更新： 選。若要保留所有現有的資產連結，請將此字段設定或保留空白。如果您設定此欄位，則會取代先前連結至此廣告的任何標題。如果您指定此欄位，則需要 3-15 個標題的清單。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
刪除： 唯讀

assetPerformanceLabel

這可讓您知道資產的執行效能。

當 assetPerformanceLabel 您下載回應式搜尋廣告時，屬性是唯讀的。下表說明可能的值。

值	描述
低	此資產的效能很低，建議您取代此資產以改善廣告效能。
良好	此資產的效能良好。建議您保留此資產並新增更多資產，以改善您的廣告效能。
最佳	此資產的效能是最佳的其中之一，建議您新增更類似的資產。
未分級	此資產沒有任何效能評等。這可能是因為資產處於非作用中狀態、沒有足夠的資訊來判斷其效能，或是沒有足夠的類似資產可與其進行比較。
學習	正在主動評估資產的效能。評估完成後，資產評等會是低、良好、最佳或未分級。

編輯狀態

當 editorialStatus 您下載回應式搜尋廣告時，屬性是唯讀字串。下表說明可能的值。

值	描述
作用中	資產通過編輯檢閱。
ActiveLimited	資產已在一或多個市場中通過編輯檢閱，而資產的一或多個元素正在另一個市場中進行編輯檢閱。例如，資產已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對	資產失敗的編輯檢閱。
非作用中	資產的一或多個元素正在進行編輯檢閱。
Unknown	保留供日後使用。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

文字

每個標題的 text 屬性至少必須包含一個字。每個標題 text 屬性的最大輸入長度為 30 個字元。對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 15 個字元。雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

屬性 text 不能包含換行符 (\n) 字元。

識別碼

系統產生的資產群組標識碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

影像

建立具有不同大小和外觀比例的多個影像資產，以便在各種發行者和位置之間靈活顯示。

您必須提供至少 1 個 LandscapeImageMedia 和 1 個 SquareImageMedia。最多可以儲存 20 個影像和最多 5 個標誌。

影像資產會在大量檔案中以 JSON 字串表示。下列範例 JSON 包含九個影像，而且只會裁剪 LandscapeImageMedia subType 。 id是資產的屬性，而cropHeight、cropWidthcropX、、 cropY和 subType 是資產連結的屬性，也就是資產與廣告之間的關聯性。如需詳細資訊，請參閱下方的 cropHeight、 cropWidth、 cropX、 cropY、 id和 subType 。

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

注意事項

在逗號分隔的大量檔案中，您必須用一組額外的雙引號括住資產連結清單、每個屬性索引鍵，以及每個屬性字串值，例如上述 JSON 字串會寫成 “[{”“id”“：1234567890000，”“subType”“：”“LandscapeImageMedia”“}，{”“id”“：1234567890000，”“subType”“：”“SquareImageMedia”“，”“cropX”“：286，”“cropY”“：0，”“cropWidth”“：628，”“cropHeight”“：628}，{”“id”“：1234567890000，“”subType“”：“”LandscapeLogoMedia“”，“”cropX“”：70，“”cropY“”：0，“”cropWidth“”：200，“”cropHeight“”：50}，{“”id“”：1234567890000，“”subType“”：“”SquareLogoMedia“”，“”cropX“”：308，“”cropY“”：0，“”cropWidth“”：120，“”cropHeight“”：120}，{“id”“：1234567890000，”“subType”“：”“ImageMedia15X10”“，”“cropX”“”：129，“”cropY“”：0，“”cropWidth“”：942，“”cropHeight“”：628}，{“” “id”：1234567890000，“”subType“”：“”ImageMedia133X100“”，“”cropX“”：183，“”cropY“”：0，“”cropWidth“”：835，“”cropHeight“”：628}，{“id”“：1234567890000，”“subType”“：”“ImageMedia178X100”“，”“cropX”“：41，”“cropY”“：0，”“cropWidth”：1118，“”cropHeight“”：628}，{“”id“”：1234567890000，“”subType“”：“”ImageMedia1X2“”，“”cropX“：41，”“cropY”“：0，”“cropWidth”“：500，”“cropHeight”“：1000}，{”“id”“：1234567890000，”“subType”“”：“：” “ImageMedia4X1”“，”“cropX”“：60，”“cropY”“：0，”“cropWidth”“：1000，”“cropHeight”“：250}]”。

添加： 如果其父活動未與市集相關聯，則為必要，如果父活動與市集相關聯，則為選擇性。如果父活動與商店相關聯，而且您指定了 Images，您也必須指定標題、LongHeadlines 和 Descriptions。每個資產連結只需要 id 和 subType 。
更新： 選。若要保留所有現有的資產連結，請將此字段設定或保留空白。如果您設定此欄位，則會取代先前連結至此廣告的任何影像。如果您設定此欄位，則每個資產連結只需要 id 和 subType 。
刪除： 唯讀

cropHeight

要從影像資產來源使用的像素數目，從cropY位置開始向上移動。

cropWidth

要從影像資產來源使用的像素數目，從cropX位置開始，然後向右移動。

cropX

從影像資產來源的左下角開始，這是套用 cropWidth 之前要略過 X 軸右側的像素數目。

cropY

從影像資產來源的左下角開始，這是套用 cropHeight 之前，要在 Y 軸上向上略過的像素數目。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

相同的影像資產標識碼可以在相同廣告中多次用於不同的外觀比例，也可以由相同 Microsoft Advertising 帳戶中的多個廣告使用。您可以透過影像大量錄製來建立回應式廣告的影像。然後，您可以使用傳回的媒體標識碼作為映像資產標識碼。您新增的影像外觀比例必須支援映像資產 subType。

亞

屬性 subType 代表此映像資產的外觀比例。

儲存在帳戶層級媒體櫃中影像的實際外觀比例可能會有所不同，只要產生的維度導致每個子類型的預期外觀比例即可。

可能的子類型值包括 LandscapeImageMedia、SquareImageMedia、LandscapeLogoMedia、SquareLogoMedia、ImageMedia15X10、ImageMedia133X100、ImageMedia178X100、ImageMedia1X2 和 ImageMedia4X1。未來可能會新增新的子類型，因此您不應該對一組固定的值採取任何相依性。

子類型	外觀比例	以像素為單位的最小維度
LandscapeImageMedia	1.91:1	703 寬度 x 368 高度
SquareImageMedia	1:1	300 寬度 x 300 高度
LandscapeLogoMedia	4:1	160 寬度 x 40 高度
SquareLogoMedia	1:1	40 寬度 x 40 高度
ImageMedia15x10	1.5:1	300 寬度 x 200 高度
ImageMedia133x100	1.33:1	100 寬度 x 75 高度
ImageMedia178x100	1.78:1	624 寬度 x 350 高度
ImageMedia1x2	1:2	470 寬度 x 940 高度
ImageMedia4x1	4:1	608 寬度 x 152 高度

長標題

Bing 可用來優化廣告版面配置的長標題清單。

為了將所有廣告格式的效能最大化，長標題不一定會顯示在您的廣告中。

從數據模型的觀點來看，長標題會儲存為文字資產。多個廣告可以使用相同的資產。例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。

您必須設定 1-5 個長的標題。長標題會在大量檔案中以 JSON 字串表示。下列範例 JSON 包含兩個長標題。和 idtext 是資產的屬性，而 editorialStatus 和 assetPerformanceLabel 是資產鏈接的屬性，也就是資產與廣告之間的關聯性。如需詳細資訊，請參閱下方的 assetPerformanceLabel、編輯狀態、標識碼和文字。

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

注意事項

以下是大量下載範例，您也會在其中取得唯讀屬性， id 例如和 editorialStatus：

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加： 如果其父活動未與市集相關聯，則為必要，如果父活動與市集相關聯，則為選擇性。如果父活動與商店相關聯，而且您指定 LongHeadlines，您也必須指定標題、描述和影像。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
更新： 選。若要保留所有現有的資產連結，請將此字段設定或保留空白。如果您設定此欄位，則會取代先前連結至此廣告的任何標題。如果您指定此欄位，則需要 1-5 個標題的清單。只接受文字。即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
刪除： 唯讀

assetPerformanceLabel

這可讓您知道資產的執行效能。

當 assetPerformanceLabel 您下載回應式搜尋廣告時，屬性是唯讀的。下表說明可能的值。

值	描述
低	此資產的效能很低，建議您取代此資產以改善廣告效能。
良好	此資產的效能良好。建議您保留此資產並新增更多資產，以改善您的廣告效能。
最佳	此資產的效能是最佳的其中之一，建議您新增更類似的資產。
未分級	此資產沒有任何效能評等。這可能是因為資產處於非作用中狀態、沒有足夠的資訊來判斷其效能，或是沒有足夠的類似資產可與其進行比較。
學習	正在主動評估資產的效能。評估完成後，資產評等會是低、良好、最佳或未分級。

編輯狀態

當 editorialStatus 您下載回應式搜尋廣告時，屬性是唯讀字串。下表說明可能的值。

值	描述
作用中	資產通過編輯檢閱。
ActiveLimited	資產已在一或多個市場中通過編輯檢閱，而資產的一或多個元素正在另一個市場中進行編輯檢閱。例如，資產已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對	資產失敗的編輯檢閱。
非作用中	資產的一或多個元素正在進行編輯檢閱。
Unknown	保留供日後使用。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

文字

每個長標題的 text 屬性至少必須包含一個字。每個標題 text 屬性的最大輸入長度為90個字元。對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 45 個字元。雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

屬性 text 不能包含換行符 (\n) 字元。

行動裝置最終 URL

行動登陸頁面 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。此服務最多可允許 10 個，以取得潛在的向前相容性。
每個 URL 都會以分號和空格分隔 (」;“) 。
僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。
每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。
如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

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

修改時間

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

注意事項

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

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

父項識別碼

包含資產群組之營銷活動的系統產生標識碼。

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

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

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

路徑 1

選擇性路徑的第一個部分，將附加至顯示URL的網域部分。顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 [最終 URL] ([ 最終 URL ] 字段) 的網域產生。然後，如果您已指定 Path 1 的值，它會附加至顯示URL。如果您也指定 了 Path 2 的值，則它也會附加至 Path 1 之後的顯示 URL。例如，如果您 的最終 URL 包含 https://www.contoso.com， 則路徑 1 設為 subdirectory1，而 Path 2 設為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

路徑可以包含動態參數，例如 {MatchType}。如需支持的參數清單，請參閱 Microsoft Advertising 說明文章我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。不能輸入超過15個最終 (不是動態文字) 字元。如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用預設文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為1,000個字元。不能輸入超過 7 個最終 (不是動態文字) 字元。如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用預設文字。雙寬字元取決於您使用的字元，而不是營銷活動或資產群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

路徑不能包含正斜線 (/) 或換行符 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

路徑 2

選擇性路徑的第二個部分，將附加至顯示URL的網域部分。顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 [最終 URL] ([ 最終 URL ] 字段) 的網域產生。然後，如果您已指定 Path 1 的值，它會附加至顯示URL。如果您也指定 了 Path 2 的值，則它也會附加至 Path 1 之後的顯示 URL。例如，如果您 的最終 URL 包含 https://www.contoso.com， 則路徑 1 設為 subdirectory1，而 Path 2 設為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

如果也已設定路徑 1，您只能指定 Path 2。

路徑可以包含動態參數，例如 {MatchType}。如需支持的參數清單，請參閱 Microsoft Advertising 說明文章我可以使用哪些追蹤或 URL 參數？。

路徑不能包含正斜線 (/) 或換行符 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

狀態

資產群組的狀態。

可能的值為 Active、 Deleted、 Expired 或 Paused。 [ 過期 ] 狀態是唯讀狀態。

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

開始日期

資產群組可以開始提供服務的日期;否則，服務可以在資產群組變成作用中的日期開始為資產群組提供服務。

開始日期包含在內。例如，如果您將 [開始日期 ] 設定為 5/5/2020，資產群組會在 2020 年 5 月 5 日上午 12：00 開始。時間是以您在營銷活動層級指定的時區為基礎。

添加： 選。如果您未設定此欄位，或您提交的日期是今天日期之前，則會設定今天的日期，而且只要資產群組狀態為作用中，服務就可以開始為資產群組提供服務。
更新： 選。如果未設定更新的值，則此設定不會變更。提交資產群組之後，也就是開始日期到達之後，就無法更新開始日期。
刪除： 唯讀

共用方式為

資產群組記錄 - 大量

資產群組

商務名稱

呼叫動作

行銷活動

用戶端識別碼

描述

assetPerformanceLabel

編輯狀態

id

文字

編輯訴求狀態

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

結束日期

最終 URL

標題

assetPerformanceLabel

編輯狀態

id

文字

識別碼

影像

cropHeight

cropWidth

cropX

cropY

id

亞

長標題

assetPerformanceLabel

編輯狀態

id

文字

行動裝置最終 URL

修改時間

父項識別碼

路徑 1

路徑 2

狀態

開始日期

意見反應

其他資源