共用方式為

AssetGroup 資料物件 - 行銷活動管理

  • 發行項

在廣告活動中定義資產群組。

語法

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssetGroupSearchThemes" nillable="true" type="tns:ArrayOfAssetGroupSearchTheme">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

元素

AssetGroup 物件具有下列元素：AssetGroupSearchThemes、BusinessName、CallToAction、Descriptions、ApprovalStatus、EndDate、FinalMobileUrls、FinalUrls、ForwardCompatibilityMap、Heads、Id、Images、LongHeadlines、Name、Path1、Path2、StartDate、Status。

元素 描述 資料類型
AssetGroupSearchThemes 保留。 AssetGroupSearchTheme 陣列
BusinessName 企業名稱。

您的公司名稱可能會出現在您的廣告中，視廣告位置而定。

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

加： 必填。 如果未提供 ，且父活動會與商店產生關聯，則會使用商店名稱作為商務名稱。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
CallToAction 讓客戶立即按下您廣告的簡短、吋笛原因。

這會顯示在您對動作的呼叫按鈕上。

加： 必填。 如果未提供 ，且父活動與商店相關聯，則預設為 LearnMore。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 CallToAction
描述 廣告路徑下方顯示的描述。

您必須設定 2-5 個描述。 每個描述的文字至少必須包含一個字。 Text 不能包含換行符 (\n) 字元。

如果父活動與商店相關聯，而且您指定了 [描述]，您也必須指定 [標題]、[長標題] 和 [影像]。

新增：如果父活動與商店產生關聯，則為選擇性，如果其父活動未與市集相關聯，則為必要專案。
更新：選擇性。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素的值，將會取代先前連結至此資產群組的任何描述。 如果父活動與存放區產生關聯，而且您將此元素設定為空白清單，則會刪除先前的設定。		 AssetLink 陣 列
編輯狀態 資產群組的編輯檢閱狀態，指出資產群組是否擱置檢閱、已核准或已取消核准。

新增：只讀
更新：只讀		 AssetGroupEditorialStatus
EndDate 資產群組到期的日期。

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

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

新增：選擇性。 若要在新增資產群組時未設定結束日期，請將此元素設定為 null。
更新：選擇性。 如果未設定更新的值，則此設定不會變更。 若要刪除現有的結束日期設定，並在更新資產群組時有效設定結束日期，請將結束日期設定為等於或晚於 2050 年 1 月 2 日。 當您下次擷取資產群組時，此元素將會是 nil，也就是不會設定為 2050 年 1 月 2 日。		 Date
FinalMobileUrls 行動登陸頁面 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和 FinalMobileUrls 指定最多 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。

新增：選擇性
更新：選擇性		 字串陣列
FinalUrls 登陸頁面 URL。

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

下列驗證規則適用於最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和 FinalMobileUrls 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。

針對零售活動，最終 URL 必須符合與行銷活動相關聯之商店的網域。

新增：必要。 如果未提供 ，且父活動與存放區相關聯，則會使用市集 URL 作為最終 URL。
更新：選擇性		 字串陣列
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 陣 列
標題 標題是您廣告中顯示的最醒目提示文字，因此您應該充分利用可用的字元。 我們需要多個標題，廣告才能在各種發行者和位置之間靈活顯示。

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

您必須設定 3-15 個標題。 每個標題的文字至少必須包含一個字。

Text 不能包含換行符 (\n) 字元。

如果父活動與商店相關聯，而且您指定了標題，您也必須指定 LongHeadlines、Descriptions 和 Images。

新增：如果其父活動與市集相關聯，則為選擇性，如果其父活動未與市集相關聯，則為必要專案。
更新：選擇性。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素的值，將會取代先前連結至此資產群組的任何標題。 如果父活動與存放區產生關聯，而且您將此元素設定為空白清單，則會刪除先前的設定。		 AssetLink 陣 列
識別碼 系統產生的資產群組標識碼。

新增：只讀
更新：只讀		 長
影像 具有不同大小和外觀比例的影像資產，以便在各種發行者和位置之間靈活顯示。

包含一或多個 AssetLink 物件，其中每個物件都包含具有 SubType 的 ImageAsset，以及符合所需外觀比例的裁剪設定。

ImageAsset 包含 CropHeight、CropWidth、CropX、CropY 和 SubType 字段。

可能的子類型值包括 LandscapeImageMedia、SquareImageMedia、LandscapeLogoMedia、SquareLogoMedia、ImageMedia15X10、ImageMedia133X100、ImageMedia178X100、ImageMedia1X2 和 ImageMedia4X1。

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

如果父活動與商店相關聯，而且您指定了 Images，您也必須指定標題、LongHeadlines 和 Descriptions。

新增：如果父活動與商店產生關聯，則為選擇性，如果其父活動未與市集相關聯，則為必要專案。
更新：選擇性。 如果未設定更新的值，則此設定不會變更。 如果您在更新期間包含映像，將會取代任何先前設定的映像。 如果父活動與存放區產生關聯，而且您將此元素設定為空白清單，則會刪除先前的設定。		 AssetLink 陣 列
LongHeadlines 您必須設定 1-5 個長的標題。 每個標題的文字至少必須包含一個字。 Text 不能包含換行符 (\n) 字元。

如果父活動與商店相關聯，而且您指定 LongHeadlines，您也必須指定標題、描述和影像。

新增：如果父活動與商店產生關聯，則為選擇性，如果其父活動未與市集相關聯，則為必要專案。
更新：選擇性。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素的值，將會取代先前連結至此資產群組的任何標題。 如果父活動與存放區產生關聯，而且您將此元素設定為空白清單，則會刪除先前的設定。		 AssetLink 陣 列
名稱 資產群組的名稱。 名稱在營銷活動中應該是唯一的，而且會區分大小寫。 長度不能超過 256 個字元。

新增：必要
更新：選擇性		 string
Path1 選擇性路徑的第一個部分，將附加至顯示URL的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定Path1的值，它會附加至顯示URL。 如果您也指定Path2的值，則它也會附加至Path1之後的顯示URL。 例如，如果您的 FinalUrls 包含 https://www.contoso.com、Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

輸入的字元數不能超過15個字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，廣告將無法顯示。

對於具有雙寬字元的語言，例如，輸入繁體中文不能超過 7 個最終字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，廣告將無法顯示。 雙寬字元取決於您使用的字元，而不是營銷活動語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

新增：選擇性
更新：選擇性		 string
Path2 選擇性路徑的第二個部分，將附加至顯示URL的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定Path1的值，它會附加至顯示URL。 如果您也指定Path2的值，則它也會附加至Path1之後的顯示URL。 例如，如果您的 FinalUrls 包含 https://www.contoso.com、Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

如果也已設定 Path1，您只能指定 Path2。

輸入的字元數不能超過15個字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，廣告將無法顯示。

對於具有雙寬字元的語言，例如，輸入繁體中文不能超過 7 個最終字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，廣告將無法顯示。 雙寬字元取決於您使用的字元，而不是營銷活動語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

新增：選擇性
更新：選擇性		 string
StartDate 資產群組可以開始提供服務的日期;否則，服務可以在資產群組變成作用中的當天開始提供廣告。

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

新增：選擇性。 如果您未設定開始日期，則預設為今天的日期，而且服務可以在資產群組狀態為作用中時立即開始提供廣告。
更新：選擇性。 如果未設定更新的值，則此設定不會變更。 提交資產群組之後，也就是開始日期到達之後，就無法更新開始日期。		 Date
地位 資產群組的狀態。 可能的值為 [作用中]、[ 已過期] 和 [已暫停]。 [ 過期 ] 狀態是唯讀狀態。

新增：選擇性。 預設值為 Paused。
更新：選擇性		 AssetGroupStatus

需求

服務： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups