Best Practices zur Einstellung von Produkten und Diensten

Dieser Leitfaden enthält Benachrichtigungen für Nutzer und Migrationspfade für Konversationsaktionen, die am 13. Juni 2023 eingestellt werden. Es werden folgende Bereiche abgedeckt:

• Einstellungsphasen: Hier erfährst du, wie Aktionen heute und nach der Einstellung funktionieren.
• Empfohlene Benachrichtigungen: Benachrichtigungen, die Sie Ihren Aktionen hinzufügen können
• Mögliche Migrationspfade: Optionen, wie Nutzer nach der Einstellung aufbewahrt werden.

Hinweis: Diese Anleitung dient nur als Orientierungshilfe. Je nach Art der Konversationsaktion und Sprache können bestimmte rechtliche Erfordernisse gelten. Bitte überprüfen Sie Ihre eigenen rechtlichen Erfordernisse.

Proaktive Blogposts (optional)

Jede Aktion, jede Agentur und jedes Unternehmen ist anders. Zusätzlich zur Aktualisierung deiner Aktionen mit den in diesem Leitfaden empfohlenen Botschaften kannst du auch einen Blogpost veröffentlichen, in dem du proaktiv auf die folgenden häufigen Bedenken von Nutzern eingehst:

• Was genau ist geplant?
• Wann ändert sich die Nutzung?
• Wie kann ich weiterhin ähnliche Funktionen erhalten?

Wir empfehlen, bei Ankündigungen zu veralteten Versionen Migrationspfadoptionen anzugeben. Sie können Ihren Beitrag per E-Mail, Newsletter und soziale Medien teilen.

Einstellungsphasen

In der folgenden Tabelle wird beschrieben, wie sich Konversationsaktionen heute verhalten, wie sie sich nach dem Einstellungsdatum ändern, und empfohlene Aktualisierungen, die Sie vornehmen können, um Ihre Nutzer zu informieren.

	Vor dem Datum der Einstellung (13. Juni 2023)	Nach der Einstellung
Aktionsverhalten	Bestehende Action-Umgebung	Aktionsaufruf deaktiviert
Empfohlene Entwickler-Updates	Einstellungsbenachrichtigung zu Aktionen hinzufügen (Empfehlungen)	–
UX-Updates von Google	Beim Aufruf zeigt Google möglicherweise einen Text-in-Sprache-Hinweis an, dass die Aktion nach dem Einstellungsdatum nicht mehr verfügbar ist.	Beim Aufruf stellt Google eine Sprachausgabe bereit, die den Nutzer darüber informiert, dass diese Aktion nicht mehr verfügbar ist.

Wenn du deine Aktion vor dem Einstellungsdatum nicht proaktiv deaktivierst, erhalten Nutzer, die sie aufrufen, eine von Google bereitgestellte Text-in-Sprache-Benachrichtigung. Der genaue Wortlaut dieser Benachrichtigung steht noch nicht fest. Der endgültige Wortlaut enthält jedoch keine Informationen zur Migration zu Ihren Nutzern.

Hinweis: Wenn deine Aktion Transaktionen bereitstellt, solltest du zusätzliche Benachrichtigungen zu Transaktionselementen wie Abos, Reservierungen, Erstattungen, Kontobelastungen usw. in Betracht ziehen.

Empfohlene Werbebotschaften

Die beste Möglichkeit, Nutzer über den bevorstehenden Sonnenuntergang zu informieren, besteht darin, sie jedes Mal zu benachrichtigen, wenn sie Ihre Aktion aufrufen. Sie können diese Gelegenheit auch nutzen, um den Kunden über Migrationspfade mit ähnlichen Funktionen zu informieren.

• Zweck der Mitteilungen:Nutzer werden über die bevorstehende Änderung und über verfügbare Migrationsoptionen informiert.

• Zeitrahmen für Mitteilungen:Beginnen Sie mit der Benachrichtigung der Nutzer mindestens 30 Tage vor der Einstellung (13. Mai 2022 bis 13. Juni 2022).

Sonnenuntergangsabfragen verarbeiten

Um spezifische Fragen zur Einstellung Ihrer Nutzer zu beantworten, erstellen Sie einen neuen globalen benutzerdefinierten Intent, der die folgende Formulierung verwendet:

• „Wir deaktivieren Action Name am date. Weitere Informationen finden Sie unter short link | migration path message."

Hinweis: Fügen Sie dem Intent eine Basic Card hinzu, wenn Sie einen Link zu weiteren Details hinzufügen möchten. Hier findest du das Codebeispiel für die Basic Card. Links zum Web werden auf Smart Displays nicht unterstützt.

Interaktive Leinwand

Wenn deine Aktion Interactive Canvas verwendet, füge der Canvas-Ladeseite ein Benachrichtigungsbanner mit dem folgenden Beispieltext hinzu:

• „Action Name wird am date deaktiviert. Weitere Informationen findest du unter shortlink url.“
• „Action Name wird am date, den migration path message, ausgeschaltet.“

