ImageAsset-Datenobjekt – Kampagnenverwaltung

2024-11-13

Wendet Zuschneideeinstellungen auf gespeicherte Bildmedien für ein bestimmtes Seitenverhältnis an.

Hinweis

Dieses Feature hat noch nicht jeder. Wenn Sie dies nicht getan haben, machen Sie sich keine Sorgen. Es ist in Kürze verfügbar.

Wenn Sie keine Zuschneideeinstellungen angeben, wird der Dienst automatisch auf den maximal möglichen Bereich aus der Mitte des Bilds angezeigt. Bei einem Bild von 1000 x 1000 Pixeln lautet die Einstellung für das Seitenverhältnis 1,91:1 beispielsweise CropWidth=1000, CropHeight=524, CropX=0 und 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
}

Elemente

Das ImageAsset-Objekt verfügt über die folgenden Elemente: CropHeight, CropWidth, CropX, CropY, SubType, TargetHeight, TargetWidth.

Element	Beschreibung	Datentyp
CropHeight	Die Anzahl der Pixel, die von der Bildobjektquelle verwendet werden sollen, beginnend mit der CropY-Position und der Bewegung nach oben. Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht festlegen, schneidet der Dienst automatisch entsprechend dem Seitenverhältnis des Untertyps zu. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
CropWidth	Die Anzahl der Pixel, die von der Bildobjektquelle verwendet werden sollen, beginnend mit der CropX-Position und der Bewegung nach rechts. Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht festlegen, schneidet der Dienst automatisch entsprechend dem Seitenverhältnis des Untertyps zu. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
CropX	Ausgehend von der unteren linken Ecke der Bildobjektquelle ist dies die Anzahl von Pixeln, die vor dem Anwenden von CropWidth auf der X-Achse nach rechts springen sollen. Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht festlegen, schneidet der Dienst automatisch entsprechend dem Seitenverhältnis des Untertyps zu. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
CropY	Ausgehend von der unteren linken Ecke der Bildobjektquelle ist dies die Anzahl von Pixeln, die auf der y-Achse nach oben übersprungen werden sollen, bevor CropHeight angewendet wird. Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht festlegen, schneidet der Dienst automatisch entsprechend dem Seitenverhältnis des Untertyps zu. Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	int
SubType	Stellt das Seitenverhältnis für dieses Bildobjekt dar. Das Seitenverhältnis für den Untertyp muss mit den effektiven Bildobjektdimensionen übereinstimmen. Wenn CropHeight und CropWidth nicht verwendet werden, muss das Seitenverhältnis für den Untertyp mit dem Seitenverhältnis des gespeicherten Bildmediums übereinstimmen. Wenn CropHeight und CropWidth verwendet werden, kann das tatsächliche Seitenverhältnis der Medien, die in der Medienbibliothek auf Kontoebene gespeichert sind, abweichen, solange CropHeight und CropWidth das richtige Seitenverhältnis ergeben. In beiden Fällen bleibt das wahre Seitenverhältnis der Medien, die in der Medienbibliothek auf Kontoebene gespeichert sind, unverändert. Der Untertyp muss auf "Logo" festgelegt werden, wenn das Bild einer Anzeige als "LandscapeLogoMedia" oder "SquareLogoMedia" zugeordnet ist. Mögliche Untertypwerte sind OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100, ImageMedia153X100. Weitere Informationen finden Sie unter ResponsiveAd-Hinweise. Hinweis: Ab sofort ersetzt SubType OriginalImage die Rolle von LandscapeImageMedia als Standardbild für ResponsiveAd of Audience Campaign. Möglicherweise werden in Zukunft neue Untertypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten. Hinzufügen: Erforderlich Aktualisieren: Schreibgeschützt. Sie können den Untertyp während des Updates nicht aktualisieren.	Zeichenfolge
TargetHeight	Die Zielhöhendimension einer Bildressource.	int
TargetWidth	Die Zielbreitendimension eines Bildobjekts.	int

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

Geerbte Elemente

Geerbte Elemente vom Medienobjekt

Das ImageAsset-Objekt wird vom Asset-Objekt abgeleitet und erbt die folgenden Elemente: Id, Name, Typ. Die folgenden Beschreibungen gelten spezifisch für ImageAsset und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Asset-Objekt erben.

Element	Beschreibung	Datentyp
Id	Der eindeutige Microsoft Advertising-Bezeichner für das Medienobjekt in einem Microsoft Advertising-Konto. Derselbe Bildobjektbezeichner kann mehrmals in derselben Anzeige für unterschiedliche Seitenverhältnisse verwendet werden und kann auch von mehreren Anzeigen im selben Microsoft Advertising-Konto verwendet werden. Der Bezeichner des Bildobjekts, bei dem SubType auf LandscapeImageMedia festgelegt ist, wird für alle automatisch generierten Bildmedienobjekttypen innerhalb derselben Anzeige verwendet. Unabhängig davon, ob Sie Microsoft Advertising die zugeschnittenen Bilder automatisch generieren lassen, muss die ID unter den Mit derselben Anzeige verknüpften Bildressourcen nicht eindeutig sein. Sie können Medien für reaktionsfähige Anzeigen über den AddMedia-Dienstvorgang erstellen. Anschließend können Sie den zurückgegebenen Medienbezeichner als Imageobjekt-ID verwenden. Das Seitenverhältnis des von Ihnen hinzugefügten Bilds muss für den Untertyp der Bildressource unterstützt werden. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	lang
Name	Reserviert für zukünftige Verwendung. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
Typ	Der Typ des Medienobjekts. Dieser Wert ist ImageAsset , wenn Sie ein Bildobjekt abrufen. Weitere Informationen zu Ressourcentypen finden Sie in den Hinweisen zu Objektdatenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge

Anforderungen

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

Verwendet von

VideoAsset