Marketing API

Bildzuschnitte

Stelle Seitenverhältnisse für Bilder in verschiedenen Anzeigenplatzierungen bereit. Facebook schneidet dein Bild anhand der von dir bereitgestellten Angaben zu. Wenn du keine Zuschnitte bereitstellst, wird dein Bild gemäß den Standards angezeigt. Siehe Bilder für Werbeanzeigen. Lade z. B. ein Bild zur Verwendung in einer Anzeigengestaltung hoch:

curl \
  -F 'filename=@<IMAGE_PATH>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adimages

Stelle dann die Anzeigengestaltung bereit, indem du den Bild-Hash, der im vorherigen Aufruf zurückgegeben wurde, zusammen mit dem Zuschnitt referenzierst.

Zuschnitte enthalten Schlüssel-Wert-Paare, bei denen der Schlüssel ein crop key ist und der Wert den Pixel-Abmessungen des Zuschnitts entspricht. Alle unterstützten Schlüssel findest du in der Referenz zu Bildzuschnitten für Werbeanzeigen.

Gib den Wert als (x, y)-Koordinaten für die linke obere und die rechte untere Ecke des Zuschnittsrechtecks an. crop key beschreibt ein Seitenverhältnis. Das Seitenverhältnis des Kästchens, das mit Breite und Höhe angegeben wird, muss möglichst genau dem Seitenverhältnis im crop key entsprechen.

Der Ausgangspunkt eines Bildes (0, 0) ist die obere linke Ecke. Der Punkt (width - 1, height - 1) ist die untere rechte Ecke.

Angabe

Wenn du diese Funktion verwendest, solltest du sie für alle Platzierungen verwenden, an denen eine Anzeige erscheinen könnte. Machst du beispielsweise Angaben für die rechte Spalte und möchtest die Anzeige auch in Newsfeed verwenden, musst du für die Platzierung im Newsfeed einen Zuschnitt bereitstellen.

Einschränkungen

Bildzuschnitte werden nur in Anzeigengestaltungen mit image_file oder image_hash unterstützt, nicht in Page posts. Werte müssen diesen Beschränkungen entsprechen:

  • Punkte, die durch (x, y) angegeben werden, müssen sich im Bild befinden. Ein Rechteck darf die Bildgrenzen nicht überschreiten.
  • Das Seitenverhältnis des Rechtecks muss mit dem im Zuschneideschlüssel angegebenen übereinstimmen.
  • Koordinaten dürfen keine negativen Werte enthalten.
  • Facebook Stories unterstützen Bildzuschnitte nicht.

Beispiel:

Example:{"100x100": [ [330, 67], [1080, 817] ]}