Optionale Kommunikation

Es gibt weitere Möglichkeiten, Ihre vorhandenen Aktionen zu aktualisieren, um Nutzer über die anstehende Änderung zu informieren. Sie können Ihren vorhandenen Aktionsbenachrichtigungen Hinweise zu veralteten Versionen als Suffix hinzufügen:

• „existing message. Ich möchte dich noch daran erinnern, dass Action Name am date (wird/wird ausgeschaltet) wird.“
• „existing message. Außerdem wollte ich Ihnen nur mitteilen, dass Action Name (wird ausgeschaltet | heruntergefahren) auf date migration path wird.“

Du kannst auch allen Sonderfunktionen, die von deiner Aktion implementiert werden, Hinweise hinzufügen:

• Deeplink-Aufrufe: Hier wird eine Basiskarte mit Informationen angezeigt (Beispiel).

• Last prompt-Nachrichten: Sie können eine last prompt-Meldung (Beispiel) zu jedem der folgenden Aufforderungstypen hinzufügen:

  • Integrierte Intents (BII). Gilt für das Play-Spiel, das Storytelling und den Bildungsbereich.
  • Vorschläge für Abläufe.
  • Willkommensaufforderungen

• Exit-Aufforderungen: Sie können den Exit-Aufforderungen auch eine spezielle last prompt-Nachricht (Beispiel) hinzufügen (actions.intent.CANCEL).

• Push-Benachrichtigungen: Fügen Sie allen Push-Benachrichtigungen, die mit Action Builder oder Dialogflow erstellt wurden, den folgenden Textvorschlag hinzu:

  • „Erinnerung: Action Name wird am date eingestellt. Weitere Informationen findest du unter shortlink url.“
  • „Erinnerung: Action Name wird am date, den migration path message, deaktiviert.

Mögliche Migrationspfade

Auch wenn es keinen entsprechenden Migrationspfad für Ihre Konversationsaktion gibt, sollten Sie die folgenden Optionen basierend auf Ihren Nutzeranforderungen und verfügbaren Entwicklerressourcen in Betracht ziehen.

Medieninhalte

Mit Media Actions können Nutzer Ihre Inhalte in Google Assistant entdecken und die Wiedergabe der Inhalte direkt in Ihrer App starten. Mit dieser Beispielbotschaft können Sie Nutzer beim Wechsel zu Medienaktionen unterstützen:

• „Du kannst uns jederzeit finden, indem du sagst: Hey Google, spiel Media Brand Name ab.“
• „Sie können uns jederzeit finden, wenn Sie sagen: Hey Google, ‚Titel‘ auf Media Brand Name anhören.“

Medienaktionen unterscheiden sich von Konversationsaktionen:

• Bei Media Actions „interagiert“ der Nutzer nicht direkt mit dem Drittanbieter, sondern über Assistant mit dem Drittanbieter.
• Media Actions sind nicht dialogorientiert und unterstützen nur Anfragen für einzelne Aufnahmen.

Android-Apps

App-Aktionen von Assistant sind eine Android-Funktion, mit der Nutzer Android-Apps über Assistant per Sprachbefehl starten und steuern können. Mit diesen Beispielnachrichten können Sie Nutzer über Ihre App-Aktionen informieren:

• „Ihr könnt uns jederzeit finden, indem ihr ‚Hey Google, öffne App Name‘ sagt.“
• „Sie können unsere Android-App öffnen, indem Sie „Hey Google, BII auf App Name“ sagen.
• „Unsere Android-App lässt sich installieren, indem Sie sagen: „Hey Google, öffne App Name.“

Bei App-Aktionen gibt es einige Unterschiede zu Konversationsaktionen:

• App Action BIIs bieten eingeschränkte Sprach- und Gebietsunterstützung.
• Zum Starten von App-Aktionen ist eine Android-App erforderlich.
• Smart Displays unterstützen keine App Actions.
• App Actions sind nicht dialogorientiert und unterstützen nur Einzelabfragen.

Hardware

Mit dem Smart Home von Google können Entwickler Geräte mit Assistant per Sprachbefehl steuern. Mit dieser Beispielbotschaft kannst du Nutzer über deine Smart-Home-Aktionen informieren:

• "Sie können jederzeit über die device name, verfügbar unter store, mit uns sprechen."
• „Du kannst über device name in der Google Home App mit uns sprechen“

Im Vergleich zu Konversationsaktionen unterscheidet sich Smart Home in folgenden Punkten davon:

• Smart Home kann nur auf kompatiblen Geräten hinzugefügt werden.
• Smart Home ist nicht dialogorientiert und unterstützt nur Einzelabfragen.

Chat-Agents

Für den Austausch mit Nutzern über Chatbots sind die folgenden Produkte verfügbar:

