Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
RCS-Karussells senden
In einer Karussellnachricht in AWS End User Messaging werden 2 bis 10 Rich-Karten in einem horizontal scrollbaren Streifen angezeigt. Die Empfänger können durch die Karten blättern und Vorschläge für einzelne Karten auswählen, um Maßnahmen zu ergreifen. Mit Karussells können Sie interaktive und interaktive Erlebnisse wie Produktkataloge, Servicemenüs, Tarifvergleiche und Standortlisten schaffen.
Karussells haben dasselbe Karteninhaltsmodell wie eigenständige Rich Cards (sieheRCS-Rich Cards versenden), aber Karussellkarten verwenden immer ein vertikales Layout und unterstützen die Medienhöhe nicht. TALL
Wichtig
Sie können RCS-Karussellnachrichten in allen Ländern versenden, in denen RCS unterstützt wird.
Wann sollte ein Karussell verwendet werden
Verwenden Sie ein Karussell, wenn die Empfänger mehrere Artikel desselben Typs durchsuchen und vergleichen sollen. Häufige Anwendungsfälle umfassen:
Produktkataloge: Zeigen Sie mehrere Artikel mit Bildern, Beschreibungen und Kaufschaltflächen an.
Servicemenüs: Präsentieren Sie Servicestufen oder Optionen zum Vergleich nebeneinander.
Tarifvergleiche: Lassen Sie die Empfänger die Funktionen verschiedener Tarife vergleichen und eine auswählen.
Standortlisten: Zeigen Sie Geschäfte oder Büros in der Nähe mit Adressen und Kartenaktionen an.
Wenn Sie ein einzelnes Element mit reichhaltigem Inhalt anzeigen möchten, verwenden Sie stattdessen eine eigenständige Rich Card. Details hierzu finden Sie unter RCS-Rich Cards versenden.
Struktur des Karussells
Sie definieren ein Karussell im Content.Carousel Objekt innerhalb des RcsMessageContent Parameters einer Anfrage. SendRcsMessage Das Karussell-Objekt enthält zwei Pflichtfelder:
CardWidth(Erforderlich)Die Anzeigebreite aller Karten im Karussell. Alle Karten haben dieselbe Breite. Gültige Werte:
SMALLoderMEDIUM.CardContents(Erforderlich)Eine Reihe von 2 bis 10 Kartenobjekten. Jede Karte kann einen Titel, eine Beschreibung, Medien und bis zu 4 Vorschläge enthalten.
Werte für die Kartenbreite
| Wert | Width | Am besten geeignet für |
|---|---|---|
SMALL |
180 DP | Kompakte Listen, Miniaturansichten, Funktionen zum schnellen Durchsuchen |
MEDIUM |
296 DP | Detaillierte Karten mit längeren Beschreibungen und größeren Bildern |
Felder mit Karteninhalt
Jedes Kartenobjekt im CardContents Array unterstützt die folgenden Felder:
TitleDer Kartentitel. Maximal 200 Zeichen.
DescriptionDer Text der Kartenbeschreibung. Maximal 2.000 Zeichen.
Media-
Ein Bild oder Video, das auf der Karte angezeigt werden soll. Enthält die folgenden Felder:
FileUrl(erforderlich): Die URL der Mediendatei. Muss dem Muster entsprechen^(https://|s3://).+$. Maximal 2.000 Zeichen. Die maximale Dateigröße beträgt 100 MB.ThumbnailUrl(optional): Eine URL für ein Vorschaubild wird angezeigt, während das gesamte Medium geladen wird.Height: Die Displayhöhe des Mediums. Gültige Werte für Karussellkarten:SHORToder.MEDIUMDieTALLHöhe wird in Karussells nicht unterstützt.
SuggestionsEine Reihe von bis zu 4 vorgeschlagenen Antworten oder Aktionen, die unter dem Karteninhalt angezeigt werden. Die vollständige Liste der Vorschlagsarten finden Sie unterKonfiguration von RCS-Vorschlägen.
Kartenvorschläge und äußere Vorschläge
Karussellnachrichten unterstützen zwei Ebenen von Vorschlägen:
- Card-level Vorschläge
Jede Karte kann bis zu 4 Vorschläge enthalten. Diese werden direkt unter dem Karteninhalt angezeigt und sind spezifisch für diese Karte (z. B. „Diesen Artikel kaufen“ oder „Details anzeigen“).
- Äußere Vorschläge (auf Nachrichtenebene)
Das
SuggestionsArray der obersten Ebene (ein gleichgeordnetes Element vonContentin derRcsMessageContentStruktur) definiert eine Chip-Liste, die unter dem gesamten Karussell angezeigt wird. Sie können bis zu 11 äußere Vorschläge pro Nachricht hinzufügen.
Verwenden Sie äußere Vorschläge für Navigationsaktionen, die sich auf die gesamte Nachricht beziehen, z. B. „Zurück zum Menü“, „Hilfe“ oder „Durchstöbern“. Vermeiden Sie es, Aktionen auf Kartenebene in der äußeren Chip-Liste zu duplizieren.
Höhe und Kürzung der Karte
Alle Karten in einem Karussell werden so skaliert, dass sie der Höhe der höchsten Karte entsprechen. Wenn der Inhalt einer Karte die maximale Anzeigehöhe überschreitet, schneidet der Messaging-Client den Inhalt in der folgenden Reihenfolge ab:
Die Beschreibung wurde auf eine einzige Zeile gekürzt.
Der Titel wurde auf eine einzige Zeile gekürzt.
Vorschläge wurden entfernt.
Beschreibung wurde entfernt.
Der Titel wurde entfernt (nur das Medium bleibt übrig).
Wenn die Kürzung vorgenommen wurde, erscheint die Anzeige „Mehr“, sodass der Empfänger die Karte auf die Vollbildansicht erweitern kann.
Seitenverhältnisse der Medien
Das Seitenverhältnis von Kartenmedien hängt von der Kombination aus Kartenbreite und Medienhöhe ab.
| Höhe | Seitenverhältnis |
|---|---|
MEDIUM |
4:3 |
SHORT |
2:1 |
| Höhe | Seitenverhältnis |
|---|---|
MEDIUM |
4:5 |
SHORT |
5:4 |
Anmerkung
Die TALL Medienhöhe wird auf Karussellkarten nicht unterstützt. Verwenden Sie für große Medien eine eigenständige Rich Card. Siehe RCS-Rich Cards versenden.
Karussell-JSON-Struktur
Die folgende JSON-Datei zeigt die Struktur des RcsMessageContent Parameters für eine Karussellnachricht:
{ "Content": { "Carousel": { "CardWidth": "SMALL | MEDIUM", "CardContents": [ { "Title": "Card title (max 200 chars)", "Description": "Card description (max 2000 chars)", "Media": { "FileUrl": "https://example.com/image.jpg", "ThumbnailUrl": "https://example.com/thumb.jpg", "Height": "SHORT | MEDIUM" }, "Suggestions": [ { "Reply": { "Text": "Button label (max 25 chars)", "PostbackData": "callback_data" } } ] } ] } }, "Suggestions": [ { "Reply": { "Text": "Outer chip label", "PostbackData": "outer_callback" } } ] }
Dieser Wert wird als JSON-Zeichenfolge im --rcs-message-content Parameter (CLI) oder im RcsMessageContent Parameter (SDK) übergeben. Sie geben in der send-rcs-message Anfrage auch --destination-phone-number und --origination-identity (einen Pool- oder RCS-Agenten) an.
Karussell-Limits
| Parameter | Minimum | Maximum |
|---|---|---|
| Karten pro Karussell | 2 | 10 |
| Vorschläge pro Karte | 0 | 4 |
| Äußere Vorschläge pro Nachricht | 0 | 11 |
| Länge des Titels | - | 200 Zeichen |
| Länge der Beschreibung | - | 2 000 Zeichen |
| Größe der Mediendatei | - | 100 MB |
| Gesamtgröße der Nutzlast | - | 250 KB |
Einzelheiten zum Medienformat und zur Lieferung finden Sie unterRCS-Dateinachrichten senden.