Mit Kontakten und Zielgruppen arbeiten
Kontakt- und Zielgruppen-Nodes ermöglichen einem Workflow, Kundeninformationen zu lesen und Datensätze oder Mitgliedschaften zu ändern. Sie arbeiten mit Ressourcen im Workspace der Automation.
Automations is in Early access. Your workspace permissions determine which actions you can perform.
Einen Kontakt finden und verwenden
- Fügen Sie Get contact hinzu, wenn Sie eine Kontakt-ID haben, oder List contacts, wenn Sie anhand unterstützter Filter suchen möchten.
- Ordnen Sie den Bezeichner oder Suchwert aus Ihrem Trigger zu.
- Fügen Sie bei einer Liste einen Branch hinzu, um ein leeres Ergebnis von einem gefundenen Kontakt zu unterscheiden.
- Ordnen Sie die Felder des ausgewählten Kontakts dem nächsten Schritt zu.
Eine leere erfolgreiche Suche ist ein Ergebnis, das Sie behandeln müssen. Sie folgt nicht dem Fehlerpfad der Aktion. Verwenden Sie diesen Pfad für einen abgelehnten oder fehlgeschlagenen Lesevorgang.
Listing-Nodes geben eine Seite zurück. Ein Next-Page-Cursor bedeutet, dass weitere Datensätze existieren können. Weder List contacts noch List audience contacts besuchen automatisch weitere Seiten oder führen eine spätere Aktion für jeden Kontakt aus.
Datensätze erstellen oder aktualisieren
Verwenden Sie Create contact für einen neuen Datensatz und Update contact für einen bekannten Datensatz. Ein Lookup gefolgt von einer Erstellung ist keine atomare Operation: Ein anderer Prozess kann zwischen diesen Schritten einen übereinstimmenden Kontakt erstellen. Behandeln Sie einen Erstellungskonflikt, statt davon auszugehen, dass der neue Kontakt existiert.
Create or update contacts akzeptiert einen vorbereiteten Batch. Prüfen Sie das Ergebnis jedes Eintrags: Ein Eintrag kann fehlschlagen, während andere erstellt oder aktualisiert werden. Ein erfolgreicher Node bedeutet nicht, dass jeder Batch-Eintrag erfolgreich war, und erfolgreiche Änderungen werden nicht zurückgerollt, wenn ein anderer Eintrag fehlschlägt.
Große Eingaben und Ergebnisse können die Datenlimits der Automation überschreiten, auch wenn das Contacts-Produkt einen größeren Batch akzeptiert. Verwenden Sie einen kleineren vorbereiteten Batch, wenn die Validierung oder der Lauf einen zu großen Wert meldet.
Statische Zielgruppenmitgliedschaften verwalten
- Wählen Sie eine bestehende Zielgruppe aus oder fügen Sie Create audience hinzu, um eine als Teil des Workflows zu erstellen.
- Verwenden Sie Add contacts to audience, Remove contact from audience oder Remove contacts from audience mit expliziten Kontakt-IDs.
- Prüfen Sie das Aktionsergebnis und behandeln Sie Fehler, bevor Sie fortfahren.
Das Entfernen der Mitgliedschaft behält den Kontakt bei. Das Hinzufügen zu einer Zielgruppe und das Entfernen aus einer anderen sind separate Operationen, sodass ein Fehler dazwischen den Kontakt in beiden Zielgruppen belassen kann. Planen Sie den Fehlerpfad für den Zustand, der Aufmerksamkeit erfordert.
Verwenden Sie Get audience und Update audience, um die Zielgruppe selbst zu lesen oder zu ändern. Diese Nodes erstellen keinen Snapshot ihrer Mitglieder und machen den Workflow nicht zu einem Broadcast.
Einen Kontakt gezielt löschen
Verwenden Sie Delete contact, um den Kontakt und seine Zielgruppenmitgliedschaften dauerhaft zu entfernen.
Präferenz- und Unterdrückungsdatensätze, die mit der Kanaladresse der Person verknüpft sind, können bestehen bleiben. Das Löschen und Neuerstellen eines Kontakts entfernt kein Opt-out und keine Zustellungssperre.
Nächste Schritte
- Präferenzen und Lookups verwenden.
- Daten aus früheren Schritten verwenden.
- Einen Workflow in der Vorschau ansehen und prüfen.
- Die Automations-Anleitungen durchsuchen.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.