• Dialogflow CX bietet einen erweiterten Agent-Typ für große und komplexe Kundenservicemitarbeiter. Es bietet Integrationen in Dialogflow CX Phone Gateway, Dialogflow Messenger, Messenger von Facebook, LINE und mehr. Hier finden Sie die vollständige Integrationsliste.
• Dialogflow EX bietet einen Standard-Agent-Typ, der für kleinere, einfachere Agents geeignet ist. Sie bietet Integrationen für Slack, Telegram, LINE, Messenger von Facebook, Workplace von Meta und mehr. Hier finden Sie die vollständige Integrationsliste.

Mit den folgenden Beispielnachrichten können Sie Nutzer über Ihre Chat-Agents informieren:

• „Wenn du weitere Unterstützung benötigst, ruf bitte support number an.“
• „Für zukünftige Unterstützung besuchen Sie unsere Website unter short link url.“
• „Wenn Sie zukünftiges Feedback erhalten möchten, können Sie mit uns über den Slack-Kanal Company Name chatten.“

Chat-Agent-Dienste unterscheiden sich im Vergleich zu Konversationsaktionen gegenüber den Konversationsaktionen:

• Agents werden auf Smart Displays nicht unterstützt.
• Kundenservicemitarbeiter können Assistant nicht einbinden.

Customer Care

Mit Chatbots, Sprachbots und Telefonie-Helpdesks können Sie schneller auf Kundenbedürfnisse eingehen. Diese sind in Contact Center AI-Angebote wie Agent Assist und CCAI Insights eingebunden. Mithilfe dieser Beispielbotschaften können Sie Nutzer über Optionen zur Kundenbetreuung informieren:

• Wenn Sie weitere Unterstützung benötigen, rufen Sie uns unter support number an.“
• „Für zukünftige Unterstützung besuchen Sie unsere Website unter short link url.“
• Falls Sie zukünftiges Feedback erhalten möchten, können Sie über den Slack-Kanal „Name des Unternehmens“ mit uns chatten.“

Die Kundenbetreuung unterscheidet sich gegenüber den Konversationsaktionen gegenüber den Konversationsaktionen etwas:

• Auf Smart Displays werden sie nicht unterstützt.
• Sie können nicht mit Assistant verknüpft werden.

Websites

Sie können Nutzer auf Funktionen Ihrer Website weiterleiten. Mithilfe dieser Beispielbotschaften können Sie Nutzer über Ihre Weboptionen informieren:

• „Für zukünftige Unterstützung besuchen Sie unsere Website unter short link url.“

Websites weisen im Vergleich zu Konversationsaktionen folgende Unterschiede auf:

• Smart Displays unterstützen keine Websites.
• Websites können nicht direkt in Assistant integriert werden

Hinweis:Mit Aktionen aus Webinhalten kannst du automatisch Aktionen aus dem Markup für Webinhalte generieren.

Codebeispiele

Mit diesen Codebeispielen können Sie Antworten im Zusammenhang mit dem Ablauf Ihrer Konversationsaktionen erstellen.

Beispiel für eine Basiskarte

YAML

candidates:
  - first_simple:
    variants:
    - speech: >-
      We are turning off  on . For more details check out 
    text: >-
      We are turning off  on . For more details check out 
    content:
      card:
        title: Turning Off 
        subtitle: 
        text: >-
          `We are turning off  on . For more details check out .`
        button:
          name: Learn more
          open:
            url: 
    

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "We are turning off  on . For details, check out .",
            "text": "We are turning off  on . For details, check out ."
          }
        ]
      },
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "`We are turning off  on . For details, check out .`",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      }
    }
  ]
}
      

Node.js

app.handle('Card', conv => {
  conv.add('We are turning off  on . For details, check out .');
  conv.add(new Card({
    "title": "Turning Off ",
    "subtitle": "",
    "text": "Card Content",
    "button": new Link({
      name: 'Learn more',
      open: {
          url: '',
        },
    })
  }));
});
    

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "We are turning off  on . For, details check out .",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      },
      "firstSimple": {
        "speech": "We are turning off  on . For details, check out .",
        "text": "We are turning off  on . For details, check out ."
      }
    }
  }
}
      

Beispiel für letzte Aufforderung

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on 
          text: Also, just reminding you that  will be turning off on 

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on ",
            "text": "Also, just reminding you that  will be turning off on "
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on ',
    text: 'Also, just reminding you that  will be turning off on '
  }));
});

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on ",
        "text": "Also, just reminding you that  will be turning off on "
      }
    }
  }
}

Beispiel für letzte Aufforderung (Beenden/Abbrechen)

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on . Bye.
          text: Also, just reminding you that  will be turning off on . Bye.

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on . Bye.",
            "text": "Also, just reminding you that  will be turning off on . Bye."
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on . Bye.',
    text: 'Also, just reminding you that  will be turning off on . Bye.'
  }));
});

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on . Bye.",
        "text": "Also, just reminding you that  will be turning off on . Bye."
      }
    }
  }
}

---