US-Abrechnungsmodell

Dieses Dokument beschreibt das Abrechnungsmodell für RCS for Business-Datenverkehr bei US-amerikanischen Netzbetreibern.

Wichtig: Die Preise für die in den folgenden Abschnitten beschriebenen kostenpflichtigen Nachrichtentypen werden von US-amerikanischen Mobilfunkanbietern festgelegt. Diese bestimmen auch die endgültige Gebühr, die Entwickler für den Versand von RCS for Business-Nachrichten zahlen. Dieses Dokument dient als Leitfaden zur Definition kostenpflichtiger Nachrichtentypen und Ereignisse auf dem US-Markt. Kostenpflichtig bedeutet, dass ein Ereignis kostenpflichtig ist. Die Mobilfunkanbieter legen fest, ob und wie kostenpflichtige Ereignisse abgerechnet werden. Für weitere Informationen zu Preisen und Abrechnung wenden Sie sich bitte an Ihren zuständigen Mobilfunkanbieter.

• Informationen zum Standard-Abrechnungsmodell (für Datenverkehr außerhalb der USA) finden Sie in den FAQ zur Abrechnung .
• Für Informationen zur Berichtserstellung siehe den Leitfaden zu Abrechnungsberichten und Aktivitätsprotokollen .

Überblick über die US-amerikanischen Abrechnungsklassifizierungen

Jede Nachricht an oder von einer US-amerikanischen Telefonnummer wird anhand ihres Formats automatisch in einen der folgenden Typen eingeteilt:

• Rich Message (bidirektional)
• Rich-Media-Nachricht (bidirektional)

Mehrere Nachrichtentypen können zu einer Sitzung zusammengefasst werden. Weitere Informationen zu Sitzungen finden Sie unter Sitzungsabrechnung (Pilotprojekt) .

Detaillierte Spezifikationen finden Sie in den folgenden Abschnitten.

Ein Hinweis zur Terminologie

Zur Beschreibung der Richtung des Nachrichtenverkehrs verwenden US-amerikanische Mobilfunkanbieter typischerweise die MT/MO-Terminologie. Diese Begriffe entsprechen der A2P/P2A-Terminologie, die in der gesamten RCS for Business-Dokumentation verwendet wird:

• MT (Mobile Terminated) ist A2P (Application-to-Person) : Eine Nachricht, die vom Unternehmen gesendet wird.
• MO (Mobile Originated) ist P2A (Person-to-Application) : Eine Nachricht oder Aktion, die vom Benutzer initiiert wird.

Agent-to-Person (A2P/MT) Ereignisabrechnung

Dieser Abschnitt behandelt die Abrechnungslogik für Nachrichten, die von einem Agenten gesendet werden (d. h. A2P- oder MT-Nachrichten).

Rich Messages (A2P)

Eine Nachricht wird als Rich Message klassifiziert, wenn sie ausschließlich eine Kombination der folgenden Elemente enthält:

• Text
• Antwortvorschläge
• Empfohlene Maßnahmen sind ausschließlich folgender Art:
  • Wählen Sie eine Nummer
  • Öffnen Sie die URL im Standardbrowser, nicht in einer Webansicht.

Abrechnungslogik für Rich Messages

Eine Rich Message wird segmentbasiert abgerechnet.

• Segmentgröße : 1 Segment = 160 Byte UTF-8-kodierter Text.
• Berechnung : Die gesamte UTF-8-Byte-Länge des Nachrichtentextes wird durch 160 geteilt und immer auf die nächste ganze Zahl aufgerundet.
• Ausnahmen : Der Text und die Postback-Daten innerhalb vorgeschlagener Antworten oder Aktionen werden bei der Segmentzählung nicht berücksichtigt.
• Beispiel : Eine 300 Byte lange Textnachricht hat 2 Segmente (300 / 160 = 1,875, aufgerundet auf 2).

Byte-Anzahl

Einige Unicode-Zeichen (wie Emojis oder Buchstaben mit Akzenten) sind Mehrbyte-Zeichen, daher kann die Gesamtzahl der UTF-Bytes von der Anzahl der Zeichen abweichen.

Um die genaue Byteanzahl einer Nachricht zu überprüfen, geben Sie diese unten ein oder fügen Sie sie ein.

Rich-Media-Nachrichten (A2P)

Eine Nachricht wird als Rich-Media-Nachricht eingestuft, wenn sie mindestens eines der folgenden Elemente enthält:

• Eine reichhaltige Karte oder ein Karussell (auch ohne Medien)
• Eine Mediendatei (Bild, Video, Audio) als Anhang
• Eine andere vorgeschlagene Aktion als eine Nummer wählen oder eine URL im Browser öffnen, einschließlich:
  • Standort anzeigen
  • Standort teilen
  • Kalenderereignis erstellen
  • URL in einer Webansicht öffnen

Abrechnungslogik für Rich-Media-Nachrichten

Eine Rich-Media-Nachricht wird als einmaliges, pauschalpreispflichtiges Ereignis abgerechnet.

• Die Abrechnung ist unabhängig von der Textlänge, der Anzahl der Karten oder der Größe der Mediendatei.
• Eine Segmentierung findet keine Anwendung.

