活動 (Event) 結構化資料

Google 活動搜尋服務能讓使用者透過 Google 搜尋結果和其他 Google 產品 (例如 Google 地圖) 更輕鬆地探索及參加活動。這項功能可以帶來多項好處:

搜尋結果中的活動範例

您可以透過下列三種方法讓 Google 顯示您的活動:

  • 如果您使用第三方網站張貼活動資訊 (例如在售票網站或社交平台上張貼),請確認對方是否已採用 Google 的活動搜尋服務。如果對方已與 Google 進行整合,您即可繼續在該第三方網站上張貼您的活動訊息,不必繼續閱讀下方內容。
  • 如果您使用的是 WordPress 等 CMS,且您無法存取 HTML,請確認該 CMS 是否提供可為網站添加結構化資料的外掛程式。或者,您也可以使用資料螢光筆標記資料,讓 Google 知道您的活動,無須編輯網站的 HTML。
  • 如果您有把握自行編輯 HTML,可以使用結構化資料直接與 Google 整合。您將會需要編輯活動網頁的 HTML。

如何新增結構化資料

結構化資料是一種標準化格式,能夠提供網頁相關資訊並分類網頁內容。如果您是第一次使用結構化資料,請參閱這篇文章,進一步瞭解結構化資料的運作方式。

以下簡要說明如何建立、測試及發布結構化資料。

  1. 新增必要屬性。根據您使用的格式,瞭解要在網頁中的什麼位置插入結構化資料
  2. 遵循指南規範
  3. 使用複合式搜尋結果測試驗證程式碼,並修正所有重大錯誤。此外,我們也建議您修正工具中可能標記的任何非重大問題,因為這有助於改善結構化資料的品質 (但並非符合複合式搜尋結果的顯示條件)。
  4. 部署幾個包含結構化資料的網頁,並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁,且網頁並未遭到 robots.txt 檔案或 noindex 標記封鎖,也未設有登入規定。如果網頁看起來沒問題,您可以要求 Google 重新檢索您的網址
  5. 為了讓 Google 掌握日後的異動內容,建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。

範例

標準活動

以下是採用 JSON-LD 格式的標準 Event 示例。「標準活動」僅指在實體地點舉辦且會如期舉行的活動。您也可以使用微資料或 RDFa 語法。

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "eventStatus": "https://schema.org/EventScheduled",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

線上活動

以下是在線上舉辦的活動示例。

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventScheduled",
      "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
      "location": {
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
        },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

線上和現場混合式活動

以下示例中的活動一部分在線上舉行,一部分在實體地點舉行。

<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/MixedEventAttendanceMode",
      "eventStatus": "https://schema.org/EventScheduled",
      "location": [{
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
      },
      {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      }],
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

狀態已更新的活動

有許多方法可以設定活動狀態,以下提供含有狀態更新的常見活動示例。詳情請參閱 eventStatus 屬性。

已取消

以下是已取消的活動示例。


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventCancelled",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

已改期

以下是已改期的活動示例。


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventStatus": "https://schema.org/EventRescheduled",
      "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
      "previousStartDate": "2025-03-21T19:00-05:00",
      "location": {
        "@type": "Place",
        "name": "Snickerpark Stadium",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "100 West Snickerpark Dr",
          "addressLocality": "Snickertown",
          "postalCode": "19019",
          "addressRegion": "PA",
          "addressCountry": "US"
        }
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

移至線上舉辦並改期

以下是已改期並移至線上舉辦的活動示例。


