ข้อมูลอ้างอิงโปรโมชันทางอีเมล
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้อธิบายประเภทที่ใช้กำกับหมายอีเมลโปรโมชันและพร็อพเพอร์ตี้ที่เกี่ยวข้อง ประเภทและพร็อพเพอร์ตี้เหล่านี้จะรวมอยู่ในส่วนหัวของอีเมลโปรโมตเป็น JSON-LD
ดูข้อมูลเพิ่มเติมได้ที่คู่มือเริ่มต้นใช้งานมาร์กอัปอีเมล
องค์กร
ประเภท Organization ช่วยให้คุณระบุโลโก้ที่จะรวมไว้ในโปรโมชันได้
DiscountOffer
ประเภท DiscountOffer ช่วยให้คุณสร้างคำอธิบายประกอบดีล ซึ่งจะแสดงรายละเอียดของข้อเสนอ เช่น รหัสส่วนลดหรือวันที่หมดอายุ
ประเภท PromotionCard ช่วยให้คุณใส่ตัวอย่างภาพโปรโมชันได้
| ชื่อ |
ประเภท |
คำอธิบาย |
image |
ImageObject หรือ URL |
ต้องระบุ ตัวอย่างรูปภาพของอีเมลในรูปแบบ PNG หรือ JPEG สัดส่วนภาพที่รองรับคือ 4:5, 1:1 และ 1.91:1 ระบบจะครอบตัดรูปภาพให้อยู่ตรงกลางโดยอัตโนมัติ ดูแนวทางปฏิบัติแนะนำสำหรับรูปภาพ สำหรับภาพสไลด์ของผลิตภัณฑ์ PromotionCard แต่ละรายการต้องมีรูปภาพที่ไม่ซ้ำกันและใช้สัดส่วนภาพเดียวกัน |
url |
URL |
ต้องระบุ URL ของโปรโมชัน เมื่อผู้ใช้คลิก image ของอีเมล ระบบจะนําไปยัง URL นี้ |
headline |
Text |
ไม่บังคับ คําอธิบายโปรโมชัน 1-2 บรรทัดที่จะแสดงใต้ image |
price |
Text |
ไม่บังคับ ราคาของโปรโมชัน หากคุณตั้งค่า discountValue price จะแสดงเป็นราคาเดิมของโปรโมชันก่อนที่จะหักส่วนลด |
priceCurrency |
Text |
ไม่บังคับ สกุลเงินของราคาในรูปแบบ ISO 4217 ที่เป็นตัวอักษร 3 ตัว เช่น USD กำหนดสัญลักษณ์สกุลเงินที่แสดงพร้อมกับราคา |
discountValue |
Text |
ไม่บังคับ จำนวนเงินที่หักออกจาก price เพื่อแสดงราคาที่ปรับแล้ว ราคาที่ปรับแล้วจะแสดงข้างราคาเดิม ตัวอย่างเช่น หากตั้งค่า discountValue เป็น 25, ตั้งค่า price เป็น 100 และตั้งค่า priceCurrency เป็น USD ราคาที่ปรับแล้วจะแสดงเป็น $75 |
position |
Text |
ไม่บังคับ ตำแหน่งของการ์ดในภาพสไลด์ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-03-24 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]
