Skip to content

Copy Pastd

Copy Pastd Building Blocksは、Liquid対応のContent Blocksやフルテンプレートをドラッグアンドドロップで作成し、Brazeワークスペースに直接プッシュできるメールビルダーです。一度デザインすれば、Brazeに同期して、Campaigns、Canvases、トリガーフローで同じコンポーネントを再利用でき、毎回HTMLを再構築する必要がありません。

このインテグレーションはCopy Pastdによって管理されています。

インテグレーションについて

BrazeとCopy Pastdのインテグレーションにより、Building Blocks（クリーンなLiquid、Content Blockの参照、およびCampaignやCanvasにそのまま組み込めるテンプレートを含むBrazeネイティブの出力を生成するホスト型メールビルダー）でメールを構築できます。

再利用可能なブロックからメールを組み立て、ワンクリックでBrazeにプッシュし、同じブランドスタイル、コンポーネント、ダイナミックコンテンツがすべての送信で一貫してレンダリングされることを確認できます。その結果、手動コーディングのテンプレートが減り、メールの作成と送信にかかる時間が短縮され、変更時にすべての場所で更新される一元化されたライブラリーが実現します。

前提条件

このインテグレーションを使用するには、以下が必要です。

要件 説明
Copy Pastdアカウント Building Blocksを使用するために必要です。copypastd.comでサインアップしてください。各顧客にはワークスペース、スタイルシートライブラリー、5つのビルダーシート、ブロックライブラリーが提供されます。
メールテンプレート用のBraze REST APIキー templates.email.create、templates.email.update、templates.email.listの権限を持つAPIキー。

BrazeダッシュボードのSettings > API Keysからキーを作成してください。
Content Blocks用のBraze REST APIキー content_blocks.create、content_blocks.update、content_blocks.info、content_blocks.listの権限を持つAPIキー。

BrazeダッシュボードのSettings > API Keysからキーを作成してください。
カタログ用のBraze REST APIキー（オプション） catalogs.get、catalogs.get_item、catalogs.get_selectionsへの読み取りアクセス権を持つAPIキー。ブロックをBrazeカタログにバインドする予定がある場合にのみ必要です。
Braze RESTエンドポイント RESTエンドポイントURL。エンドポイントはインスタンスのBraze URLに依存します。Building Blocksは、選択したクラスターに基づいてエンドポイントを自動的に選択します。

ユースケース

  • 大規模なブランド一貫性のあるオーサリング。 Building Blocksのスタイルシートをすべてのテンプレートに適用すると、カラー、フォント、ボタンスタイル、パディングスケールが数百通のメールで同一にレンダリングされます。ブランドが変更された場合、スタイルシートを一度更新して再同期するだけで、すべてのメールに一括で更新を展開できます。
  • コネクテッドコンテンツとカタログバインドの製品テンプレート。 メールブロックのフィールドをビルダー内からコネクテッドコンテンツエンドポイントやBrazeカタログに直接バインドできます。新製品のドロップ、シーズンコレクション、コンテンツの更新に同じテンプレートを再利用でき、Liquidに触れる必要がありません。
  • 非技術系マーケター向けのセルフサービスメール制作。 Liquidのパーソナライゼーションやロジックを含む承認済みブロックからフルメールを作成し、HTMLやLiquidの記述や品質保証のための開発者サポートなしにBrazeにプッシュしてレビューできます。
  • ワンクリックで更新できる一元化されたヘッダーとフッター。 Building Blocksビルダーでヘッダーまたはフッターを一度作成し、Brazeにプッシュします。それを参照するすべてのテンプレートが同期されるため、ロゴの差し替え、法的文言の変更、新しいソーシャルリンクの追加は、Building Blocks内で一度更新するだけで、Braze内のすべてのメールに反映されます。
  • すべてのメールにわたる一元化されたコンテンツ。 ヒーロー、フッター、プロモカードをBuilding Blocksのスマートブロックとして一度作成します。更新して同期すると、それを参照するBraze内のすべてのメールが次回送信時に変更を反映します。ウェルカムフロー、週刊ニュースレター、トリガージャーニーが、各Campaignを編集することなく常に最新の状態を維持します。
  • コントリビューター向けのロックされたテンプレート。 テンプレートを作成し、選択したフィールドをロックしてから、他のチームをコントリビューターインターフェイスに招待して、ユーザー向けツールへのアクセスを付与せずに独自のメールを作成できるようにします。