<html>
  <head>
    <title>The Adventures of Kira and Morrison</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Event",
      "name": "The Adventures of Kira and Morrison",
      "startDate": "2025-07-21T19:00-05:00",
      "endDate": "2025-07-21T23:00-05:00",
      "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
      "eventStatus": [
        "https://schema.org/EventRescheduled",
        "https://schema.org/EventMovedOnline"
        ],
      "previousStartDate": "2025-03-21T19:00-05:00",
      "location": {
        "@type": "VirtualLocation",
        "url": "https://operaonline.stream5.com/"
      },
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance.",
      "offers": {
        "@type": "Offer",
        "url": "https://www.example.com/event_offer/12345_202403180430",
        "price": "30",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "validFrom": "2024-05-21T12:00-05:00"
      },
      "performer": {
        "@type": "PerformingGroup",
        "name": "Kira and Morrison"
      },
      "organizer": {
        "@type": "Organization",
        "name": "Kira and Morrison Music",
        "url": "https://kiraandmorrisonmusic.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

支援的區域和語言

我們很高興能夠將 Google 活動搜尋服務推廣至全球更多地區,目前本服務支援的區域和語言如下所示。

區域 支援語言
澳洲 英文
巴西 葡萄牙文
加拿大 英文
德國 德文
印度 英文
拉丁美洲 西班牙文
西班牙 西班牙文
英國 英文
美國 英文

指南

您必須遵守以下規範,Google 搜尋服務才會顯示您的活動資訊。

技術指南

  • 目標網頁必須包含 schema.org 中活動類型的結構化資料項目。
  • 每項活動都「必須」具有專屬網址 (分葉頁面) 和該網址的標記。
  • Google 活動搜尋服務僅支援張貼單一活動的網頁。我們建議您將標記主要新增到活動資訊頁面,而不是那些列出時間表或多項活動的頁面。

內容指南

  • 每項活動必須據實提供活動名稱、開始日期和地點。
  • 避免將非活動內容標示為活動:
    • 請勿宣傳非活動性質的產品和服務,例如將「旅遊方案:聖地亞哥/洛杉磯 7 晚行程」標示為活動。
    • 請勿加入短期折扣或購買機會的促銷短語,例如「演唱會:歡迎立即購票」或「演唱會:週六前購票可享 5 折優惠」。
    • 請勿將營業時間標示為活動,例如「冒險樂園營業時間為上午 8 點至下午 5 點」。
    • 請勿將優待券標示為活動,例如「首筆訂單享 95 折優惠」。
  • 正確標記多日活動:
    • 如果您的活動或票券資訊是針對持續數天的活動,請指定活動的開始和結束日期。
    • 如果有多場不同的表演橫跨不同天舉辦,且每個表演都有各自的票券,請針對各場表演分別新增 Event 元素。

日期和時間指南

導入 startDateendDatepreviousStartDate 屬性時,請遵循以下的日期和時間指南。

如何指定時區

如要指定時區,請加入世界標準時間 (UTC) 或格林威治標準時間 (GMT) 時區設定。如果活動開始時間為紐約的 9 月 5 日晚上 7 點,則 startDate 值會是標準時間的 GMT/UTC-5,日光節約時間則為 GMT/UTC-4。在標準時間內,startDate 值分別為 "2019-09-05T19:00:00-05:00""2019-09-05T19:00:00-04:00"。如果未提供時區,則 Google 會使用 location 所指定活動地點的時區。線上活動沒有可供 Google 判斷活動開始時間的地點資訊,因此請務必提供時區。

最佳做法

  • 持續多日的活動:如果活動會持續多日,請指定開始日期和結束日期。如果您不知道時間,則請不要指定時間。

    建議使用

    "startDate": "2019-07-01T10:00:00-05:00",
    "endDate": "2019-07-26T17:00:00-05:00"

    建議使用

    "startDate": "2019-07-01",
    "endDate": "2019-07-26"

    不建議使用

    "startDate": "2019-07-01T00:00:00+00:00",
    "endDate": "2019-07-26T23:59:59+00:00"
  • 於特定時間開始的活動:如果活動會在特定時間開始 (例如當地時間下午 5 點),請使用 2019-07-20T17:00:00,並加入適當的世界標準時間偏移 (舉例來說,如果活動地點在加州,請使用 2019-07-20T17:00:00-07:00)。
  • 全天進行的活動:如果活動會舉行一整天,請勿為開始日期指定確切時間。舉例來說,您可以將 2019-08-15 同時設為全天活動的 startDateendDate
  • 開始時間未知的活動:如果您不知道活動的開始時間,請勿指定確切時間。舉例來說,您可以將 2019-08-15 同時設為活動的 startDateendDate

    建議使用"startDate": "2025-07-21"

    不建議使用"startDate": "2019-08-15T00:00:00+00:00"

    不建議使用"startDate": "2019-07-20T00:00:00"

Google 日期解讀示例

以下舉例說明 Google 如何解讀開始日期和時間:

開始日期和時間解讀結果
2019-08-15T00:00:00+00:00 Google 會將 startTime 解讀為 2019-08-14T17:00:00-07:00 (如果 location 設為加州) 或 2019-08-15T09:00:00 (如果location 設為韓國)。
2019-08-15T23:59:59+00:00 除非活動舉行地點為 GMT 時區,否則這並不表示 2019-08-15 這個日期的結束。Google 會將 startTime 解讀為 2019-08-15T16:59:59-07:00 (如果 location 設為加州) 或 2019-08-16T08:59:59 (如果 location 設為韓國)。
2019-07-10 這表示日期不受時區影響。如果用於 startDate 中,表示在 location 當地,活動會在該日期的某個時間點開始。如果用於 endDate 中,表示在 location 當地,活動會在該日期的某個時間點結束。
2019-07-20T00:00:00 這表示活動時間是在 2019-07-20 午夜 (以舉行地點的時區為準)。除非活動確實規劃在午夜開始,否則上述情況也很可能是錯誤的。

結構化資料類型定義

schema.org/Event 內提供 Event 的完整定義。

您的內容必須包含必要屬性,才能顯示在多元化搜尋結果中。您也可以加入建議的屬性,為內容增添更多相關資訊,提供更優質的使用者體驗。

必要屬性
location

PlaceVirtualLocation

舉行活動的地點。依照活動是在線上或實體地點舉行而定,要求的屬性也會不同:

  • 實體地點:如果活動在實體地點舉行,請將 @type 設為 Place,並新增 location.addresslocation.name 屬性。
  • 線上活動:如果活動在線上舉行,請將 @type 設為 VirtualLocation,並新增 location.url 屬性。
  • 混合線上和實體地點:如果活動同時包含線上和實體地點要素,請以巢狀陣列的方式同時納入線上和實體的巢狀地點屬性。例如:
    "location": [{
      "@type": "VirtualLocation",
      "url": "https://operaonline.stream5.com/"
    },
    {
      "@type": "Place",
      "name": "Snickerpark Stadium",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "100 West Snickerpark Dr",
        "addressLocality": "Snickertown",
        "postalCode": "19019",
        "addressRegion": "PA",
        "addressCountry": "US"
      }
    }]
