Referenz für E-Mail-Werbung
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite werden die Typen beschrieben, die zum Angeben von Werbe-E-Mails und ihren zugehörigen Eigenschaften verwendet werden. Diese Typen und Properties sind im Header einer Werbe-E‑Mail als JSON-LD enthalten.
Weitere Informationen finden Sie im Leitfaden Einstieg in das Markup für E-Mails.
Organisation
Mit dem Typ Organization können Sie ein Logo angeben, das in das Angebot aufgenommen werden soll.
DiscountOffer
Mit dem Typ DiscountOffer können Sie Hinweise zu Angeboten erstellen, in denen die Details eines Angebots wie der Rabattcode oder das Ablaufdatum hervorgehoben werden.
Mit dem Typ PromotionCard können Sie eine visuelle Vorschau Ihrer Werbung einfügen.
| Name |
Typ |
Beschreibung |
image |
ImageObject oder URL |
Erforderlich. Die Bildvorschau der E-Mail im PNG- oder JPEG-Format. Die unterstützten Seitenverhältnisse sind 4:5, 1:1 und 1, 91:1. Bilder werden automatisch mittig zugeschnitten. Best Practices für Bilder Bei Produktkarussells muss jedes PromotionCard ein eigenes Bild haben und dasselbe Seitenverhältnis verwenden. |
url |
URL |
Erforderlich. Die URL für das Angebot. Wenn Nutzer auf das image in der E-Mail klicken, werden sie zu dieser URL weitergeleitet. |
headline |
Text |
Optional. Eine Beschreibung des Angebots in 1 bis 2 Zeilen, die unter der image angezeigt wird. |
price |
Text |
Optional. Der Preis des Angebots. Wenn Sie einen discountValue festlegen, wird der price als Originalpreis der Werbeaktion angezeigt, bevor der Rabatt angewendet wird. |
priceCurrency |
Text |
Optional. Die Währung des Preises im dreistelligen ISO 4217-Format, z. B. USD. Bestimmt das Währungssymbol, das mit dem Preis angezeigt wird. |
discountValue |
Text |
Optional. Der Betrag, der von price abgezogen wird, um einen angepassten Preis anzuzeigen. Der angepasste Preis wird neben dem Originalpreis angezeigt. Wenn discountValue beispielsweise auf 25, price auf 100 und priceCurrency auf USD festgelegt ist, wird der angepasste Preis als $75 angezeigt. |
position |
Text |
Optional. Die Position der Karte im Karussell. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-24 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-24 (UTC)."],[],[],null,["# Email promotions reference\n\nThis page describes the types used to annotate promotional email and their\nassociated properties. These types and properties are included in a\npromotional email's header as\n[JSON-LD](/workspace/gmail/markup/reference/formats/json-ld).\n\nTo learn more, review\nthe [Email Markup Getting Started](/workspace/gmail/markup/getting-started) guide.\n\nOrganization\n------------\n\nThe `Organization` type lets you specify a logo to include in the promotion.\n\n| Name | Type | Description |\n|--------|--------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `logo` | [ImageObject](/workspace/gmail/markup/reference/types/ImageObject) or [URL](/workspace/gmail/markup/reference/types/URL) | The logo that displays as an icon for the sender. Recommended to use an HTTPS URL. See [best practices for Logo URL](/workspace/gmail/promotab/best-practices#logo_url). |\n\nDiscountOffer\n-------------\n\nThe `DiscountOffer` type lets you create [deal\nannotations](/workspace/gmail/promotab/overview#deal-annotation), which promote the\ndetails of an offer such as the discount code or expiration date.\n\n| Name | Type | Description |\n|----------------------|-------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `description` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. A short text that displays next to the deal badge icon, such as `Free shipping` or `20% off`. See [best practices for the deal badge](/workspace/gmail/promotab/best-practices#deal_badge). |\n| `discountCode` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The discount or promotion code of the offer, such as `20PROMO`. See [best practices for discount codes](/workspace/gmail/promotab/best-practices#discount_code). |\n| `availabilityStarts` | [DateTime](/workspace/gmail/markup/reference/datetime-formatting) | Optional. The date and time when the offer begins in [ISO 8601](https://support.google.com/merchants/answer/7055760) format, such as `2023-09-25T18:44:37-07:00`. |\n| `availabilityEnds` | [DateTime](/workspace/gmail/markup/reference/datetime-formatting) | Optional. The end date and time of the promotion in [ISO 8601](https://support.google.com/merchants/answer/7055760) format, such as `2023-10-25T18:44:37-07:00`. See [best practices for Expiration Date](/workspace/gmail/promotab/best-practices#expiration_date). |\n\nPromotionCard\n-------------\n\nThe `PromotionCard` type lets you include a visual preview of your promotion.\n\n| Name | Type | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `image` | [ImageObject](/workspace/gmail/markup/reference/types/ImageObject) or [URL](/workspace/gmail/markup/reference/types/URL) | Required. The image preview of the email in PNG or JPEG format. The supported aspect ratios are 4:5, 1:1, and 1.91:1. Images are center-cropped automatically. See [best practices for images](/workspace/gmail/promotab/best-practices#images). For product carousels, each `PromotionCard` must have a unique image and use the same aspect ratio. |\n| `url` | [URL](/workspace/gmail/markup/reference/types/URL) | Required. The URL for the promotion. When users click on the email's `image`, they are directed to this URL. |\n| `headline` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. A 1 to 2-line description of the promotion that is displayed under the `image`. |\n| `price` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The price of the promotion. If you set a `discountValue`, the `price` displays as the original price of the promotion before the discount is applied. |\n| `priceCurrency` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The currency of the price in 3-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, such as `USD`. Determines the currency symbol displayed with the price. |\n| `discountValue` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The amount subtracted from the `price` to display an adjusted price. The adjusted price is displayed next to the original price. For example, if the `discountValue` is set to `25`, the `price` is set to `100`, and the `priceCurrency` is `USD`, the adjusted price is displayed as `$75`. |\n| `position` | [Text](/workspace/gmail/markup/reference/types/Text) | Optional. The position of the card in the carousel. |"]]
