이메일 프로모션 참조
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 프로모션 이메일에 주석을 추가하는 데 사용되는 유형과 관련 속성을 설명합니다. 이러한 유형 및 속성은 프로모션 이메일의 헤더에 JSON-LD로 포함됩니다.
자세한 내용은 이메일 마크업 시작하기 가이드를 참고하세요.
조직
Organization 유형을 사용하면 프로모션에 포함할 로고를 지정할 수 있습니다.
DiscountOffer
DiscountOffer 유형을 사용하면 할인 코드나 만료일과 같은 제품 세부정보를 홍보하는 거래 주석을 만들 수 있습니다.
| 이름 |
유형 |
설명 |
description |
텍스트 |
선택사항입니다. 특가 배지 아이콘 옆에 표시되는 짧은 텍스트입니다(예: Free shipping 또는 20% off). 특가 배지 권장사항을 참고하세요. |
discountCode |
텍스트 |
선택사항입니다. 혜택의 할인 또는 프로모션 코드(예: 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 또는 URL |
필수 항목입니다. PNG 또는 JPEG 형식의 이메일 이미지 미리보기 지원되는 가로세로 비율은 4:5, 1:1, 1.91:1입니다. 이미지가 자동으로 가운데로 자릅니다. 이미지 권장사항을 참고하세요. 제품 캐러셀의 경우 각 PromotionCard에는 고유한 이미지가 있어야 하며 동일한 가로세로 비율을 사용해야 합니다. |
url |
URL |
필수 항목입니다. 프로모션의 URL입니다. 사용자가 이메일의 image를 클릭하면 이 URL로 연결됩니다. |
headline |
텍스트 |
선택사항입니다. image 아래에 표시되는 프로모션에 대한 1~2줄의 설명입니다. |
price |
텍스트 |
선택사항입니다. 프로모션 가격입니다. discountValue를 설정하면 price가 할인이 적용되기 전의 프로모션 원래 가격으로 표시됩니다. |
priceCurrency |
텍스트 |
선택사항입니다. 가격에 사용된 통화로, 3글자 ISO 4217 형식(예: USD)입니다. 가격과 함께 표시되는 통화 기호를 결정합니다. |
discountValue |
텍스트 |
선택사항입니다. 조정된 가격을 표시하기 위해 price에서 뺀 금액입니다. 조정된 가격이 원래 가격 옆에 표시됩니다. 예를 들어 discountValue가 25로 설정되고 price가 100로 설정되고 priceCurrency가 USD로 설정되면 조정된 가격은 $75로 표시됩니다. |
position |
텍스트 |
선택사항입니다. 캐러셀에서 카드의 위치입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]
