Aktionen deklarieren

Eine Aktion in schema.org steht für ein Verb oder eine Aktivität, die für strukturierte Daten ausgeführt werden kann. Es werden mehrere Arten von Aktionen unterstützt und sie können alle mit ähnlichen strukturierten Daten definiert werden.

Go-To-Aktionen

Wenn Sie Ihren Inhalten mit schema.org-Entitäten Markup hinzufügen, können Sie für diese Go-To-Aktionen hinzufügen. Wenn Sie beispielsweise aus einer EmailMessage-Entität einen ViewAction-Go-To-Link erhalten möchten, geben Sie das Attribut potentialAction der E-Mail wie im folgenden Beispiel ein:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ViewAction",
    "target": "https://watch-movies.com/watch?movieId=abc123",
    "name": "Watch movie"
  },
  "description": "Watch the 'Avengers' movie online"
}
</script>

Mikrodaten

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="name" content="Watch movie"/>
  </div>
  <meta itemprop="description" content="Watch the 'Avengers' movie online"/>
</div>

Beachte, dass das oben genannte Markup automatisch von anderen E-Mail-Clients ignoriert wird, die keine Schemas in E-Mails unterstützen.

Mobile Deeplinks

Go-To-Aktionen können auch direkt zu Inhalten in nativen mobilen Apps auf Android und iOS: Für Deeplink zu einer App zusätzliche target-URLs, die mit den Schemas android-app:// und ios-app:// codiert sind, wie unten gezeigt:

JSON-LD

"target": [
  “<web url>”,
  “android-app://<android package name>/<scheme>/<host>/<path+query>”,
  “ios-app://<App store ID>/<scheme>/<host><path+query>"
]

Mikrodaten

<link itemprop="target" href="<web url>"/>
<link itemprop="target" href="android-app://<android package name>/<scheme>/<host>/<path+query>”/>
<link itemprop="target" href="ios-app://<App store ID>/<scheme>/<host>/<path+query>"/>

Das vorherige EmailMessage-Beispiel wird erweitert:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "name": "Watch movie",
  ... information about the movie ...
  "potentialAction": {
    "@type": "ViewAction",
    "target": [
      "https://watch-movies.com/watch?movieId=abc123",
      "android-app://com.watchmovies.app/http/watch-movies.com/watch?movieId=abc123",
      "ios-app://12345/movieapp/watch-movies.com/watch?movieId=abc123"
    ]
  }
}
</script>

Mikrodaten

<div itemscope itemtype="http://schema.org/EmailMessage">
  <meta itemprop="name" content="Watch movie"/>
  ... information about the movie ...
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <meta itemprop="target" content="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="android-app://com.watchmovies.android/http/watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="ios://12345/movieapp/watch-movies.com/watch?movieId=abc123"/>
 </div>
</div>

Wenn der Nutzer Ihre App nicht installiert hat, wird er zu der von Ihnen angegebenen Web-URL weitergeleitet.

In-App-Aktionen

In-App-Aktionen werden direkt in Gmail ausgeführt, ohne dass der Nutzer auf eine andere Website weitergeleitet wird. In-App-Aktionen werden wie Go-To-Aktionen deklariert, enthalten aber zusätzliche Informationen, anhand derer User-Agents wie Gmail die Aktion ganz einfach direkt bearbeiten können.

Anstatt eine Aktion mit einem target zu deklarieren, müssen Sie ein HttpActionHandler für die Aktion mit der richtigen Konfiguration deklarieren.

Sie können beispielsweise eine Bestätigungsschaltfläche zu E-Mails hinzufügen, auf denen Nutzer etwas bestätigen, bestätigen und bestätigen müssen. Sobald der Nutzer auf die Schaltfläche klickt, wird von Google eine HTTP-Anfrage an Ihren Dienst gesendet, in der die Bestätigung erfasst wird. Mit ConfirmAction kann nur einmal interagiert werden.

Im folgenden Beispiel wird einer E-Mail zu einer Spesenabrechnung die Schaltfläche ConfirmAction hinzugefügt:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Approve Expense",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://myexpenses.com/approve?expenseId=abc123"
    }
  },
  "description": "Approval request for John's $10.13 expense for office supplies"
}
</script>

Mikrodaten

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Approve Expense"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
    </div>
  </div>
  <meta itemprop="description" content="Approval request for John's $10.13 expense for office supplies"/>
</div>

Ablaufende Aktionen

In vielen Fällen sind Maßnahmen nur für einen begrenzten Zeitraum relevant. Aktionen, die mit Elementen mit bekanntem Datum verknüpft sind, z. B. Reisereservierungen, laufen automatisch ab. Nach Ablauf der Reise wird diese Aktion in Gmail nicht mehr angezeigt.

Ablaufzeiten können auch explizit Aktionen hinzugefügt werden. Beispielsweise ist eine Aktion zum Ausschneiden eines Gutscheins oder Speichern eines Angebotscodes möglicherweise nur für eine begrenzte Zeit gültig. Um das Zeitfenster für die Anzeige einer Aktion festzulegen, legen Sie die Eigenschaften startTime und endTime der Aktion fest:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Save coupon",
    "handler":  {
       "@type": "HttpActionHandler",
       "url": "https://my-coupons.com/approve?couponId=abc123"
    },
    "startTime": "2015-06-01T12:00:00Z",
    "endTime": "2015-06-05T12:00:00Z"
  }
}
</script>

Mikrodaten

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Save coupon"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://my-coupons.com/approve?couponId=abc123"/>
    </div>
    <meta itemprop="startTime" content="2015-06-01T12:00:00Z" />
    <meta itemprop="endTime" content="2015-06-05T12:00:00Z" />
  </div>
</div>

Weiterführende Literatur

Weitere Informationen zu Aktionen finden Sie unter: