Tài liệu tham khảo về email quảng bá
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này mô tả các loại dùng để chú thích email quảng bá và các thuộc tính liên quan của chúng. Các loại và thuộc tính này được đưa vào tiêu đề của email quảng bá dưới dạng JSON-LD.
Để tìm hiểu thêm, hãy xem hướng dẫn Bắt đầu sử dụng tính năng Đánh dấu email.
Tổ chức
Loại Organization cho phép bạn chỉ định một biểu trưng để đưa vào chương trình khuyến mãi.
DiscountOffer
Loại DiscountOffer cho phép bạn tạo chú thích ưu đãi để quảng bá thông tin chi tiết về ưu đãi, chẳng hạn như mã giảm giá hoặc ngày hết hạn.
Loại PromotionCard cho phép bạn thêm bản xem trước hình ảnh của chương trình khuyến mãi.
| Tên |
Loại |
Mô tả |
image |
ImageObject hoặc URL |
Bắt buộc. Hình xem trước của email ở định dạng PNG hoặc JPEG. Tỷ lệ khung hình được hỗ trợ là 4:5, 1:1 và 1, 91:1. Hình ảnh được tự động cắt theo tâm. Xem các phương pháp hay nhất về hình ảnh. Đối với băng chuyền sản phẩm, mỗi PromotionCard phải có một hình ảnh riêng biệt và sử dụng cùng một tỷ lệ khung hình. |
url |
URL |
Bắt buộc. URL của chương trình khuyến mãi. Khi người dùng nhấp vào image của email, họ sẽ được chuyển hướng đến URL này. |
headline |
Văn bản |
Không bắt buộc. Nội dung mô tả từ 1 đến 2 dòng về chương trình khuyến mãi xuất hiện trong image. |
price |
Văn bản |
Không bắt buộc. Giá của chương trình khuyến mãi. Nếu bạn đặt discountValue, price sẽ hiển thị dưới dạng giá gốc của chương trình khuyến mãi trước khi áp dụng chiết khấu. |
priceCurrency |
Văn bản |
Không bắt buộc. Đơn vị tiền tệ của giá ở định dạng ISO 4217 gồm 3 chữ cái, chẳng hạn như USD. Xác định ký hiệu đơn vị tiền tệ hiển thị cùng với giá. |
discountValue |
Văn bản |
Không bắt buộc. Số tiền được trừ khỏi price để hiển thị giá đã điều chỉnh. Giá đã điều chỉnh sẽ xuất hiện bên cạnh giá gốc. Ví dụ: nếu discountValue được đặt thành 25, price được đặt thành 100 và priceCurrency là USD, thì giá đã điều chỉnh sẽ hiển thị là $75. |
position |
Văn bản |
Không bắt buộc. Vị trí của thẻ trong băng chuyền. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-03-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]