location.address

PostalAddress

活動地點的詳細街道地址。只有在實體地點舉辦的活動才必須使用這個屬性。

不建議使用:Sydney

建議使用:Bennelong Point, Sydney NSW 2000, Australia

美國地址範例

"location": {
  "@type": "Place",
  "name": "Snickerpark Stadium",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "100 West Snickerpark Dr",
    "addressLocality": "Snickertown",
    "postalCode": "19019",
    "addressRegion": "PA",
    "addressCountry": "US"
  }
}

日本地址範例

您可以透過不同方式撰寫日本的地址,而 Google 仍然可以識別該地址。以下是將街道地址、縣市和國家/地區分別列於不同欄位的示例。

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "江東区青海1-10",
    "addressLocality": "東京",
    "addressCountry": "日本"
  }
}

以下是將街道地址與國家/地區列於不同欄位的示例。

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "東京都江東区青海1-10",
    "addressCountry": "日本"
  }
}

以下是將完整地址列在同一行的示例。

"location": {
  "@type": "Place",
  "name": "ダイバーシティ東京",
  "address": {
    "@type": "PostalAddress",
    "name": "東京都江東区青海 1-1-10 ダイバーシティ東京プラザ"
   }
}

地址的最佳做法

  • 如果活動會在多條街道上舉行,請定義開始的地點,並在說明中提供完整資訊。
  • 如果活動沒有明確的舉行地點,請使用城市名稱或最具代表性的地點。
  • 如果活動同時在多個地點舉行,請為各個地點建立不同的活動。
location.url

URL

能夠讓使用者參與活動的線上活動網址。只有在線上舉辦的活動才必須使用這個屬性。如果使用者必須先報名才能存取活動網址,請改為提供報名網址,讓使用者能夠報名參加活動。

"location": {
  "@type": "VirtualLocation",
  "url": "https://operaonline.stream5.com/"
}
name

Text

活動的完整名稱。

不建議使用:Bill Graham Civic Auditorium

不建議使用:**限時特惠 - 凱莎與麥可莫演唱會門票 $25 美元**

建議使用:凱莎與麥可莫的華麗冒險

建議使用:凱莎與麥可莫歌迷見面會

最佳做法

  • 請勿以活動類型做為活動名稱。舉例來說,「演唱會」就不是描述性的活動名稱。
  • 請勿加入無關的資訊,例如網址、價格或演出者。請針對這些值使用適當的屬性。
  • 在名稱中標明活動特殊的一面,幫助使用者更快做決定 (例如「特別開放演出者問答時間」)。
  • 請勿加入「歡迎立即購票」等促銷短語。
