Bilddatenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert ein Bild, das der Medienbibliothek eines Kontos hinzugefügt werden kann.

Syntax

XML
JSON

<xs:complexType name="Image" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Media">
      <xs:sequence>
        <xs:element minOccurs="0" name="Data" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "Id": "LongValueHere",
  "MediaType": "ValueHere",
  "Text": "ValueHere",
  "Type": "Image",
  "Data": "ValueHere"
}

Elemente

Das Image-Objekt verfügt über die folgenden Elemente: Data.

Element	Beschreibung	Datentyp
Daten	Eine base64-Zeichenfolge, die das Bild oder Symbol darstellt, das der Bibliothek hinzugefügt werden soll. Die base64-Zeichenfolge darf maximal 102.400 Zeichen enthalten. Informationen zu Einschränkungen und unterstützten Datentypen finden Sie weiter unten in den Hinweisen .	Zeichenfolge

Das Image-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von Medien

Das Image-Objekt wird vom Media-Objekt abgeleitet und erbt die folgenden Elemente: Id, MediaType, Text, Type. Die folgenden Beschreibungen gelten spezifisch für Image und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Media-Objekt erben.

Element	Beschreibung	Datentyp
Id	Der eindeutige Microsoft Advertising-Bezeichner des Mediums. Hinzufügen: Schreibgeschützt	lang
MediaType	Der Typ des Mediums, das der Bibliothek hinzugefügt werden soll. Der empfohlene Medientyp ist "GenericImage". Für Medien, die mit einem ImageAdExtension verwendet werden, werden genericImage, Image16x9, Image15x10, Image4x3 und Image12x10 unterstützt. Für Medien, die mit einem ResponsiveAd verwendet werden, werden genericImage, Image1x1, Image191x100 und Image4x1 unterstützt. Weitere Informationen zu unterstützten Seitenverhältnissen finden Sie weiter unten im Abschnitt "Hinweise" . Hinzufügen: Erforderlich	Zeichenfolge
Text	Der Alternativtext des Bilds.	Zeichenfolge
Typ	Der Medientyp. Weitere Informationen zu Medientypen finden Sie in den Hinweisen zu Mediendatenobjekten. Hinzufügen: Schreibgeschützt	Zeichenfolge

Hinweise

Der Bildmedientyp gibt das unterstützte Seitenverhältnis des hochgeladenen Bilds an.

Wir empfehlen das "GenericImage" mit Abmessungen von 703 Breite x 368 Höhe oder höher in Pixeln.

Alle unterstützten Untertypwerte mit entsprechenden Dimensions- und Seitenverhältniseinschränkungen werden unten beschrieben.

Untertyp	Seitenverhältnis	Mindestdimension
GenericImage	Variiert	40 Breite x 20 Höhe, in Pixel
Bild 16x9	16:9	640 Breite x 360 Höhe, in Pixel
Bild 15x10	1.5:1	300 Breite x 200 Höhe, in Pixel
Image4x3	4:3	100 Breite x 75 Höhe, in Pixel
Bild 1x1	1:1	128 Breite x 128 Höhe, in Pixel
Bild 191x100	1.91:1	703 Breite x 368 Höhe, in Pixel
Image4x1	4:1	512 Breite x 128 Höhe, in Pixel

Hinweis

Die maximale Breite und Höhe in Pixel beträgt unabhängig voneinander 2592 und 2048, und Sie müssen weiterhin eines der unterstützten Seitenverhältnisse beibehalten. Wenn der Untertyp beispielsweise Image191x100 und die Breite 2592 ist, muss die Höhe 1357 sein.

Bilder mit Animation werden nicht unterstützt. Die folgenden MIME-Typen werden unterstützt.

GIF
JPEG
PNG

Tipp

Die PNG-Bilder werden in JPEG konvertiert. Wenn Sie mit der Qualität nach der Konvertierung nicht zufrieden sind, empfehlen wir Ihnen, JPEG direkt bereitzustellen.

Anforderungen

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

Verwendet von

AdRecommendationImageSuggestion

Freigeben über