E-posta tanıtımları referansı
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, tanıtım amaçlı e-postalara not eklemek için kullanılan türler ve bunlarla ilişkili özellikler açıklanmaktadır. Bu türler ve mülkler, tanıtım amaçlı e-postaların başlığına JSON-LD olarak eklenir.
Daha fazla bilgi için E-posta İşaretleme Başlangıç Kılavuzu'nu inceleyin.
Kuruluş
Organization
türü, promosyona dahil edilecek bir logo belirtmenize olanak tanır.
DiscountOffer
DiscountOffer
türü, bir teklifin ayrıntılarını (ör. indirim kodu veya son kullanma tarihi) tanıtan anlaşma ek açıklamaları oluşturmanıza olanak tanır.
PromotionCard
türü, promosyonunuzun görsel bir önizlemesini eklemenize olanak tanır.
Ad |
Tür |
Açıklama |
image |
ImageObject veya URL |
Zorunlu. E-postanın PNG veya JPEG biçimindeki resim önizlemesi. Desteklenen en boy oranları 4:5, 1:1 ve 1, 91:1'dir. Resimler otomatik olarak ortasından kırpılır. Resimlerle ilgili en iyi uygulamalara bakın. Ürün bantlarında her PromotionCard benzersiz bir resme sahip olmalı ve aynı en boy oranını kullanmalıdır. |
url |
URL |
Zorunlu. Promosyonun URL'si. Kullanıcılar e-postanın image simgesini tıkladığında bu URL'ye yönlendirilir. |
headline |
Metin |
İsteğe bağlı. image altında gösterilen promosyonun 1-2 satırlık açıklaması. |
price |
Metin |
İsteğe bağlı. Promosyonun fiyatı. Bir discountValue ayarlarsanız price , indirim uygulanmadan önce promosyonun orijinal fiyatı olarak gösterilir. |
priceCurrency |
Metin |
İsteğe bağlı. Fiyatın 3 harfli ISO 4217 biçimindeki para birimi (ör. USD ). Fiyatla birlikte gösterilen para birimi simgesini belirler. |
discountValue |
Metin |
İsteğe bağlı. Düzenlenmiş bir fiyat görüntülemek için price değerinden çıkarılan tutar. Düzenlenen fiyat, orijinal fiyatın yanında gösterilir. Örneğin, discountValue 25 , price 100 ve priceCurrency USD olarak ayarlanırsa düzenlenmiş fiyat $75 olarak gösterilir. |
position |
Metin |
İsteğe bağlı. Kartın banttaki konumu. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-03-24 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]