次の方法で共有

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" として関連付けられている場合は、サブタイプを "ロゴ" に設定する必要があります。

指定できるサブタイプの値には、OriginalImage、LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia124X100、ImageMedia153X100 などがあります。 詳細については、「 レスポンシブアド解説」を参照してください。

注: 現時点では、SubType OriginalImage は、LandscapeImageMedia の役割を、対象ユーザー キャンペーンのレスポンシブアドの既定のイメージとして置き換えます。

新しいサブタイプは将来追加される可能性があるため、固定値セットに依存しないようにしてください。

足す： 必須
更新： 読み取り専用。 更新中にサブタイプを更新することはできません。		 string
TargetHeight イメージ アセットのターゲットの高さ寸法。 int
TargetWidth イメージ アセットのターゲット幅ディメンション。 int

ImageAsset オブジェクトには継承された要素があります。

継承された要素

アセットから継承された要素

ImageAsset オブジェクトは Asset オブジェクトから派生し、Id、Name、Type の各要素を継承します。 以下の説明は ImageAsset に固有であり、 Asset オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
身分証明書 Microsoft Advertising アカウントの資産の一意の Microsoft Advertising 識別子。

同じ画像アセット識別子は、異なる縦横比で同じ広告で複数回使用でき、同じ Microsoft Advertising アカウント内の複数の広告で使用することもできます。 SubType が LandscapeImageMedia に設定されている画像アセットの識別子は、同じ広告内のすべての自動生成された画像アセット のサブタイプに使用されます。 Microsoft Advertising でトリミングされた画像を自動的に生成させるかどうかにかかわらず、 ID は 、同じ広告にリンクされている画像アセットの中で一意である必要はありません。

AddMedia サービス操作を使用して、レスポンシブ広告用のメディアを作成できます。 その後、返されたメディア識別子をイメージ資産 ID として使用できます。 追加したイメージの縦横比は、イメージ アセット SubType でサポートされている必要があります。

足す： 必須
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 long
名前 将来使用するために予約されています。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 string
種類 資産の種類。 この値は、イメージ資産を取得するときの ImageAsset です。 資産の種類の詳細については、 資産データ オブジェクトの備考に関するページを参照してください。

足す： 読み取り専用
更新： 読み取り専用		 string

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

使用ページ

VideoAsset