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

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

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

組織

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

名前 型 説明
logo ImageObject または URL 送信者のアイコンとして表示されるロゴ。HTTPS URL を使用することをおすすめします。ロゴの URL に関するベスト プラクティスをご覧ください。

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

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