Beispiele für A2P-API-Antworten

Diese Beispiele zeigen das Feld richMessageClassification in einer erfolgreichen Antwort auf einen RBM-API-Aufruf für vom Agenten gesendete Nachrichten.

Beispiel einer API-Antwort für eine RICH_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

Beispielhafte API-Antwort für eine RICH_MEDIA_MESSAGE

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Abrechnung von Ereignissen zwischen Person und Agent (P2A/MO)

Dieser Abschnitt behandelt die Abrechnung von Nachrichten und Aktionen, die von einem Benutzer initiiert werden (d. h. P2A- oder MO-Nachrichten).

Rich Messages (P2A)

Eine Nutzernachricht wird als Rich Message klassifiziert, wenn sie ausschließlich Text enthält. Dies umfasst sowohl Freitext als auch den Text, der durch Antippen einer vorgeschlagenen Antwort entsteht. (Vorgeschlagene Antworten können eine Postback-Datenkennung in der Nachrichtennutzlast enthalten.)

Abrechnungslogik : Abrechnung auf Segmentbasis. Details zur Berechnung der Segmentanzahl finden Sie unter Abrechnungslogik für Rich Messages .

Rich Media Messages (P2A)

Eine Nachricht wird als Rich-Media-Nachricht klassifiziert, wenn sie eine hochgeladene Datei (Bild, Video, Audio) enthält.

Abrechnungslogik : Abrechnung als einmaliges Ereignis zum Festpreis. Segmentierung findet nicht statt.

Empfohlene Klicks

Durch Antippen einer vorgeschlagenen Aktion durch den Nutzer wird ein abrechnungsfähiges Ereignis namens „Klick auf vorgeschlagene Aktion“ ausgelöst. (Vorgeschlagene Aktionen können eine Postback-Datenkennung in der Nachrichtennutzlast enthalten.)

Abrechnungslogik : Pro Klick wird ein abrechnungsfähiges Ereignis generiert.

Hinweis: Wenn ein Nutzer auf eine vorgeschlagene Antwort tippt (wodurch Text gesendet wird), wird kein Klick auf die vorgeschlagene Aktion ausgelöst. Stattdessen wird die resultierende Nachricht als Rich Message abgerechnet.

Sonderfall: Standort teilen

Die Standortfreigabe ist insofern einzigartig, als sie zwei separate, abrechnungsfähige P2A-Ereignisse generiert:

• Der vorgeschlagene Klick : Durch das Tippen des Benutzers auf die vorgeschlagene Aktion „Standort teilen“ wird ein Ereignis vom Typ „Vorgeschlagener Klick“ ausgelöst.

• Die Standortnachricht: Nachdem der Benutzer einen Standort in der Kartenoberfläche ausgewählt hat, wird eine Nachricht mit den Standortkoordinaten an den Agenten gesendet. Diese MO-Nachricht generiert ein Rich-Message- Ereignis mit der Segmentanzahl eins.

Beispiele für P2A-Webhook-Antworten

Diese Beispiele zeigen das Feld richMessageClassification in Webhooks, die für benutzerinitiierte Ereignisse an den Agenten gesendet werden.

Beispiel für einen Webhook für eine vom Benutzer gesendete RICH_MESSAGE

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

Beispiel-Webhook für eine vom Benutzer gesendete RICH_MEDIA_MESSAGE

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

Beispiel-Webhook für einen SUGGESTED_ACTION_CLICK

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

Beispiel für einen Webhook für eine Standortnachricht

Dies ist das zweite abrechnungsfähige Ereignis im Ablauf „Standort teilen“ , das gesendet wird, nachdem der Benutzer seinen Standort über die Karte geteilt hat.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

Sitzungsabrechnung (Pilotprojekt)

Während das bestehende US-Abrechnungsmodell einzelne Nachrichten in Rechnung stellt, führt das Pilotprojekt zur Sitzungsabrechnung eine Möglichkeit ein, ganze Benutzer-Marken- und/oder Marken-Benutzer-Konversationen zu einem einzigen abrechnungsfähigen Ereignis zusammenzufassen: entweder p2a_session oder a2p_session .

Eine abrechnungsfähige Sitzung wird erfasst und ist abrechnungsfähig, wenn innerhalb eines zusammenhängenden 24-Stunden-Zeitraums bestimmte Interaktionsschwellenwerte erreicht werden. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie ?

Technische Hinweise und Implementierungshinweise

• Segmente dienen ausschließlich Abrechnungszwecken : Lange Nachrichten werden als eine Einheit an das Gerät des Nutzers übermittelt. Die Segmentanzahl ist eine virtuelle Berechnung für Abrechnungszwecke; sie hat keinen Einfluss darauf, wie Nachrichten zugestellt oder dem Nutzer angezeigt werden.
• Automatische Klassifizierung : Die Nachrichtenklassifizierung erfolgt vollautomatisch auf Basis des Nachrichteninhalts und kann nicht manuell überschrieben werden.
• Einführung : Das US-Abrechnungsmodell wurde am 15. Juli 2025 auf der RCS for Business-Plattform aktiviert. Ab diesem Datum spiegeln die Berichte und API-Antworten von Google die neuen Klassifizierungen wider.