startDate

DateTime

活動的開始日期和開始時間,採 ISO-8601 格式。建議您加入日期和時間這兩項資訊,方便使用者找到符合自己時間表的活動。如果是線上活動,則必須加入世界標準時間 (UTC) 或格林威治標準時間 (GMT) 時區設定。

"startDate": "2025-07-21T19:00"
建議屬性
description

Text

活動的說明。請說明活動的所有詳情,以便使用者瞭解及參加活動。

最佳做法

  • 針對活動本身提供簡明扼要的說明。
  • 著重於說明活動詳細資訊,而非您網站上的功能。
  • 請勿重複日期和地點等其他資訊,這類資訊請分別加入相關屬性。
"description": "The Adventures of Kira and Morrison is coming to Snickertown in a can't miss performance."
endDate

DateTime

活動的結束日期和結束時間,採用 ISO-8601 格式。 請使用與 startDate 相同的格式。建議您加入日期和時間這兩項資訊,方便使用者找到符合自己時間表的活動。如果是線上活動,則必須加入世界標準時間 (UTC) 或格林威治標準時間 (GMT) 時區設定。

"endDate": "2025-07-21T23:00"
eventAttendanceMode

EventAttendanceModeEnumeration

指出這是線上活動、在實體地點舉行的現場活動,或是同時包含線上和現場的混合式活動。如果您不加入這項屬性,Google 會將活動模式的值解讀為 OfflineEventAttendanceMode,這表示 Google 會認為活動在實體地點舉行。請使用下列其中一個值:

以下示例中的活動完全在線上舉辦:

{
"@context": "https://schema.org",
"@type": "Event",
"eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
"location": {
  "@type":"VirtualLocation",
  "url": "https://operaonline.stream5.com/"
  }
}

以下示例中的活動部分在線上舉行,部分在實體地點舉行:

{
"@context": "https://schema.org",
"@type": "Event",
"eventAttendanceMode": "https://schema.org/MixedEventAttendanceMode",
"location": {
  "@type": "VirtualLocation",
  "url": "https://operaonline.stream5.com/"
},
{
  "@type": "Place",
  "name": "Snickerpark Stadium",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "100 West Snickerpark Dr",
    "addressLocality": "Snickertown",
    "postalCode": "19019",
    "addressRegion": "PA",
    "addressCountry": "US"
    }
  }
}
eventStatus EventStatusType

活動的狀態。如果您不使用這個欄位,Google 會將 eventStatus 解讀為 EventScheduled。支援的值如下所列。如果情況適用,您可以使用多個狀態,例如當活動同時改期並移至線上舉行時。

EventCancelled

這場活動已取消。

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventCancelled",
  "startDate": "2020-07-21T19:00"
}
EventMovedOnline

這場活動已從現場參與改為線上參與。

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventMovedOnline",
  "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
  "location": {
    "@type":"VirtualLocation",
    "url": "https://operaonline.stream5.com/"
  },
  "startDate": "2020-07-21T19:00"
}
EventPostponed

這場活動已延後到較晚的日期,但日期未定。請將原始日期保留在活動的 startDate 中,直到您得知活動將在何時舉行。得知新的日期資訊後,請將 eventStatus 變更為 EventRescheduled,並將 startDateendDate 更新為新的日期資訊。

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventPostponed",
  "startDate": "2020-07-21T19:00"
}
EventRescheduled

這場活動已改至較晚的日期舉行。請將 startDateendDate 更新為相應的新日期。或者,您也可以將 eventStatus 欄位標示為已改期,並新增 previousStartDate

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventRescheduled",
  "startDate": "2020-07-21T19:00",
  "endDate": "2025-07-21T23:00",
  "previousStartDate": "2025-03-21T19:00"
}
EventScheduled

這場活動如期舉行。這個值是所有活動的預設狀態。如果沒有設定 eventStatus,Google 會解讀為活動會如期進行。

{
  "@context": "https://schema.org",
  "@type": "Event",
  "eventStatus": "https://schema.org/EventScheduled",
  "startDate": "2020-07-21T19:00"
}
image

重複的 ImageObjectURL

活動或導覽的圖片/標誌網址。加入圖片有助使用者瞭解您的活動並進行互動。建議的圖片寬度為 1920px (寬度至少要 720px)。

