مرجع العروض الترويجية عبر البريد الإلكتروني
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضِّح هذه الصفحة الأنواع المستخدَمة لإضافة تعليقات توضيحية إلى الرسائل الإلكترونية الترويجية و
خصائصها المرتبطة. يتم تضمين هذه الأنواع والسمات في عنوان الرسالة الإلكترونية الترويجية بتنسيق
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 |
اختياريّ. وصف من سطر واحد إلى سطرَين للعرض الترويجي الذي يظهر تحت image |
price |
Text |
اختياريّ. سعر العرض الترويجي في حال ضبط discountValue، يتم عرض price كسعر العرض الترويجي الأصلي قبل تطبيق الخصم. |
priceCurrency |
Text |
اختياريّ. تمثّل هذه السمة العملة المستخدمة للسعر بتنسيق ISO 4217 المكوّن من ثلاثة أحرف، مثل USD. لتحديد رمز العملة المعروض مع السعر. |
discountValue |
Text |
اختياريّ. المبلغ الذي يتم طرحه من price لعرض سعر معدَّل. يظهر السعر المعدَّل بجانب السعر الأصلي. على سبيل المثال، إذا تم ضبط discountValue على 25، وتم ضبط price على 100، وكان priceCurrency هو USD، يتم عرض السعر المعدَّل على النحو التالي: $75. |
position |
Text |
اختياريّ. موضع البطاقة في لوحة العرض الدوّارة |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
