API v1.11.0

Kapitel 02 von 07

Von der Marke zum Live-Agent

Bevor ein Agent an beliebige Empfänger senden darf, durchläuft er einen festen Weg: Marke anlegen, Agent anlegen, mit Testnummern ausprobieren, Verifizierung durch Google, Freigabe (Launch) durch die Netzbetreiber. Dieses Kapitel beschreibt die Abfolge und die Status, die Sie dabei in der Box sehen. Was Sie an Inhalten dafür bereitstellen müssen, steht in Kapitel 3; wie der Ablauf automatisiert werden kann, in Kapitel 6.

Schritt 1: Die Marke

Eine Marke steht für die juristische Person, die Nachrichten verschickt. Jeder Mandant startet mit einer Marke bei Google. Wer mehrere Endkunden betreut, kann weitere Marken anlegen und Agents gezielt darunter einordnen.

Zur Marke gehören der Verifizierungskontakt (Ansprechpartner bei Ihnen und beim Betreiber sowie Ihre Webseite) und mindestens ein Nachweisdokument als PDF, in der Regel die Brand Authorization Letter, mit dem Sie bestätigen, dass der Betreiber in Ihrem Namen Nachrichten verschicken darf. Beides pflegen Sie selbst oder über den Betreiber; an Google übermittelt wird es erst mit der Verifizierung.

Achtung: Ein Agent gehört dauerhaft zu der Marke, unter der er angelegt wurde. Die Marke ist Teil seines Namens bei Google und kann nachträglich nicht geändert werden. Ein Agent unter der falschen Marke lässt sich nur durch Neuanlage korrigieren.

Schritt 2: Der Agent

Ein neuer Agent startet im Status DRAFT. In diesem Zustand existiert er bereits bei Google, kann aber nur an Testnummern senden, die eine Einladung angenommen haben. Beim Anlegen holt Google Logo und Titelbild von den angegebenen Adressen ab; sind sie nicht öffentlich erreichbar, wird der Agent nicht angelegt.

Schritt 3: Testerinnen und Tester

Solange ein Agent noch nicht freigegeben ist, stellt Google Nachrichten nur an registrierte Testnummern zu. Sie registrieren eine Nummer am Agent, Google schickt per SMS eine Einladung auf das Gerät, und sobald die Person sie annimmt, wechselt ihr Tester-Status auf ACCEPTED. Erst dann kommen Nachrichten des Agents dort an, und erst dann erzeugt eine Antwort dieser Person eine Weiterleitung an Ihr System.

Der Status einer Einladung (INVITED, PENDING, ACCEPTED, DECLINED) lässt sich jederzeit bei Google nachfragen. Testnummern müssen in den für Ihren Mandanten erlaubten Ländern liegen.

Hinweis: Wer als Tester registriert ist, bleibt auch nach dem Launch erreichbar. Nachrichten an Tester vor dem Launch werden nicht abgerechnet.

Schritt 4: Verifizierung

Mit der Verifizierung prüft Google, ob der Agent rechtmäßig zu seiner Marke gehört. Dafür braucht es den vollständigen Verifizierungskontakt der Marke, die Nachweisdokumente und einen vollständigen Agent (Logo, Titelbild, Farbe, Datenschutz- und Impressumslink, Kontaktmöglichkeit, Abrechnungskategorie, Region). Die Einreichung übernimmt der Betreiber oder der Autopilot (Kapitel 6). Die Verifizierung erfolgt je Agent; ein zweiter Agent derselben Marke erbt sie nicht.

Schritt 5: Launch

Der Launch ist die Freigabe durch die einzelnen Netzbetreiber. Eingereicht werden die Zielnetze und ein Fragebogen zu Einsatzzweck, Opt-in-Weg und erwartetem Volumen. Google leitet die Anfrage an jeden Netzbetreiber weiter; jeder entscheidet unabhängig und in eigenem Tempo. Erst wenn alle beantragten Netzbetreiber zugestimmt haben, ist der Agent LAUNCHED und darf an alle erlaubten Empfänger senden. Solange ein Netzbetreiber noch prüft, bleibt der Agent PENDING, auch wenn andere bereits freigegeben haben.

Auch hier reicht der Betreiber oder der Autopilot ein; einen Launch-Knopf für Kunden gibt es bewusst nicht.

Newsletter-Agents (Community-Tarif) brauchen zusätzlich die MAU-Freigabe der deutschen Netzbetreiber: Erst damit rechnen die Netzbetreiber pro monatlich aktivem Empfänger statt pro Nachricht ab. Die Anfrage geht mit Ihrem Versandintervall und der geschätzten Kontaktzahl per E-Mail an die Netzbetreiber, sobald der Launch bei allen deutschen Netzbetreibern eingereicht ist, automatisch, wenn das für Ihr Konto eingerichtet ist, sonst durch den Betreiber. Flex- und Konversations-Agents brauchen keine MAU-Freigabe.

Die Status im Überblick

Der Status eines Agents fasst die Entscheidungen aller Netzbetreiber zusammen. Es gibt genau fünf Werte:

Status Bedeutung
DRAFT Noch nie freigegeben oder wieder zurückgezogen. Sendet nur an Tester mit angenommener Einladung.
PENDING Launch (oder Rückzug) eingereicht, die Netzbetreiber prüfen.
LAUNCHED Bei allen beantragten Netzbetreibern live; darf an alle erlaubten Empfänger senden. Ein teilweiser Rollout bleibt PENDING.
REJECTED Ein Netzbetreiber hat den Launch abgelehnt. Die Begründung steht je Netzbetreiber in der Launch-Übersicht.
SUSPENDED Ein Netzbetreiber hat den laufenden Agent ausgesetzt. Der Zustand ist umkehrbar, sobald der Netzbetreiber ihn wieder aktiviert.

Zusätzlich zum Status zeigt die Launch-Übersicht je Netzbetreiber den Einzelstand und einen Kommentar, etwa den Grund einer Ablehnung. Bei einer Ablehnung lohnt deshalb immer der Blick in diese Einzelstände, nicht nur auf den Gesamtstatus.

Rückzug (Unlaunch)

Ein Agent im Status LAUNCHED, PENDING oder REJECTED lässt sich zurückziehen. Die Box meldet den Rückzug für jedes noch aktive Netz an Google und holt anschließend den neuen Stand. Nach dem Rückzug steht der Agent wieder auf DRAFT. War der Autopilot für diesen Agent noch aktiv, wird er im selben Schritt angehalten, damit er den Launch nicht erneut einreicht.

Archivierte Agents

Neben den fünf Status gibt es einen Zustand bei Google: archiviert. Archivieren geschieht in der Google-Konsole, nicht über die Box. Die Box gleicht diesen Zustand beim Abgleich mit Google ab und führt archivierte Agents in den Übersichten gesondert und nach unten sortiert, damit sie aktive Agents nicht verdecken. Wenn Sie einen Agent nicht mehr benötigen, sprechen Sie den Betreiber an; die Archivierung ist keine Aktion, die Sie über die Schnittstelle auslösen.

Technisch nachlesen

  • Brands: Marken, Verifizierungskontakt, Nachweisdokumente
  • Agents: Anlage, Profilfelder, Status-Tabelle
  • Testers: Testnummern registrieren und Einladungsstatus abfragen
  • Launch: Launch-Stand je Netzbetreiber, Rückzug

Weiter: Was Sie liefern müssen →