Diese Seite wurde von der Cloud Translation API übersetzt.

Assistant-Links

Du kannst eine URL generieren, die direkt mit einem bestimmten Intent deiner Aktion verknüpft ist. Nutzer, die in einem Webbrowser oder einem mobilen Browser auf einen Assistant-Link (früher als Aktionslinks bezeichnet) klicken, werden auf ihrem Gerät zu Assistant weitergeleitet. Dort können sie direkt mit deiner Aktion interagieren.

Assistant-Links unterscheiden sich von Verzeichnis-Weblinks, die Nutzer zu deiner Aktionsseite im Assistant-Verzeichnis weiterleiten.

Hier sind einige Situationen, in denen Assistant-Links hilfreich sein können:

Links zu sprachgestützten Anleitungen über eine Website mit Anleitung
Nutzer über eine Hilfeseite mit einem Kundensupport verknüpfen.
Sie können Nutzer mit einem Update-Intent verknüpfen, um zukünftige Aktualisierungen zu aktivieren.

Assistant-Link generieren

Sie können in Ihrem Projekt in der Actions Console Assistant-Verknüpfungen generieren. Assistant-Verknüpfungen sind über alle Bereitstellungskanäle (Alpha, Beta und Produktion) verfügbar. Wenn Ihr Assistant-Link beispielsweise in der Alphaversion Ihrer Aktion aktiviert ist, ist der Link für Alphatester verfügbar.

So generieren Sie die URL für eine Aktion:

Gehen Sie in der Actions Console zu Bereitstellen > Assistant-Verknüpfungen.
Wählen Sie unter Intent den Intent aus, für den Sie einen Link generieren möchten.
Aktivieren Sie die Option Möchten Sie die Verknüpfung für Intent_name aktivieren?.
Optional: Geben Sie im Abschnitt Kampagnenparameter alle Informationen, die Sie zusätzlich im Link erfassen möchten, als URL-Parameter ein.
Optional: Geben Sie einen Titel der Verknüpfung ein. Verwende diesen Titel, um die Aktion zu beschreiben. Wenn der Nutzer beispielsweise über eine Aktion einen Transaktionsvorgang abschließt, um Tickets für ein Konzert zu kaufen, könnte der Linktitel „Konzerttickets kaufen“ lauten.

Nachdem Sie Ihre Informationen eingegeben haben, können Sie die generierte URL oder das generierte Code-Snippet für den Assistant-Link aufrufen und kopieren. Über den Assistant-Link kannst du Nutzer zu dieser Aktion weiterleiten.

Assistant-Verknüpfungen testen

Sie können Assistant-Links für jeden Intent (Haupt- oder benutzerdefinierten Parameter mit oder ohne Parameter) über den Simulator oder auf einem Gerät testen.

So testen Sie Ihren Assistant-Link auf einem Gerät:

Generieren Sie den Assistant-Link in der Actions Console.
Senden Sie den Assistant-Link als URL in einer E-Mail, einer Chatnachricht oder in einem anderen Format.
Melden Sie sich auf einem Gerät mit integriertem Assistant in Assistant mit demselben Konto an, mit dem Sie Ihr Actions-Projekt erstellt haben.
Klicken Sie auf demselben Gerät auf den Assistant-Link, den Sie an sich selbst gesendet haben.

Nachdem Sie die erwartete Verknüpfungsfunktion von Assistant bestätigt haben, müssen Sie die Aktion noch einmal bereitstellen, damit die Verknüpfung für Ihre Nutzer verfügbar ist.

Parameter für Assistant-Verknüpfungen

Assistant-Links können in der URL optional einen Intent und Parameter enthalten. Verwenden Sie den Bereich Kampagnenparameter, um Kampagnenparameter hinzuzufügen.

Wenn eine Assistant-Verknüpfung keine zusätzlichen Parameter enthält, verknüpft Google Assistant den Intent MAIN (actions.intent.MAIN) Ihrer Aktion mit folgendem Verhalten:

Wenn Sie den Intent MAIN im Assistant-Link nicht explizit aktiviert haben, gleicht Assistant den Haupt-Intent ohne Parameter ab, ähnlich wie bei „Mit app_name sprechen“.
Wenn Sie den Intent MAIN explizit aktiviert haben, übergibt Assistant die Parameter an Ihre Aktionen.

Hier ein Beispiel für eine Assistant-Link-URL mit dem Intent MAIN ohne zusätzliche Parameter:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

Spezifikation der Assistant-Link-URL

Die allgemeine Syntax für die URL eines Assistant-Links lautet:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

Die URL-Parameter, die Sie festlegen können, sind in der folgenden Tabelle beschrieben:

URL-Parameter	Beschreibung
`$action_id`	Die numerische Kennung der Aktion.
`$intent`	Vollständiger Name eines integrierten oder Nutzer-Intents.
`$param`	Vollständiger Name eines Intent-Parameters, der im Aktionspaket angegeben ist.
`$value`	URL-codierter Wert des für `$param` im Aktionspaket deklarierten Typs.
`$utm_param`	Liste mit einem oder mehreren UTM-Parametertypen. Gültige Werte sind: `utm_source`, `utm_medium`, `utm_campaign`, `utm_term` und `utm_content`.
`$utm_value`	Stringwert des UTM-Parameters.

Assistant-Link-URLs mit integrierten Intents

Wenn der Assistant-Link einen integrierten Intent enthält (der Intent beginnt mit actions.intent.), versucht Google Assistant, alle integrierten Intent-Parameter in der URL zu extrahieren und an Ihre Aktion weiterzugeben. Alle Parameter, die Assistant als integrierte Intent-Parameter nicht versteht, werden entfernt.

Bei Unterhaltungsaktionen sendet Assistant diese Parameter als Teil der AppRequest-Nachricht an die Auftragsausführung.

Das folgende Beispiel zeigt, wie Sie eine Assistant-Link-URL angeben können, die einen integrierten Intent mit einem einzigen Intent-Parameter enthält:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

Verknüpfungs-URLs von Assistant mit Nutzerabsichten

Für Nutzer-Intents extrahiert Google Assistant nur die Parameter, die von Ihrer Aktion als Teil des Intents definiert wurden, und verwirft alle anderen Parameter.

Das folgende Beispiel zeigt, wie Sie eine Assistant-Link-URL mit einem Nutzer-Intent angeben können:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

Für die obige Beispiel-URL fügt Assistant in AppRequest ein JSON-Objekt hinzu:

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

Link-URLs für Assistant mit UTM-Parametern

UTM-Parameter sind Strings, die Google Assistant an deine Aktion sendet, wenn Nutzer auf einen Assistant-Link klicken. Sie können die in diesen Strings enthaltenen Informationen später für Analysen verwenden.

Zu den UTM-Parametern, die Assistant an Ihre Aktion sendet, gehören:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

Das folgende Beispiel zeigt, wie Sie eine Assistant-Link-URL mit UTM-Parametern angeben können:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

Für die obige Beispiel-URL fügt Assistant der Nachricht AppRequest die folgenden Argumente hinzu:

argument {
  name: 'utm_source',
  raw_text: 'Google',
  text_value: 'Google',
}
argument {
  name: 'utm_medium',
  raw_text: 'email',
  text_value: 'email',
}
argument {
  name: 'utm_campaign',
  raw_text: 'holiday sale',
  text_value: 'holiday sale',
}

Rich Assistant-Links

Rich Assistant-Links bieten dir die Möglichkeit, mithilfe von assist.js die Sichtbarkeit deiner Aktion auf deiner Website zu erhöhen. Nutzer können die Aktion ausprobieren und ihr Google-Konto über die Kontoverknüpfung mit Ihrem Dienst verknüpfen.

Wenn ein Nutzer Ihre Website besucht, sieht er die Schaltfläche „Mit Google Assistant testen“, durch die der Link für Rich Assistant-Verknüpfungen ausgelöst wird.

Wenn du die Kontoverknüpfung für deine Aktion aktivierst, können Nutzer auf allen ihren Geräten mit integriertem Assistant auf deine Aktion zugreifen. Darüber hinaus können Nutzer ihr Konto mit Ihrem Dienst mit ihrem Google-Konto verknüpfen, um die Nutzung zu personalisieren.

Bei der Kontoverknüpfung wird für Rich Assistant-Links Ihre Autorisierungs-URL verwendet, die Sie in Ihrem Projekt in der Actions Console festlegen. Weitere Informationen finden Sie in der Dokumentation zur Kontoverknüpfung.

Voraussetzungen

Wenn Sie Rich Assistant-Links verwenden möchten, benötigen Sie Folgendes:

Lokale Entwicklung

Führen Sie die folgenden Schritte aus, um einen Rich Assistant-Link auf Ihrer Website einzufügen:

Füge die folgende JavaScript-Bibliothek auf deiner Seite ein und ersetze <PROJECT_ID> durch deine Actions-Projekt-ID:
```
<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>
```
Fügen Sie das folgende HTML-Tag auf Ihrer Seite ein. Dadurch wird die Inline-Schaltfläche „Jetzt mit Google Assistant testen“ geladen:
```
<google-assistant-link-group>
  
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>
```
Hinweis: Wenn ein Assistant-Nutzer nicht angemeldet ist, löst er den ersten Assistant-Link aus oder leitet den Nutzer zur Assistant-Verzeichnisseite für Ihre Aktion weiter.

Proaktives Auslösen

Wenn der Rich Assistant-Linkfluss automatisch gestartet werden soll, wenn Nutzer deine Seite zum ersten Mal besuchen, verwende das <google-assistant-proactive-link>-Tag. Wenn Sie dieses Tag anwenden, wird der Link ohne Nutzer beim ersten Besuch aktiviert, ohne dass die Inline-Schaltfläche ausgewählt wird.

Füge dem Tag für die Assistant-Verknüpfungsgruppe ein id hinzu:

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

Platzieren Sie ein <google-assistant-proactive-action-link>-Tag auf Ihrer Webseite und legen Sie das Attribut groupId auf id fest:

<google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

<google-assistant-proactive-link
groupId="my-group">
</google-assistant-proactive-link>

Deployment

Rich Assistant-Links funktionieren nur für Domains, die Ihnen gehören und die bei Google bestätigt wurden. Bei der lokalen Entwicklung wird diese Anforderung umgangen, indem Sie Zugriff auf das Actions-Projekt haben, in Ihrem Google-Konto angemeldet sind und den Abfrageparameter dev=true in Ihrem Skript-Tag festlegen.

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

So stellst du deine Aktion mit den Rich Assistant-Links bereit:

Registrieren Sie Ihre öffentliche Domain in der Actions Console unter Bereitstellen > Markenüberprüfung > Website verknüpfen.

Entfernen Sie den Abfrageparameter dev=true aus dem Skript:

<script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

Einschränkungen und Best Practices

Mit den folgenden Einschränkungen und Best Practices kann die Assistant-Link-URL außerhalb des Verzeichnisses oder anderer Google-Dienste verteilt und referenziert werden:

Du kannst weiterhin alle deine Assistant-Verknüpfungen unterstützen. Wenn du einen Assistant-Link teilst, der später nicht mehr funktioniert, wird dein Actions-Projekt möglicherweise als fehlerhaft markiert und entfernt.
Das Veröffentlichen eines Links bedeutet, dass Sie das Auslösen aus nicht vertrauenswürdigen Quellen unterstützen. Bei allen verknüpften Aktionen müssen Sie sich explizit an den Nutzer wenden, bevor Sie reale Aktionen ausführen. Beispielsweise sollte eine Aktion, die eine Smart-Home-Appliance deaktiviert, den Nutzer fragen: Möchten Sie $applianceName wirklich ausschalten?

In diesem Zusammenhang ist eine tatsächliche Aktion jede Aktion, die sich auf die Dienste, Daten, Geräte, Netzwerke, Computer oder APIs des Nutzers auswirkt. Beispiele: Senden einer E-Mail, Ausführen einer Transaktion, Ändern des Status einer Smart-Home-Appliance, Erstellen eines Abos oder Aktualisieren von Inhalten