共用方式為

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

  • 發行項

針對特定的外觀比例，將裁剪設定套用至預存的影像媒體。

注意事項

並非每個人都有這項功能。 如果沒有，別擔心。 即將推出。

如果您未指定裁剪設定，服務會自動從影像中心向上裁剪到可能的最大區域。 例如，假設 1000x1000 像素 影像的 1.91：1 外觀比例，自動裁剪設定會是 CropWidth=1000、 CropHeight=524、 CropX=0 和 CropY=238。

語法

<xs:complexType name="ImageAsset" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Asset">
      <xs:sequence>
        <xs:element minOccurs="0" name="CropHeight" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropWidth" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropX" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="CropY" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TargetHeight" nillable="true" type="xs:int">
          <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="TargetWidth" nillable="true" type="xs:int">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ImageAsset 物件具有下列元素：CropHeight、CropWidth、CropX、CropY、SubType、TargetHeight、TargetWidth。

元素 描述 資料類型
CropHeight 要從影像資產來源使用的像素數目，從 CropY 位置開始向上移動。

加： 自選。 如果您未設定此元素，服務會根據 SubType 的外觀比例自動裁剪。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 int
CropWidth 要從影像資產來源使用的像素數目，從 CropX 位置開始向右移動。

加： 自選。 如果您未設定此元素，服務會根據 SubType 的外觀比例自動裁剪。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 int
CropX 從影像資產來源的左下角開始，這是套用 CropWidth 之前要略過 X 軸右側的像素數目。

加： 自選。 如果您未設定此元素，服務會根據 SubType 的外觀比例自動裁剪。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 int
CropY 從影像資產來源的左下角開始，這是套用 CropHeight 之前，要在 Y 軸上向上略過的像素數目。

加： 自選。 如果您未設定此元素，服務會根據 SubType 的外觀比例自動裁剪。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 int
SubType 表示此映像資產的外觀比例。

子類型的外觀比例必須符合有效的影像資產維度。 如果未使用 CropHeight 和 CropWidth ，則子類型的外觀比例必須符合預存影像媒體的外觀比例。 如果使用 CropHeight 和 CropWidth ，則儲存在帳戶層級媒體櫃中之媒體的實際外觀比例可能會不同，只要 CropHeight 和 CropWidth 產生正確的外觀比例即可。 不論是哪一種情況，儲存在帳戶層級媒體櫃中之媒體的實際外觀比例都會保持不變。

如果影像與廣告關聯為 「LandscapeLogoMedia」 或 「SquareLogoMedia」，則子類型必須設定為 「Logo」。

可能的子類型值包括 OriginalImage、LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia200X100、ImageMedia124X100、ImageMedia153X100。 如需詳細資訊，請 參閱 ResponsiveAd Remarks。

注意：到目前為止，SubType OriginalImage 會取代 LandscapeImageMedia 的角色作為 Audience Campaign 的 ResponsiveAd 的預設影像。

未來可能會新增新的子類型，因此您不應該對一組固定的值採取任何相依性。

加： 必填
更新： 唯讀。 您無法在更新期間更新子類型。		 string
TargetHeight 影像資產的目標高度維度。 int
TargetWidth 影像資產的目標寬度維度。 int

ImageAsset 物件具有 Inherited Elements。

繼承的專案

從資產繼承的元素

ImageAsset 物件衍生自 Asset 物件，並繼承下列元素：Id、Name、Type。 下列描述是 ImageAsset 特有的，而且可能不適用於從 Asset 物件繼承相同元素的其他物件。

元素 描述 資料類型
標識碼 Microsoft Advertising 帳戶中資產的唯一Microsoft Advertising 標識符。

相同的影像資產標識碼可以在相同廣告中多次用於不同的外觀比例，也可以由相同廣告帳戶中的多個廣告使用Microsoft廣告。 將 SubType 設定為 LandscapeImageMedia 的影像資產識別碼會用於相同廣告內所有自動產生的影像資產子類型。 無論您是否讓 Microsoft Advertising 自動產生裁剪的影像，標識 碼在連結 至相同廣告的影像資產中都不需要是唯一的。

您可以透過 AddMedia 服務作業建立響應式廣告的媒體。 然後，您可以使用傳回的媒體標識碼作為映像資產標識碼。 您新增的影像外觀比例必須支援影像資產 SubType。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 長
名稱 保留供日後使用。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
類型 資產的類型。 當您擷取映射資產時，此值為 ImageAsset 。 如需資產類型的詳細資訊，請參閱 資產數據物件備註。

加： 唯讀
更新： 唯讀		 string

需求

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

消費者

VideoAsset