Referensi promosi email
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan jenis yang digunakan untuk menganotasi email promosi dan properti
terkaitnya. Jenis dan properti ini disertakan dalam
header email promosi sebagai
JSON-LD.
Untuk mempelajari lebih lanjut, tinjau
panduan Memulai Markup Email.
Organisasi
Jenis Organization memungkinkan Anda menentukan logo yang akan disertakan dalam promosi.
DiscountOffer
Jenis DiscountOffer memungkinkan Anda membuat anotasi
promo, yang mempromosikan
detail penawaran seperti kode diskon atau tanggal habis masa berlaku.
Jenis PromotionCard memungkinkan Anda menyertakan pratinjau visual promosi.
| Nama |
Jenis |
Deskripsi |
image |
ImageObject atau URL |
Wajib. Pratinjau gambar email dalam format PNG atau JPEG. Rasio lebar tinggi yang didukung adalah 4:5, 1:1, dan 1,91:1. Gambar dipangkas di bagian tengah secara otomatis. Lihat praktik terbaik untuk gambar. Untuk carousel produk, setiap PromotionCard harus memiliki gambar unik dan menggunakan rasio aspek yang sama. |
url |
URL |
Wajib. URL untuk promosi. Saat pengguna mengklik image email, mereka akan diarahkan ke URL ini. |
headline |
Teks |
Opsional. Deskripsi promosi 1 hingga 2 baris yang ditampilkan di bagian image. |
price |
Teks |
Opsional. Harga promosi. Jika Anda menetapkan discountValue, price akan ditampilkan sebagai harga asli promosi sebelum diskon diterapkan. |
priceCurrency |
Teks |
Opsional. Mata uang harga dalam format ISO 4217 3 huruf, seperti USD. Menentukan simbol mata uang yang ditampilkan dengan harga. |
discountValue |
Teks |
Opsional. Jumlah yang dikurangi dari price untuk menampilkan harga yang disesuaikan. Harga yang disesuaikan ditampilkan di samping harga asli. Misalnya, jika discountValue ditetapkan ke 25, price ditetapkan ke 100, dan priceCurrency adalah USD, harga yang disesuaikan akan ditampilkan sebagai $75. |
position |
Teks |
Opsional. Posisi kartu dalam carousel. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-03-24 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
