Gmail Promotions产品轮播实际收件箱不显示，求激活配置方案

问题描述 #

我正在开发营销场景下的Gmail Promotions邮件，已创建多款基础模板，目标是在Gmail收件箱的Promotions标签页展示产品轮播。按照官方文档实现了JSON-LD标记和meta标签两种方案，模板在Promotions预览工具中渲染完全正常，但发送给真实Gmail用户后，产品轮播并未显示。

附上代码片段：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
  <head>
    <script type="application/ld+json">
[
// Build the first image preview in your product carousel:
        {
          "@context": "http://schema.org/",
          "@type": "PromotionCard",
          "image": "http://flywith.virginatlantic.com/content/dam/crm/1-3-pods/London.png",
          "url": "https://flights.virginatlantic.com/en-gb/",
          "headline": "VAA Blackfriday 20% Offer",
          "price": 199.00,
          "priceCurrency": "GBP",
          "discountValue": 40.00,
          "position": 1
        },

        // Build the second image preview in your product carousel:
        {
          "@context": "http://schema.org/",
          "@type": "PromotionCard",
          "image": "http://flywith.virginatlantic.com/content/dam/crm/1-3-pods/LA.png",
          "url": "https://flights.virginatlantic.com/en-gb/",
          "headline": "25% off on London flights",
          "price": 399.00,
          "priceCurrency": "GBP",
          "discountValue": 100.00,
          "position": 2

          },

{
          "@context": "http://schema.org/",
          "@type": "PromotionCard",
          "image": "http://flywith.virginatlantic.com/content/dam/crm/1-3-pods/292x292-upper.jpg",
          "url": "https://flights.virginatlantic.com/en-gb/",
          "headline": "20% Off on Upper class",
          "price": 299.00,
          "priceCurrency": "GBP",
          "discountValue": 60.00,
          "position": 3

          }
]
    </script>
  </head>

  <body>
    <p>Email Body</p>
    <p>Line 2</p>
  </body>
</html>

请问需要启用哪些额外设置或满足哪些要求才能激活该产品轮播功能？

解决方案 #

以下是确保Gmail Promotions标签页显示产品轮播的关键要求和设置：

1. 完成域名认证 #

• 必须配置SPF、DKIM、DMARC三项域名认证，Gmail仅信任经过严格认证的发件方展示富媒体内容（包括产品轮播）。
• DMARC记录建议设置为p=quarantine或p=reject，避免邮件被标记为垃圾邮件，这会直接影响轮播渲染。

2. 修正JSON-LD格式 #

• 你的代码中每个PromotionCard重复了@context，正确做法是将@context放在外层父对象中，用ItemList包裹所有卡片：

  {
    "@context": "http://schema.org/",
    "@type": "ItemList",
    "itemListElement": [
      {
        "@type": "PromotionCard",
        "image": "http://flywith.virginatlantic.com/content/dam/crm/1-3-pods/London.png",
        "url": "https://flights.virginatlantic.com/en-gb/",
        "headline": "VAA Blackfriday 20% Offer",
        "price": 199.00,
        "priceCurrency": "GBP",
        "discountValue": 40.00,
        "position": 1
      },
      // 其他卡片内容...
    ]
  }
  

• 移除JSON-LD中的注释，部分邮件客户端会因解析注释导致格式错误，进而忽略整个标记。
• 确保字段格式合规：price和discountValue为数字类型（不加引号）；position从1开始递增，不能跳号或重复。

3. 图片资源合规 #

• 图片必须使用HTTPS协议，Gmail默认阻止HTTP资源加载，会导致轮播无法显示。
• 图片尺寸推荐292x292像素，最大不超过500x500像素，避免拉伸变形。
• 确保图片URL可公开访问，无防盗链限制，Gmail服务器需要能抓取到图片资源。

4. 邮件内容匹配Promotions标签 #

• 邮件正文必须包含与轮播产品相关的实际内容，不能只有空泛文本，Gmail会判断内容是否与Promotions标签匹配，不匹配则隐藏轮播。
• 可通过设置邮件头部X-Gmail-Labels: Promotions，引导Gmail将邮件归类到对应标签。

5. 优化发送环境 #

• 使用正式营销邮件发送平台（而非免费测试邮箱）发送，这类平台的发件IP信誉更高，更易触发富媒体展示。
• 控制发送频率，避免过度营销内容，保持收件人互动率（打开、点击），降低被标记为垃圾邮件的概率。

内容的提问来源于stack exchange，提问作者Amit Sharma