Objeto de datos ImageAsset: Administración de campañas

Artículo
11/13/2024

Aplica la configuración de recorte a los medios de imagen almacenados para una relación de aspecto específica.

Nota:

Todavía no todos tienen esta característica. Si no lo haces, no te preocupes. Se acerca pronto.

Si no especifica la configuración de recorte, el servicio recortará automáticamente hasta el área máxima posible desde el centro de la imagen. Por ejemplo, dada una imagen de 1000 x 1000 píxeles, para la relación de aspecto 1.91:1, la configuración de recorte automático será CropWidth=1000, CropHeight=524, CropX=0 y CropY=238.

XML
JSON

<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>

{
  "Id": "LongValueHere",
  "Name": "ValueHere",
  "Type": "ImageAsset",
  "CropHeight": IntValueHere,
  "CropWidth": IntValueHere,
  "CropX": IntValueHere,
  "CropY": IntValueHere,
  "SubType": "ValueHere",
  "TargetHeight": IntValueHere,
  "TargetWidth": IntValueHere
}

Elementos

El objeto ImageAsset tiene los siguientes elementos: CropHeight, CropWidth, CropX, CropY, SubType, TargetHeight, TargetWidth.

Elemento	Descripción	Tipo de datos
CropHeight	Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición CropY y moviéndose hacia arriba. Agregar: Opcional. Si no establece este elemento, el servicio recortará automáticamente según la relación de aspecto del SubType. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	int
CropWidth	Número de píxeles que se van a usar desde el origen del recurso de imagen, empezando por la posición CropX y moviéndose a la derecha. Agregar: Opcional. Si no establece este elemento, el servicio recortará automáticamente según la relación de aspecto del SubType. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	int
CropX	A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se van a ir a la derecha en el eje X antes de aplicar CropWidth. Agregar: Opcional. Si no establece este elemento, el servicio recortará automáticamente según la relación de aspecto del SubType. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	int
CropY	A partir de la esquina inferior izquierda del origen del recurso de imagen, este es el número de píxeles que se omitirán hacia arriba en el eje Y antes de aplicar CropHeight. Agregar: Opcional. Si no establece este elemento, el servicio recortará automáticamente según la relación de aspecto del SubType. Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	int
SubType	Representa la relación de aspecto de este recurso de imagen. La relación de aspecto del subtipo debe coincidir con las dimensiones efectivas del recurso de imagen. Si no se usan CropHeight y CropWidth , la relación de aspecto del subtipo debe coincidir con la relación de aspecto del medio de imagen almacenado. Si se usan CropHeight y CropWidth , la verdadera relación de aspecto de los medios almacenados en la biblioteca multimedia de nivel de cuenta puede diferir, siempre y cuando CropHeight y CropWidth resulten en la relación de aspecto correcta. En cualquier caso, la verdadera relación de aspecto del medio almacenado en la biblioteca multimedia de nivel de cuenta permanecerá sin cambios. El subtipo debe establecerse en "Logo" si la imagen está asociada a un anuncio como "LandscapeLogoMedia" o "SquareLogoMedia". Los posibles valores de subtipo son OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100, ImageMedia153X100. Para obtener más información, consulte Comentarios de ResponsiveAd. Nota: A partir de ahora, SubType OriginalImage reemplaza el rol de LandscapeImageMedia como imagen predeterminada para ResponsiveAd of Audience Campaign. Es posible que en el futuro se agreguen nuevos subtipos, por lo que no debe tomar ninguna dependencia de un conjunto fijo de valores. Agregar: Obligatorio Actualizar: Solo lectura. No se puede actualizar el subtipo durante la actualización.	string
TargetHeight	Dimensión de alto de destino de un recurso de imagen.	int
TargetWidth	Dimensión de ancho de destino de un recurso de imagen.	int

El objeto ImageAsset tiene elementos heredados.

Elementos heredados

Elementos heredados del recurso

El objeto ImageAsset deriva del objeto Asset y hereda los siguientes elementos: Id, Name, Type. Las descripciones siguientes son específicas de ImageAsset y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Asset .

Elemento	Descripción	Tipo de datos
Identificación	Identificador único de Microsoft Advertising para el recurso en una cuenta de Microsoft Advertising. El mismo identificador de recurso de imagen se puede usar varias veces en el mismo anuncio para diferentes relaciones de aspecto, y también puede ser utilizado por varios anuncios en la misma cuenta de Microsoft Advertising. El identificador del recurso de imagen con SubType establecido en LandscapeImageMedia se usa para todos los subtipos de recursos de imagen generados automáticamente dentro del mismo anuncio. Independientemente de si permite que Microsoft Advertising genere automáticamente las imágenes recortadas, el identificador no tiene que ser único entre los recursos de imagen vinculados al mismo anuncio. Puede crear medios para anuncios con capacidad de respuesta a través de la operación del servicio AddMedia . A continuación, puede usar el identificador multimedia devuelto como identificador de recurso de imagen. La relación de aspecto de la imagen que agregó debe ser compatible con el recurso de imagen SubType. Agregar: Obligatorio Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	largo
Nombre	Reservado para uso futuro. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.	string
Tipo	Tipo del recurso. Este valor es ImageAsset cuando se recupera un recurso de imagen. Para obtener más información sobre los tipos de recursos, consulte los comentarios sobre objetos de datos de activos. Agregar: Solo lectura Actualizar: Solo lectura	string

Requisitos

Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

VideoAsset

Compartir a través de