其他圖片規範:

  • 每個網頁都必須包含至少一張圖片 (無論是否已加上標記)。Google 會根據顯示比例和解析度,選擇最適當的圖片顯示在搜尋結果中。
  • 圖片網址必須可供檢索和建立索引。如要測試 Google 能否存取您的網址,請使用網址檢查工具
  • 圖片內容與您標記的內容必須相符。
  • 圖片檔案必須使用 Google 圖片支援的格式
  • 為了獲得最佳結果,建議您使用以下長寬比,提供多張高解析度圖片 (寬度和高度相乘時至少 50K 像素):16x9、4x3 和 1x1。

例如:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
location.name

Text

活動地點或場所的全名。只有在實體地點舉辦的活動才建議使用這個屬性。

不建議使用:San Francisco, CA

建議使用:Bill Graham Civic Auditorium

最佳做法

  • 請勿使用城市名稱,除非該活動的舉辦地點為整座城市。
  • location.name 屬性必須是活動場地或地點的名稱,請勿重複輸入活動名稱。如果您不知道地點名稱,請勿使用這個屬性。
offers

Offer

具巢狀結構的 Offer,每種票券類型都要有一個這種屬性。
"offers": {
  "@type": "Offer"
}
offers.availability

Text

可使用下列其中一個值:

  • InStock:活動票券仍在販售中。
  • SoldOut:活動票券已售完。
  • PreOrder:活動票券已開放預購。
"offers": {
  "@type": "Offer",
  "availability": "https://schema.org/InStock"
}
offers.price

Number

票券的最低價格 (含服務費和相關費用)。如果票價有所變動,或票券已售罄,請務必更新這個屬性的值。

如果活動不需支付費用、手續費或服務費,請將 price 設為 0

"offers": {
  "@type": "Offer",
  "price": "30"
}
offers.priceCurrency

Text

包含 3 個英文字母的 ISO 4217 貨幣代碼。

"offers": {
  "@type": "Offer",
  "priceCurrency": "USD"
}
offers.validFrom

DateTime

ISO-8601 格式提供票券開始販售的日期和時間。只有限時優惠需要使用這項屬性。

"offers": {
  "@type": "Offer",
  "validFrom": "2024-05-21T12:00"
}
offers.url

網址

售票網頁的網址。

"offers": {
  "@type": "Offer",
  "url": "https://www.example.com/event_offer/12345_201803180430"
}

這個網址必須符合下列規範:

  • 導向的到達網頁必須讓人清楚看出其主要用途是供一般大眾購買特定活動的入場券。
  • 必須是活動網頁上可供使用者點選的連結。
  • 可由 Googlebot 檢索 (未遭 robots.txt 封鎖)。
organizer

OrganizationPerson

活動的主辦人或主辦機構。這對沒有任何場地資訊的線上活動來說特別重要。如果選擇使用 organizer,建議您新增以下屬性:

organizer.name

Text

活動主辦人的姓名或主辦機構的名稱。

organizer.url

URL

活動主辦方的網域網址。

performer

Person

參與活動演出的人員,例如藝術家和喜劇演員。請使用具巢狀結構的 PerformingGroupPerson,每位演出者都要有一個這種屬性。

"performer": {
  "@type": "PerformingGroup"
}
performer.name

文字

參與活動演出的人員姓名,例如藝術家或喜劇演員的名字。

"performer": {
  "@type": "PerformingGroup",
  "name": "Kira and Morrison"
}
previousStartDate

DateTime

如果活動已改期,請填入先前排定的活動開始日期。如果新增 previousStartDate,您也必須新增 eventStatus 屬性,並將 eventStatus 設為 EventRescheduled。請勿使用其他活動狀態。

如果是線上活動,則必須加入世界標準時間 (UTC) 或格林威治標準時間 (GMT) 時區設定。

如果是已改期的活動,startDate 屬性只能用於新排定的開始日期。在某些 (罕見的) 情況下,如果活動多次延期並改期,這個欄位可能會重複。

{
"@context": "https://schema.org",
"@type": "Event",
"previousStartDate": ["2020-03-21T19:00-05:00", "2020-03-20T19:00-05:00", "2020-03-21T19:00-05:00"],
"eventStatus": "https://schema.org/EventRescheduled",
"startDate": "2020-07-21T19:00-05:00"
}

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

