電子郵件促銷活動參考資料
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本頁說明用於註解宣傳電子郵件及其相關屬性的類型。這些類型和屬性會以 JSON-LD 的形式納入宣傳電子郵件的標頭。
詳情請參閱電子郵件標記入門指南。
機構
Organization
類型可讓您指定要納入促銷活動的標誌。
DiscountOffer
DiscountOffer
類型可讓您建立交易註解,用於宣傳優惠的詳細資料,例如折扣代碼或到期日。
名稱 |
類型 |
說明 |
description |
Text |
選用設定。顯示在特惠標記圖示 (例如 Free shipping 或 20% off ) 旁的簡短文字。請參閱特價徽章的最佳做法。 |
discountCode |
Text |
選用設定。優惠的折扣或促銷代碼,例如 20PROMO 。請參閱折扣代碼最佳做法。 |
availabilityStarts |
DateTime |
選用設定。優惠開始日期和時間,採用 ISO 8601 格式,例如 2023-09-25T18:44:37-07:00 。 |
availabilityEnds |
DateTime |
選用設定。以 ISO 8601 格式輸入促銷活動的結束日期和時間,例如 2023-10-25T18:44:37-07:00 。請參閱到期日的最佳做法。 |
PromotionCard
類型可讓您加入宣傳活動的視覺預覽畫面。
名稱 |
類型 |
說明 |
image |
ImageObject 或 網址 |
必要欄位。電子郵件圖片預覽圖片,格式為 PNG 或 JPEG。 支援的顯示比例為 4:5、1:1 和 1.91:1。系統會自動裁剪圖片的中心區域。請參閱圖片的最佳做法。 針對產品輪轉介面,每個 PromotionCard 都必須使用獨特圖片,且採用相同的顯示比例。 |
url |
網址 |
必要欄位。促銷活動的網址。使用者點選電子郵件的 image 後,系統會將他們導向這個網址。 |
headline |
Text |
選用設定。1 到 2 行促銷活動說明,會顯示在 image 下方。 |
price |
Text |
選用設定。促銷活動的價格。如果您設定 discountValue ,price 會顯示促銷活動的原始價格,也就是套用折扣前的價格。 |
priceCurrency |
Text |
選用設定。價格的幣別,採用 3 個英文字母組成的 ISO 4217 格式,例如 USD 。決定價格顯示的貨幣符號。 |
discountValue |
Text |
選用設定。從 price 中扣除的金額,用於顯示調整後的價格。調整後的價格會顯示在原價旁邊。 舉例來說,如果 discountValue 設為 25 、price 設為 100 ,而 priceCurrency 為 USD ,則系統會顯示經調整的價格 $75 。 |
position |
Text |
選用設定。輪轉介面中的卡片位置。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-03-24 (世界標準時間)。
[null,null,["上次更新時間:2025-03-24 (世界標準時間)。"],[],[],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. |"]]