インテグレーション

ステップ 1: Building BlocksをBrazeに接続する

  1. blocks.copypastd.comでBuilding Blocksにログインするか、copypastd.comでLoginを選択します。
  2. ダッシュボードからSet up your Braze connectionを選択します。（このピルは初回ログイン時から完了するまで管理者に表示されます。Team Settings > Connect > Braze API Keysからもアクセスできます。）
  3. ドロップダウンからBrazeクラスターを選択します。対応するRESTエンドポイントが自動的に入力されます。
  4. テンプレートAPIキー、Content Blocks APIキー、および（オプションで）カタログAPIキーを該当するフィールドに貼り付けます。
  5. Validate and saveを選択します。Building BlocksがBrazeを呼び出してキーが機能し、権限スコープが正しいことを確認します。不足がある場合、インラインエラーでどのスコープが間違っているかが表示されます。

ステップ 2: ライブラリーをBrazeに同期する

  1. キーが検証された後、セットアップモーダルでSync nowを選択します。（Settings > Connect > Braze > Sync libraryからいつでも再同期できます。）
    Building BlocksがスタイルシートとブロックをBraze Content BlocksとしてBrazeワークスペースにプッシュします。BrazeではCP_（ブロックの場合、例：CP_Hero_1）またはcp_（スタイルシートの場合、例：cp_default_style）のプレフィックスが付いた名前で表示されます。
  2. 同期が完了したら、ビルダーからPush to Brazeを使用して個別のテンプレートをプッシュできます。

Building Blocksのカスタマイズ

ステップ 1: スタイルシートを設定する

  1. Building Blocksで、Settings > Build > Stylesheetsに移動します。
  2. デフォルトのスタイルシートを編集するか、新しいスタイルシートを作成します。カラーパレット（24色の名前付きカラー）、フォント（Google Fonts対応）、ボタンスタイル、リンクスタイル、角丸、パディングスケールを設定します。
  3. Saveを選択します。Building Blocksがこのスタイルシートを使用するすべてのブロックのLiquidを再生成します。
  4. Sync nowを選択して、更新されたスタイルをBrazeワークスペースにプッシュします。

ステップ 2: コネクテッドコンテンツエンドポイントを有効にする（オプション）

  1. Building Blocksで、Settings > Connect > Connected Content endpointsに移動します。
  2. エンドポイントURLを追加し、名前を付けて保存します。Building Blocksは標準のJSONシェイプに加えて、Google Sheetsのレスポンスシェイプもサポートしています。
  3. ビルダーで、Personalizeパネルからテキスト、画像、またはリンクフィールドをコネクテッドコンテンツ変数にバインドします。エクスポート時に正しい{% connected_content %} Liquidが生成されます。

ステップ 3: Brazeカタログにバインドする（オプション）

  1. Building Blocksで、Settings > Connect > Catalogsに移動します。Building BlocksがカタログAPIキーを使用してカタログリストを読み取ります。
  2. 互換性のあるブロック（例：製品グリッド）を開きます。
  3. カタログとセレクションを選択し、ブロックフィールドをカタログアイテムの属性にマッピングします。
  4. テンプレートをプッシュします。Building Blocksが正しい{% catalog_items %}および{% catalog_selection_items %} Liquidを出力し、Brazeが送信時に解決します。

ステップ 4: Brazeカスタム属性を追加する（オプション）

Building BlocksにはデフォルトのBrazeユーザー属性（first_name、email、countryなど）が含まれています。独自のカスタム属性にブロックをバインドするには、Building Blocksに一度インポートすると、すべてのPersonalizeドロップダウンで利用可能になります。

  1. Building Blocksで、Team Settings > Connect > Custom Attributesに移動します。
  2. 以下のいずれかの方法でカスタム属性をインポートします。
    • 一括インポート（推奨）。 BrazeでData Settings > Custom Attributesに移動し、Export（右上）を選択します。Building BlocksにCSVをアップロードします。
    • 属性を1つずつ追加。 属性名（例：loyalty_tier）を入力し、Addを選択します。この方法は、いくつかの属性のみを追加する場合や、Brazeエクスポート間に新しい属性を追加する場合に便利です。

