Copy Pastd

Copy Pastd bietet Building Blocks, einen Drag-and-Drop-E-Mail-Builder, der Liquid-basierte Content Blocks und vollständige Templates direkt in Ihren Braze-Workspace überträgt. Einmal entwerfen, mit Braze synchronisieren und dieselben Komponenten in Campaigns, Canvases und getriggerten Flows wiederverwenden – ohne jedes Mal HTML neu erstellen zu müssen.

Diese Integration wird von Copy Pastd gepflegt.

Über die Integration

Die Integration von Braze und Copy Pastd ermöglicht es Ihnen, E-Mails in Building Blocks zu erstellen – einem gehosteten E-Mail-Builder, der Braze-nativen Output mit sauberem Liquid, Content-Block-Referenzen und Templates erzeugt, die sich ohne Übersetzung in jede Campaign oder jedes Canvas einfügen lassen.

Sie können eine E-Mail aus wiederverwendbaren Bausteinen zusammenstellen, sie mit einem Klick an Braze senden und darauf vertrauen, dass dieselben Markenstile, Komponenten und derselbe dynamische Content bei jedem Versand konsistent dargestellt werden. Das Ergebnis sind weniger manuell codierte Templates, weniger Zeitaufwand für die Erstellung und den Versand von E-Mails sowie eine zentrale Bibliothek, die sich überall aktualisiert, wenn Änderungen vorgenommen werden.

Voraussetzungen

Folgendes ist erforderlich, um diese Integration zu nutzen:

Anwendungsfälle

• Markenkonformes Authoring in großem Umfang. Wenden Sie ein Building-Blocks-Stylesheet auf jedes Template an, und Farben, Schriftarten, Button-Stile und Padding werden in Hunderten von E-Mails identisch dargestellt. Wenn sich die Marke ändert, aktualisieren Sie das Stylesheet einmal und synchronisieren es erneut, um das Update auf einen Schlag in all Ihren E-Mails auszurollen.
• Connected-Content- und Katalog-gebundene Produkt-Templates. Binden Sie E-Mail-Block-Felder direkt an Ihre Connected-Content-Endpunkte und Braze-Kataloge innerhalb des Builders. Verwenden Sie dasselbe Template für neue Produkteinführungen, saisonale Kollektionen oder Content-Aktualisierungen wieder – ganz ohne Liquid anzufassen.
• Self-Service-E-Mail-Produktion für nicht-technische Marketer. Erstellen Sie eine vollständige E-Mail aus genehmigten Blöcken – einschließlich Liquid-Personalisierung und -Logik – und übertragen Sie sie zur Überprüfung an Braze, ohne dass Entwickler:innen HTML oder Liquid schreiben oder prüfen müssen.
• Zentrale Header und Fußzeilen, mit einem Klick aktualisiert. Erstellen Sie einen Header oder eine Fußzeile einmal im Building-Blocks-Builder und übertragen Sie sie an Braze. Jedes Template, das darauf verweist, bleibt synchron – ein Logo-Tausch, eine Änderung am rechtlichen Text oder ein neuer Social-Link erfordert nur ein einziges Update in Building Blocks, um in jeder E-Mail in Braze zu landen.
• Zentralisierter Content über alle E-Mails hinweg. Erstellen Sie einen Hero-Bereich, eine Fußzeile oder eine Promo-Karte einmal als Building-Blocks-Smart-Block. Aktualisieren Sie ihn, synchronisieren Sie, und jede E-Mail in Braze, die darauf verweist, übernimmt die Änderung beim nächsten Versand. Willkommens-Flows, wöchentliche Newsletter und getriggerte Journeys bleiben aktuell, ohne dass Sie jede Campaign einzeln bearbeiten müssen.
• Gesperrte Templates für den Self-Service von Mitwirkenden. Erstellen Sie Templates, sperren Sie ausgewählte Felder und laden Sie dann andere Teams ein, über eine Mitwirkenden-Oberfläche eigene E-Mails zu erstellen – ohne ihnen Zugriff auf nutzer:innenseitige Tools zu gewähren.

Integration

Schritt 1: Building Blocks mit Braze verbinden

Hinweis

Die Verbindung von Building Blocks mit Braze ist eine einmalige Einrichtung. Nachdem Ihre Zugangsdaten validiert wurden, speichert Building Blocks die Zugangsdaten für alle zukünftigen Synchronisierungen und Template-Übertragungen.

