メール プロモーションのリファレンス

このページでは、プロモーション メールにアノテーションを付けるために使用されるタイプと、それに関連するプロパティについて説明します。これらのタイプとプロパティは、プロモーション メールのヘッダーに JSON-LDとして含まれています。

詳しくは、 メールのマークアップのスタートガイドをご覧ください。

組織

Organization タイプを使用すると、プロモーションに含めるロゴを指定できます。

名前 タイプ 説明
logo ImageObject または URL 送信者のアイコンとして表示されるロゴ。URL には HTTP ではなく HTTPS を使用してください。

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

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 テキスト

省略可。カルーセル内のカードの位置。