保存後、カスタム属性がビルダーのPersonalizeドロップダウンにデフォルトと並んで表示されます。挿入すると、エクスポート時に正しい{{custom_attribute.${name}}} Liquidがレンダリングされるため、Brazeが送信時に受信者ごとに値を解決します。

インテグレーションの使用

ステップ 1: テンプレートをBrazeにプッシュする

  1. Building Blocksビルダーで任意のメールを開きます。
  2. Push to Braze（右上）を選択します。
  3. ワークスペースを選択して確認します。Building BlocksがレンダリングされたLiquidを含むメールテンプレートをBrazeに作成します。

テンプレートはBrazeのTemplates & Media > Email Templatesに、メール設定で選択したメール名と日付に基づいて名前が付けられて表示されます。

ステップ 2: CampaignまたはCanvasでテンプレートを使用する

  1. Brazeで新しいメールCampaignまたはCanvasステップを作成します。
  2. Templatesを選択し、Building Blocksがプッシュしたテンプレートを選択します。

テンプレートにはすべてのBuilding Blocksの参照（スタイルシート、Content Blocks）がライブの{{content_blocks.${...}}} Liquidとして含まれているため、Building Blocksでの更新はテンプレートを再インポートせずに反映されます。

ステップ 3: コンテンツを一元的に更新する

  1. Building Blocksで、該当するブロックまたはスタイルシートを編集します。
  2. Syncを選択して、更新されたContent BlockをBrazeにプッシュします。

それを参照するBraze内のすべてのメール（エバーグリーン、トリガー、ウェルカムフロー）が次回送信時に新しいバージョンを反映します。各Campaignを編集する必要はありません。

ステップ 4: コンテンツプールを構築する

コンテンツプールは、メールが静的コピーを含む代わりに参照するコンテンツ行のテーブルです。Building Blocksでプールを更新すると、それを使用するBraze内のすべてのメールが次回送信時に新しいコンテンツを配信します。コンテンツプールは、週刊ニュースレター、ウェルカムフロー、ウィンバックシーケンス、シーズンCampaigns、購入後ジャーニーなど、同じコンテンツを多くのメールで常に最新に保つ必要がある場所で使用します。

  1. Building Blocksで、プライマリナビゲーションのContentを選択します。
  2. New Poolを選択します。保持する内容を説明する名前を入力します（例：Weekly Offers、Product Catalog、News Articles）。
  3. プールが供給するブロックタイプを選択します（例：Hero、Grid、Card）。これにより、各行で使用可能なフィールドが設定されます。
  4. 行を追加します。各行は1つのコンテンツです。フィールド（見出し、画像、CTAテキスト、CTAリンクなど）を入力します。
  5. 行をドラッグして上下に移動し、優先順位を設定します。各行をアクティブまたは非アクティブに切り替え、オプションで開始日と終了日を設定します。送信時に、日付が有効な最も優先度の高いアクティブな行が選択されます。
  6. Saveをクリックします。スマートブロックがこのプールを参照できるようになります。

ステップ 5: スマートブロックを使用してメールにプールコンテンツをレンダリングする

スマートブロックは、静的コンテンツを保持する代わりに1つ以上のコンテンツプールを参照するビルダーキャンバス上のブロックです。送信時に、Brazeが最も優先度が高く、アクティブで、日付が有効なプール行をレンダリングします。エクスポートされたLiquidがその処理を行います。追加のBrazeセットアップは不要です。

  1. Building Blocksで、スマートブロックをキャンバスにドラッグします（対応するプールがある任意のブロックタイプ）。
  2. プロパティパネルで、カスケードエディターを開きます。
  3. 優先順位に従って1つ以上のコンテンツプールを追加します。これがウォーターフォールです。アクティブで日付が有効な行を持つ最初のプールがレンダリングされます。ライブなものがない場合、スマートブロックは次のプール、さらに次のプールにフォールスルーします。一般的なパターンは「フラッシュセール > 週間オファー > エバーグリーンお気に入り」で、常に何かが用意されています。
  4. テンプレートをBrazeにプッシュします。エクスポートされたLiquidにはフルカスケードが含まれているため、Brazeが送信ごとにプールの優先度と日付を評価します。