1. Melden Sie sich bei Building Blocks unter blocks.copypastd.com an oder wählen Sie Login unter copypastd.com.
2. Wählen Sie im Dashboard Set up your Braze connection. (Diese Schaltfläche erscheint für Admins beim ersten Login und bis zur Fertigstellung. Sie können die Seite auch über Team Settings > Connect > Braze API Keys aufrufen.)
3. Wählen Sie Ihren Braze-Cluster aus dem Dropdown. Der passende REST-Endpunkt wird automatisch ausgefüllt.
4. Fügen Sie Ihren Templates-API-Schlüssel, Ihren Content-Blocks-API-Schlüssel und (optional) Ihren Katalog-API-Schlüssel in die entsprechenden Felder ein.
5. Wählen Sie Validate and save. Building Blocks ruft Braze auf, um zu bestätigen, dass die Schlüssel funktionieren und die Berechtigungsbereiche korrekt sind. Falls etwas fehlt, zeigt ein Inline-Fehler an, welcher Bereich falsch ist.

Schritt 2: Ihre Bibliothek mit Braze synchronisieren

1. Nachdem die Schlüssel validiert wurden, wählen Sie Sync now im Einrichtungs-Modal. (Sie können jederzeit erneut synchronisieren über Settings > Connect > Braze > Sync library.)
   Building Blocks überträgt Ihr Stylesheet und Ihre Blöcke als Braze Content Blocks in Ihren Braze-Workspace. Sie erscheinen in Braze unter Namen mit dem Präfix CP_ (zum Beispiel CP_Hero_1) oder cp_ für Stylesheets (zum Beispiel cp_default_style).
2. Nach Abschluss der Synchronisierung können Sie einzelne Templates aus dem Builder mit Push to Braze übertragen.

Building Blocks anpassen

Schritt 1: Stylesheet einrichten

1. Navigieren Sie in Building Blocks zu Settings > Build > Stylesheets.
2. Bearbeiten Sie das Standard-Stylesheet oder erstellen Sie ein neues. Legen Sie Ihre Farbpalette (24 benannte Farben), Schriftarten (Google Fonts werden unterstützt), Button-Stile, Link-Stile, Radius und Padding-Skala fest.
3. Wählen Sie Save aus. Building Blocks generiert das Liquid für jeden Block, der dieses Stylesheet verwendet, neu.
4. Wählen Sie Sync now aus, um die aktualisierten Stile in Ihren Braze-Workspace zu übertragen.

Schritt 2: Connected-Content-Endpunkte aktivieren (optional)

1. Navigieren Sie in Building Blocks zu Settings > Connect > Connected Content endpoints.
2. Fügen Sie die Endpunkt-URL hinzu, vergeben Sie einen Namen und speichern Sie. Building Blocks unterstützt neben dem Standard-JSON-Format auch ein Google-Sheets-Antwortformat.
3. Binden Sie im Builder ein beliebiges Text-, Bild- oder Link-Feld über das Personalize-Panel an eine Connected-Content-Variable. Das korrekte {% connected_content %}-Liquid wird beim Export generiert.

Schritt 3: An Braze-Kataloge anbinden (optional)

1. Navigieren Sie in Building Blocks zu Settings > Connect > Catalogs. Building Blocks liest Ihre Katalogliste mithilfe des Catalogs-API-Schlüssels aus.
2. Öffnen Sie einen kompatiblen Block (zum Beispiel ein Produktraster).
3. Wählen Sie einen Katalog und eine Auswahl aus und ordnen Sie dann die Block-Felder den Katalog-Artikelattributen zu.
4. Übertragen Sie das Template. Building Blocks gibt das korrekte {% catalog_items %}- und {% catalog_selection_items %}-Liquid aus, damit Braze die Werte zum Sendezeitpunkt auflöst.

Schritt 4: Eigene angepasste Attribute in Braze hinzufügen (optional)

Building Blocks enthält die standardmäßigen Braze-Nutzerattribute (first_name, email, country usw.). Um Blöcke an Ihre eigenen angepassten Attribute zu binden, importieren Sie diese einmalig in Building Blocks – danach stehen sie in jedem Personalize-Dropdown zur Verfügung.

1. Navigieren Sie in Building Blocks zu Team Settings > Connect > Custom Attributes.
2. Importieren Sie Ihre angepassten Attribute mit einer der folgenden Methoden:
   • Massenimport (empfohlen). Navigieren Sie in Braze zu Data Settings > Custom Attributes und wählen Sie Export aus. Laden Sie die CSV-Datei in Building Blocks hoch.
   • Attribute einzeln hinzufügen. Geben Sie den Attributnamen ein (zum Beispiel loyalty_tier) und wählen Sie Add aus. Diese Methode ist nützlich, wenn Sie nur wenige Attribute hinzufügen oder ein neues Attribut zwischen Braze-Exporten ergänzen möchten.

Nach dem Speichern erscheinen Ihre angepassten Attribute im Personalize-Dropdown des Builders neben den Standardattributen. Beim Einfügen wird beim Export das korrekte {{custom_attribute.${name}}}-Liquid erzeugt, sodass Braze den Wert pro Empfänger:in zum Sendezeitpunkt auflöst.

