ImageAsset Data Object - Gestão de Campanhas

2024-11-13

Aplica as definições de recorte ao suporte de dados de imagem armazenado para uma proporção específica.

Nota

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.

Se não especificar as definições de recorte, o serviço irá recortar automaticamente para a área máxima possível a partir do centro da imagem. Por exemplo, com uma imagem de 1000x1000 píxeis, para a proporção de 1,91:1, a definição de recorte automático será CropWidth=1000, CropHeight=524, CropX=0 e 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>

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

Elementos

O objeto ImageAsset tem os seguintes elementos: CropHeight, CropWidth, CropX, CropY, SubType, TargetHeight, TargetWidth.

Elemento	Descrição	Tipo de Dados
CropHeight	O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição CropY e movendo-se para cima. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	int
CropWidth	O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição CropX e movendo-se para a direita. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	int
CropX	A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a ignorar para a direita no eixo x antes de aplicar a CropWidth. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	int
Recortar	A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a saltar para cima no eixo y antes de aplicar o CropHeight. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	int
Subtipo	Representa a proporção para este recurso de imagem. A proporção do sub-tipo tem de corresponder às dimensões efetivas do recurso de imagem. Se CropHeight e CropWidth não forem utilizados, a proporção do subtipo tem de corresponder à proporção do suporte de dados de imagem armazenado. Se CropHeight e CropWidth forem utilizados, a verdadeira proporção do suporte de dados armazenado na biblioteca de multimédia ao nível da conta pode ser diferente, desde que CropHeight e CropWidth resultem na proporção correta. Em ambos os casos, a verdadeira proporção do suporte de dados armazenado na biblioteca de multimédia ao nível da conta permanecerá inalterada. O subtipo tem de ser definido como "Logótipo" se a imagem estiver associada a um anúncio como "LandscapeLogoMedia" ou "SquareLogoMedia". Os valores de subtipo possíveis incluem OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100, ImageMedia153X100. Para obter mais detalhes, veja Comentários ResponsiveAd. Nota: a partir de agora, SubType OriginalImage substitui a função landscapeImageMedia como a imagem predefinida para ResponsiveAd of Audience Campaign. Poderão ser adicionados novos subtipos no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores. Adicionar: Necessário Atualização: Só de leitura. Não é possível atualizar o subtipo durante a atualização.	cadeia
TargetHeight	A dimensão de altura de destino de um recurso de imagem.	int
TargetWidth	A dimensão de largura de destino de um recurso de imagem.	int

O objeto ImageAsset tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Recurso

O objeto ImageAsset deriva do objeto Asset e herda os seguintes elementos: ID, Nome, Tipo. As descrições abaixo são específicas de ImageAsset e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Asset .

Elemento	Descrição	Tipo de Dados
ID	O identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising. O mesmo identificador de recurso de imagem pode ser utilizado várias vezes no mesmo anúncio para diferentes proporções e também pode ser utilizado por vários anúncios na mesma conta microsoft Advertising. O identificador do recurso de imagem com SubType definido como LandscapeImageMedia é utilizado para todos os subtipos de recursos de imagem gerados automaticamente no mesmo anúncio. Quer permita ou não que o Microsoft Advertising gere automaticamente as imagens recortadas, o ID não tem de ser exclusivo entre os recursos de imagem associados ao mesmo anúncio. Pode criar suportes de dados para anúncios reativos através da operação do serviço AddMedia . Em seguida, pode utilizar o identificador de multimédia devolvido como o ID do recurso de imagem. A proporção da imagem que adicionou tem de ser suportada para o Subtipo do recurso de imagem. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo
Nome	Reservado para utilização futura. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	cadeia
Tipo	O tipo do elemento. Este valor é ImageAsset quando obtém um recurso de imagem. Para obter mais informações sobre tipos de recursos, veja Observações de Objetos de Dados de Recurso. Adicionar: Só de leitura Atualização: Só de leitura	cadeia

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Utilizado Por

VideoAsset