以降は、メールではなくプールを更新します。トリガーフロー、エバーグリーンニュースレター、シーズンCampaignsはすべて、プールが最新である限り最新の状態を維持します。

アップロードしたBuilding BlocksテンプレートはBrazeのTemplates & Media > Email Templatesにあります。同期されたスタイルシートとブロックはTemplates & Media > Content Blocksに表示されます。

考慮事項

  • Building Blocksチームスペースごとに1つのBrazeインスタンス。 各Building Blocksチームは単一のBrazeインスタンスに接続します。複数のワークスペース（別々のブランド、リージョン、環境）を運用している顧客は、同じチームに追加でき、ブロックの共有が可能になります。
  • APIキーの権限は個別にスコープされます。 テンプレートキーとContent Blocksキーは分離されています。キーに必要なスコープが不足している場合、検証がすぐに失敗するため、Brazeでどの権限を追加すべきかが正確にわかります。
  • Content Block名は名前空間化されています。 Building BlocksはCP_（ブロック）およびcp_（スタイルシート）のプレフィックスを付けてContent Blocksをプッシュし、Brazeで直接作成されたContent Blocksとの衝突を回避します。
  • スタイルシートの編集はすべてのメールを更新します。 スタイルシートはすべてのテンプレートが参照する単一のBraze Content Blockとしてレンダリングされます。Building Blocksでの変更は、スケジュール済みのものを含め、それを使用するBraze内のすべてのメールを更新します。同期前にドラフトテンプレートでスタイルシートの変更をテストしてください。
  • カタログバインドは読み取り専用です。 Building BlocksはバインディングUIを表示するためにカタログを読み取ります。Brazeカタログへの書き込みは行いません。すべてのカタログ管理は引き続きBrazeダッシュボードで行います。
  • レート制限とリトライ。 すべてのアウトバウンドリクエストはBrazeのレート制限を遵守し、エクスポネンシャルバックオフ、ジッター、Retry-Afterの処理を行います。パートナーアトリビューションのために、すべての呼び出しでUser-Agent: partner-CopyPastdヘッダーが送信されます。
  • ユーザーデータは送信されません。 Building Blocksはコンテンツオーサリングツールです。ユーザー属性、イベント、購入、またはSegmentデータをBrazeにプッシュせず、Brazeデータポイントを消費しません。

トラブルシューティング

  • APIキーの検証が失敗する。 各キーが前提条件に記載されている正確な権限を持っていることを確認してください。テンプレートとContent Blocksのスコープは個別にチェックされます。Brazeでキーを再生成した場合、新しい値をBuilding Blocksに貼り付けて再検証してください。
  • RESTエンドポイントの不一致。 テンプレートキーとContent Blocksキーは同じBrazeワークスペースのものである必要があり、RESTエンドポイントはクラスターと一致する必要があります。Building Blocksのドロップダウンがこれを自動設定するため、検証が失敗した場合はクラスターの選択を確認してください。
  • Push to Brazeがエラーを返す。 Settings > Build > Activity logを開いて、最後の同期試行とBrazeが返したレスポンスを確認してください。ほとんどの失敗は権限関連（スコープの不足）またはクォータ関連（レート制限、自動リトライ）です。
  • Content BlockがBrazeで更新されない。 Settings > Connect > Braze > Sync libraryから手動再同期をトリガーしてください。Building Blocksはコンペアアンドスワップを実行するため、変更されていないブロックはスキップされます。
  • テンプレートがBrazeにまだ存在しないContent Blockを参照している。 Sync libraryを使用して依存関係（スタイルシート、スマートブロック）を先にプッシュしてから、テンプレートをプッシュしてください。
  • その他すべての問題。 Copy Pastd（[email protected]）にお問い合わせください。チーム名と失敗したアクションの時刻を含めていただくと、Copy Pastdが対応するアクティビティログを確認できます。
New Stuff!