Die Integration verwenden

Schritt 1: Ein Template an Braze senden

1. Öffnen Sie eine beliebige E-Mail im Building-Blocks-Builder.
2. Wählen Sie Push to Braze in der Aktionsleiste aus.
3. Wählen Sie den Workspace aus und bestätigen Sie. Building Blocks erstellt ein E-Mail-Template in Braze mit dem gerenderten Liquid.

Das Template erscheint in Braze unter Templates und Medien > E-Mail-Templates, benannt nach der E-Mail und dem in den E-Mail-Einstellungen ausgewählten Datum.

Schritt 2: Das Template in einer Campaign oder einem Canvas verwenden

1. Erstellen Sie in Braze eine neue E-Mail-Campaign oder einen neuen Canvas-Schritt.
2. Wählen Sie Templates aus und wählen Sie das Template, das Building Blocks gesendet hat.

Das Template enthält jede Building-Blocks-Referenz (Stylesheet, Content Blocks) als aktives {{content_blocks.${...}}} Liquid, sodass Aktualisierungen in Building Blocks ohne erneuten Import des Templates übernommen werden.

Schritt 3: Inhalte zentral aktualisieren

1. Bearbeiten Sie in Building Blocks den entsprechenden Block oder das Stylesheet.
2. Wählen Sie Sync aus, um den aktualisierten Content-Block zurück an Braze zu senden.

Jede E-Mail in Braze, die darauf verweist (Evergreen-, getriggerte oder Willkommens-Flows), übernimmt die neue Version beim nächsten Versand. Sie müssen nicht jede Campaign einzeln bearbeiten.

Schritt 4: Content-Pools erstellen

Content-Pools sind Tabellen mit Inhaltszeilen, auf die E-Mails verweisen, anstatt statische Kopien zu enthalten. Aktualisieren Sie den Pool in Building Blocks, und jede E-Mail in Braze, die ihn verwendet, liefert beim nächsten Versand den neuen Inhalt aus. Verwenden Sie Content-Pools überall dort, wo derselbe Inhalt in vielen E-Mails aktuell bleiben muss – zum Beispiel in wöchentlichen Newslettern, Willkommens-Flows, Rückgewinnungs-Sequenzen, saisonalen Campaigns oder Post-Purchase-Journeys.

1. Wählen Sie in Building Blocks Content in der Hauptnavigation aus.
2. Wählen Sie New Pool aus. Geben Sie einen Namen an, der den Inhalt beschreibt (zum Beispiel Weekly Offers, Product Catalog, News Articles).
3. Wählen Sie den Blocktyp, den der Pool speist (zum Beispiel Hero, Grid, Card). Dadurch wird festgelegt, welche Felder für jede Zeile verfügbar sind.
4. Fügen Sie Zeilen hinzu. Jede Zeile ist ein einzelner Inhalt. Füllen Sie die Felder aus (Überschrift, Bild, CTA-Text, CTA-Link usw.).
5. Legen Sie die Prioritätsreihenfolge fest, indem Sie Zeilen nach oben oder unten ziehen. Schalten Sie jede Zeile aktiv oder inaktiv und legen Sie optionale Start- und Enddaten fest. Beim Versand gewinnt die aktive Zeile mit der höchsten Priorität, deren Daten gültig sind.
6. Klicken Sie auf Save. Smart-Blocks können jetzt auf diesen Pool verweisen.

Schritt 5: Smart-Blocks verwenden, um Pool-Inhalte in Ihren E-Mails zu rendern

Ein Smart-Block ist ein Block auf dem Builder-Canvas, der auf einen oder mehrere Content-Pools verweist, anstatt statischen Inhalt zu enthalten. Beim Versand rendert Braze die Pool-Zeile mit der höchsten Priorität, die aktiv und datumsgültig ist. Das exportierte Liquid übernimmt die Arbeit. Es ist kein zusätzliches Braze-Setup erforderlich.

1. Ziehen Sie in Building Blocks einen Smart-Block auf den Canvas (jeder Blocktyp, der einen passenden Pool hat).
2. Öffnen Sie im Eigenschafts-Panel den Wasserfall-Editor.
3. Fügen Sie einen oder mehrere Content-Pools in Prioritätsreihenfolge hinzu. Das ist der Wasserfall: Der erste Pool mit einer aktiven, datumsgültigen Zeile wird gerendert. Wenn er nichts Aktives hat, fällt der Smart-Block zum nächsten Pool durch, dann zum nächsten. Ein gängiges Muster ist Flash Sale > Weekly Offers > Evergreen Favorites, sodass immer etwas verfügbar ist.
4. Senden Sie das Template an Braze. Das exportierte Liquid enthält den vollständigen Wasserfall, sodass Braze bei jedem Versand Priorität und Daten des Pools auswertet.

