Objet de données ImageAsset - Gestion des campagnes
Applique les paramètres de rognage aux supports d’image stockés pour un proportion spécifique.
Remarque
Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas. Il sera bientôt disponible.
Si vous ne spécifiez pas de paramètres de rognage, le service rogne automatiquement à la zone maximale possible à partir du centre de l’image. Par exemple, avec une image de 1000 x 1000 pixels, pour les proportions 1,91:1, le paramètre de rognage automatique sera CropWidth=1000, CropHeight=524, CropX=0 et CropY=238.
Syntaxe
<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>
Éléments
L’objet ImageAsset contient les éléments suivants : CropHeight, CropWidth, CropX, CropY, SubType, TargetHeight, TargetWidth.
| Élément | Description | Type de données |
|---|---|---|
| CropHeight | Nombre de pixels à utiliser à partir de la source de la ressource d’image, en commençant à la position Rognage et en se déplaçant vers le haut. Ajouter: Optionnel. Si vous ne définissez pas cet élément, le service rogne automatiquement en fonction des proportions du SubType. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
int |
| CropWidth | Nombre de pixels à utiliser à partir de la source de la ressource d’image, en commençant à la position CropX et en se déplaçant vers la droite. Ajouter: Optionnel. Si vous ne définissez pas cet élément, le service rogne automatiquement en fonction des proportions du SubType. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
int |
| CropX | À partir du coin inférieur gauche de la source de ressource d’image, il s’agit du nombre de pixels à ignorer à droite sur l’axe X avant d’appliquer cropwidth. Ajouter: Optionnel. Si vous ne définissez pas cet élément, le service rogne automatiquement en fonction des proportions du SubType. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
int |
| Rognage | À partir du coin inférieur gauche de la source de ressource d’image, il s’agit du nombre de pixels à ignorer vers le haut sur l’axe des y avant d’appliquer cropheight. Ajouter: Optionnel. Si vous ne définissez pas cet élément, le service rogne automatiquement en fonction des proportions du SubType. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
int |
| SubType | Représente les proportions de cette ressource d’image. Les proportions du sous-type doivent correspondre aux dimensions effectives de la ressource d’image. Si CropHeight et CropWidth ne sont pas utilisés, les proportions du sous-type doivent correspondre aux proportions du support d’image stocké. Si CropHeight et CropWidth sont utilisés, les proportions vraies du support stocké dans la bibliothèque multimédia au niveau du compte peuvent différer, à condition que CropHeight et CropWidth aboutissent à des proportions correctes. Dans les deux cas, les proportions exactes du média stocké dans la bibliothèque multimédia au niveau du compte resteront inchangées. Le sous-type doit être défini sur « Logo » si l’image est associée à une annonce en tant que « LandscapeLogoMedia » ou « SquareLogoMedia ». Les valeurs de sous-type possibles sont OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100, ImageMedia153X100. Pour plus d’informations, consultez ResponsiveAd Remarques. Remarque : Jusqu’à présent, SubType OriginalImage remplace le rôle de LandscapeImageMedia en tant qu’image par défaut pour ResponsiveAd de la campagne d’audience. De nouveaux sous-types peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs. Ajouter: Obligatoire Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour le sous-type pendant la mise à jour. |
chaîne |
| TargetHeight | Dimension de hauteur cible d’une ressource d’image. | int |
| TargetWidth | Dimension de largeur cible d’une ressource d’image. | int |
L’objet ImageAsset a des éléments hérités.
Éléments hérités
Éléments hérités de l’élément multimédia
L’objet ImageAsset dérive de l’objet Asset et hérite des éléments suivants : Id, Name, Type. Les descriptions ci-dessous sont spécifiques à ImageAsset et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Asset .
| Élément | Description | Type de données |
|---|---|---|
| Id | Identificateur Microsoft Advertising unique pour la ressource dans un compte Microsoft Advertising. Le même identificateur de ressource d’image peut être utilisé plusieurs fois dans la même annonce pour différents proportions, et peut également être utilisé par plusieurs annonces dans le même compte Microsoft Advertising. L’identificateur de la ressource d’image avec SubType défini sur LandscapeImageMedia est utilisé pour tous les sous-types de ressources d’image générés automatiquement dans la même annonce. Que vous laissons ou non Microsoft Advertising générer automatiquement les images rognées, l’ID n’a pas besoin d’être unique parmi les ressources d’image liées à la même annonce. Vous pouvez créer des médias pour les publicités réactives via l’opération de service AddMedia . Vous pouvez ensuite utiliser l’identificateur de média retourné comme ID de ressource d’image. Les proportions de l’image que vous avez ajoutée doivent être prises en charge pour la ressource d’image SubType. Ajouter: Obligatoire Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
long |
| Nom | Réservé à une utilisation future. Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. |
chaîne |
| Type | Type de la ressource. Cette valeur est ImageAsset lorsque vous récupérez une ressource d’image. Pour plus d’informations sur les types de ressources, consultez les remarques relatives aux objets de données de ressources. Ajouter: En lecture seule Mettre à jour: En lecture seule |
chaîne |
Configuration requise
Service : CampaignManagementService.svc v13
Espace de noms: https://bingads.microsoft.com/CampaignManagement/v13