疑難排解

如果無法順利導入結構化資料,或是偵錯時遇到困難,請參考下列資源。

  • 如果您使用內容管理系統 (CMS) 或者有他人代您處理網站事務,請向對方尋求協助。請務必將所有與問題相關的 Search Console 訊息都轉寄給對方,這些訊息會針對問題提供詳細說明。
  • Google 不保證採用結構化資料的功能一定會顯示在搜尋結果中。如要瞭解為何 Google 無法將您的內容顯示為複合式搜尋結果,請參閱結構化資料通用指南裡的常見原因清單。
  • 結構化資料可能含有錯誤。請查看結構化資料錯誤清單
  • 如果您的網頁遭到結構化資料專人介入處理處置,系統會忽略網頁上的結構化資料,但該網頁仍然會出現在 Google 搜尋結果中。請使用專人介入處理報告來修正結構化資料問題
  • 再次查看指南規範,確認您的內容是否符合規定。問題可能是因為垃圾內容或不當使用的標記所引起。不過,因為問題可能與語法無關,所以複合式搜尋結果測試無法找出問題所在。
  • 疑難排解:未出現複合式搜尋結果/複合式搜尋結果總數減少
  • 請等待一段時間,讓系統執行重新檢索和重新建立索引作業。在發布網頁後,Google 可能需要幾天時間才會找到網頁並進行檢索。如有關於檢索和索引建立作業的一般問題,請參閱 Google 搜尋檢索和索引常見問題
  • 前往 Google 搜尋中心論壇發文提問。

如果您的活動沒有出現在 Google 的活動搜尋服務中,或者因為垃圾資訊結構化標記而在 Search Console 中受到人工判決處罰,請按照常見問題說明來解決問題,並詳閱指南規範。如果問題仍然無法解決,請參閱活動常見問題,或是將您的問題張貼到 Google 搜尋中心論壇

活動地點缺漏或有誤

問題發生原因:Google 無法判讀您為 eventLocationaddressLocalityaddressRegion 屬性指定的值。 Google 嘗試將位置資訊與實際地點進行比對,但所提供的資訊不是缺漏就是有誤。

修正問題

  1. 確認結構化資料包含 eventLocationaddressLocalityaddressRegion 的值 (視地點不同而異,因為並非每個地點屬性都適用)。
  2. 確認 location.name 欄位中輸入的是地點名稱,如果該地點沒有名稱則留空。使用者常犯的錯誤是把活動名稱誤填入 location.name 欄位。
  3. 驗證修正結果:
    1. 開啟複合式搜尋結果測試
    2. 在「擷取網址」方塊中輸入活動資訊網址。
    3. 按一下 [驗證]
    4. 按一下 [預覽]。

      成功:複合式搜尋結果測試在 Google 搜尋預覽工具中顯示了正確的 eventLocation

      再試一次:複合式搜尋結果測試無法在 Google 搜尋預覽工具中正確顯示活動地點,而是顯示「False」。請確認您提供的是實際存在的地點。

Google 沒有為我的網站顯示售票選項

問題發生原因offers.url 屬性缺漏或不符合網址規定

修正問題

  1. 確認結構化資料包含 offers.url 屬性。
  2. 確認網址符合 offers.url網址規定
  3. 要求 Google 重新檢索您的網站
  4. 提交審查/重審申請

時間或日期有誤

問題發生原因:時間或日期有誤。常見錯誤包含未設定正確時區,或是指定了不正確的開始時間 (例如將開始時間設定在午夜)。

修正問題

  1. 依當地時區指定正確的時區設定。舉例來說,如果您的活動是在紐約 (UTC - 5) 的晚上 7 點開始 9 點結束,那麼 startDate 的值即為 2019-08-15T19:00:00-05:00endDate 的值則為 2019-08-15T21:00:00-05:00。如果您無法為活動輸入時區設定,請不要進行時區設定 (舉例來說,使用 2019-08-15T19:00:00 即可)。
  2. 確認開始時間或結束時間正確無誤。常見錯誤是將活動開始時間設在午夜,而實際上活動卻非午夜開始。如果是全天活動,或是開始時間尚未公告,建議指定活動日期就好。舉例說明如下:

    建議使用2019-07-20

    不建議使用2019-07-20T00:00:00

    不建議使用2019-08-15T00:00:01+00:00

    不建議使用2019-08-15T00:00:00+00:00