Ab jetzt aktualisieren Sie den Pool, nicht die E-Mail. Getriggerte Flows, Evergreen-Newsletter und saisonale Campaigns bleiben alle aktuell, solange der Pool aktuell ist.

Ihre hochgeladenen Building-Blocks-Templates finden Sie in Braze unter Templates und Medien > E-Mail-Templates. Synchronisierte Stylesheets und Blocks erscheinen unter Templates und Medien > Content Blocks.

Überlegungen

• Eine Braze-Instanz pro Building-Blocks-Teambereich. Jedes Building-Blocks-Team ist mit einer einzelnen Braze-Instanz verbunden. Kund:innen, die mehrere Workspaces betreiben (separate Marken, Regionen oder Umgebungen), können diese demselben Team hinzufügen, was das Teilen von Blöcken ermöglicht.
• API-Schlüssel-Berechtigungen werden separat zugewiesen. Template-Schlüssel und Content-Block-Schlüssel werden getrennt verwaltet. Die Validierung schlägt sofort fehl, wenn einem Schlüssel ein erforderlicher Bereich fehlt, sodass Sie genau wissen, welche Berechtigung Sie in Braze hinzufügen müssen.
• Content-Block-Namen sind mit Namensräumen versehen. Building Blocks überträgt Content Blocks mit den Präfixen CP_ (Blöcke) und cp_ (Stylesheets), um Konflikte mit direkt in Braze erstellten Content Blocks zu vermeiden.
• Stylesheet-Änderungen aktualisieren jede E-Mail. Stylesheets werden als einzelner Braze-Content-Block gerendert, der von jedem Template referenziert wird. Eine Änderung in Building Blocks aktualisiert jede E-Mail in Braze, die dieses Stylesheet verwendet – einschließlich bereits geplanter E-Mails. Testen Sie Stylesheet-Änderungen in einem Entwurfs-Template, bevor Sie synchronisieren.
• Kataloganbindung ist schreibgeschützt. Building Blocks liest Kataloge, um die Bindungs-UI zu befüllen. Es schreibt nicht in Braze-Kataloge. Die gesamte Katalogverwaltung erfolgt weiterhin im Braze-Dashboard.
• Rate-Limits und Wiederholungsversuche. Alle ausgehenden Anfragen respektieren die Rate-Limits von Braze, mit exponentiellem Backoff, Jitter und Retry-After-Behandlung. Bei jedem Aufruf wird ein User-Agent: partner-CopyPastd-Header für die Partner-Attribution gesendet.
• Es werden keine Nutzerdaten übertragen. Building Blocks ist ein Content-Authoring-Tool. Es überträgt keine Nutzerattribute, Ereignisse, Käufe oder Segmentdaten an Braze und verbraucht keine Braze-Datenpunkte.

Fehlerbehebung

• API-Schlüssel-Validierung schlägt fehl. Überprüfen Sie, ob jeder Schlüssel genau die unter „Voraussetzungen“ aufgeführten Berechtigungen besitzt. Die Berechtigungen für Templates und Content Blocks werden separat geprüft. Wenn Sie einen Schlüssel in Braze neu generieren, fügen Sie den neuen Wert in Building Blocks ein und validieren Sie erneut.
• REST-Endpunkt stimmt nicht überein. Die Schlüssel für Templates und Content Blocks müssen aus demselben Braze-Workspace stammen, und der REST-Endpunkt muss zum Cluster passen. Das Building-Blocks-Dropdown stellt dies automatisch für Sie ein – überprüfen Sie daher die Cluster-Auswahl, wenn die Validierung fehlschlägt.
• Push an Braze gibt einen Fehler zurück. Öffnen Sie Settings > Build > Activity log, um den letzten Synchronisierungsversuch und die von Braze zurückgegebene Antwort einzusehen. Die meisten Fehler sind berechtigungsbezogen (fehlender Scope) oder kontingentbezogen (Rate-Limits, automatisch erneut versucht).
• Content-Block wird in Braze nicht aktualisiert. Lösen Sie eine manuelle Neusynchronisierung über Settings > Connect > Braze > Sync library aus. Building Blocks führt einen Compare-and-Swap durch, sodass unveränderte Blöcke übersprungen werden.
• Template verweist auf einen Content-Block, der in Braze noch nicht existiert. Pushen Sie zuerst die Abhängigkeiten (Stylesheet, Smart Blocks) über Sync library und pushen Sie dann das Template.
• Für alles andere. Kontaktieren Sie Copy Pastd unter [email protected]. Geben Sie Ihren Teamnamen und den Zeitpunkt der fehlgeschlagenen Aktion an, damit Copy Pastd den zugehörigen Aktivitätslog abrufen kann.