[プロモーション] タブでメールにアノテーションを付ける

メールのアノテーションを使用すると、[プロモーション] タブに表示されるメールに、画像、特価情報、有効期限などの機能を使ってメッセージを表示できます。

メールにアノテーションを付けると、Gmail ユーザーが受信トレイから直接プロモーションを表示して操作できるようになります。[プロモーション] タブでは、メールを開かなくても、アノテーション付きのテキストや画像をクリックしてプロモーションの詳細を確認できます。

このページでは、JSON-LDmicrodata を使用してメールにアノテーションを付ける方法について説明します。メールのマークアップについて詳しくは、スタートガイドをご覧ください。メールのアノテーションで使用できるマークアップ フィールドの一覧については、リファレンス ドキュメントをご覧ください。

メールのアノテーションを作成する

メールにアノテーションを付けると、[プロモーション] タブで次の機能を表示できます。

以下のセクションでは、それぞれのタイプのメールにアノテーションを作成する方法について説明します。

取引アノテーションを作成する

ディールのアノテーションには、プロモーション コードや有効期限など、プロモーションに関するテキストベースの詳細情報が表示されます。

取引アノテーションを作成するには:

  1. マーケティング メール プラットフォームでメールを作成し、そのメールの HTML エディタを開きます。
  2. head セクションで、データ型 DiscountOffer を含む script タグを追加します。

    JSON-LD

    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
    <html>
      <head>
        <script type="application/ld+json">
          [{
            "@context": "http://schema.org/",
            "@type": "DiscountOffer",
            "description": "DESCRIPTION",
            "discountCode": "DISCOUNT_CODE",
            "availabilityStarts": "START_DATE_TIME",
            "availabilityEnds": "END_DATE_TIME"
          }]
        </script>
      </head>
    
      <body>
        // The message of your email
      </body>
    </html>
    

    microdata

    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
    <html>
      <head>
        <div itemscope itemtype="http://schema.org/DiscountOffer">
          <meta itemprop="description" content="DESCRIPTION"/>
          <meta itemprop="discountCode" content="DISCOUNT_CODE"/>
          <meta itemprop="availabilityStarts" content="START_DATE_TIME"/>
          <meta itemprop="availabilityEnds" content="END_DATE_TIME"/>
        </div>
      </head>
    
      <body>
        // The message of your email.
      </body>
    </html>
    

    次の値を置き換えます。すべてのプロパティは省略可能です。プロパティごとに、値を含めるか、コードからプロパティを省略できます。

    • DESCRIPTION(省略可): お買い得バッジとともに表示されるテキスト(20% offFree shipping など)。
    • DISCOUNT_CODE(省略可): 特典の割引コードやプロモーション コード(例: 20TODAY)。
    • START_DATE_TIME(省略可): 特典の開始日時を ISO 8601 形式(2023-09-25T18:44:37-07:00 など)で指定します。
    • END_DATE_TIME(省略可): プロモーションの終了日を ISO 8601 形式で指定します(例: 2023-10-25T18:44:37-07:00)。
  3. body タグ内に、メールのメッセージを入力します。

商品カルーセルには、次のようにプロモーション用の複数の画像プレビューが表示されます。

特価の靴下の画像プレビューのカルーセルが 3 つ表示されたプロモーション メール。

カルーセルには最大 10 件の画像プレビューを含めることができます。各画像は一意である必要があります。

商品カルーセルを作成するには:

  1. マーケティング メール プラットフォームでメールを作成し、そのメールの HTML エディタを開きます。
  2. head セクションに script タグを追加します。商品カルーセルの画像ごとに、PromotionCard オブジェクトを追加します。

    JSON-LD

    <!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": "IMAGE_URL1",
              "url": "PROMO_URL1",
    
              // Optionally, include the following PromotionCard properties:
              "headline": "HEADLINE1",
              "price": PRICE1,
              "priceCurrency": "PRICE_CURRENCY1",
              "discountValue": DISCOUNT_VALUE1,
              "position": POSITION
            },
    
            // Build the second image preview in your product carousel:
            {
              "@context": "http://schema.org/",
              "@type": "PromotionCard",
              "image": "IMAGE_URL2",
              "url": "PROMO_URL2",
    
              // Optionally, include the following PromotionCard properties:
              "headline": "HEADLINE2",
              "price": PRICE2,
              "priceCurrency": "PRICE_CURRENCY2",
              "discountValue": DISCOUNT_VALUE2,
              "position": POSITION
            }
    
            // To include more image previews, add additional PromotionCard objects.
            // You can include up to 10 image previews in a product carousel.
    
          ]
        </script>
      </head>
    
      <body>
        // The message of your email
      </body>
    </html>
    

    microdata

    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
    <html>
      <head>
        // Build the first image preview in your product carousel:
        <div itemscope itemtype="http://schema.org/PromotionCard">
          <meta itemprop="image" content="IMAGE_URL1"/>
          <meta itemprop="url" content="PROMO_URL1"/>
    
          // Optionally, include the following PromotionCard properties:
          <meta itemprop="headline" content="HEADLINE1"/>
          <meta itemprop="price" content="PRICE1"/>
          <meta itemprop="priceCurrency" content="PRICE_CURRENCY1"/>
          <meta itemprop="discountValue" content="DISCOUNT_VALUE1"/>
          <meta itemprop="position" content="POSITION"/>
        </div>
    
        // Build the second image preview in your product carousel:
        <div itemscope itemtype="http://schema.org/PromotionCard">
          <meta itemprop="image" content="IMAGE_URL2"/>
          <meta itemprop="url" content="PROMO_URL2"/>
    
          // Optionally, include the following PromotionCard properties:
          <meta itemprop="headline" content="HEADLINE2"/>
          <meta itemprop="price" content="PRICE2"/>
          <meta itemprop="priceCurrency" content="PRICE_CURRENCY2"/>
          <meta itemprop="discountValue" content="DISCOUNT_VALUE2"/>
          <meta itemprop="position" content="POSITION"/>
        </div>
    
        // To include more image previews, add additional PromotionCard objects.
        // You can include up to 10 image previews in a product carousel.
      </head>
    
      <body>
        // The message of your email
      </body>
    </html>
    

    PromotionCard オブジェクトごとに、次の値を置き換えます。オプションのプロパティでは、値を含めるか、コードからプロパティを省略できます。

    • IMAGE_URL: PNG 形式または JPEG 形式の画像の URL(例: https://www.example.com/image.png)。サポートされるアスペクト比は、4:5、1:1、1.91:1 です。商品のカルーセルの場合は、各画像に固有の URL を設定し、同じアスペクト比を使用する必要があります。
    • PROMO_URL: プロモーションの URL。ユーザーが [プロモーション] タブで画像をクリックすると、この URL にアクセスします。
    • HEADLINE(省略可): プレビュー画像の下に表示されるプロモーションの 1 ~ 2 行の説明。
    • PRICE(省略可): プロモーションの価格。
    • PRICE_CURRENCY(省略可): 価格の通貨。3 文字の ISO 4217 形式で指定します(例: USD)。price で表示される通貨記号を決定します。
    • DISCOUNT_VALUE(省略可): 調整価格を表示するために price から差し引かれた金額。調整された価格は、元の価格の横に表示されます。

      たとえば、discountValue25price100priceCurrencyUSD の場合、調整された価格は $75 と表示されます。

    • POSITION(省略可): カルーセル内のカードの位置。

  3. body タグ内に、メールのメッセージを入力します。

次のステップ