コンテンツカードの作成

この記事では、キャンペーンやキャンバスを構築する際に Braze でコンテンツカードを作成する方法について説明します。ここでは、メッセージタイプの選択、カードの作成、メッセージ配信のスケジュール設定について順を追って説明します。

ステップ 1:メッセージの作成場所を選択する

キャンペーンは、シンプルな単一メッセージング（1つのメッセージで製品についてユーザーに通知するなど）に使用します。キャンバスは、複数ステップのユーザージャーニー（時間の経過に伴うユーザーの動作に基づいてカスタマイズされた製品提案を送信するなど）に使用します。

• campaign
• canvas

ステップ 2:メッセージタイプを指定する

3つの基本的なコンテンツカードタイプから1つを選択します: クラシック、キャプション付き画像、画像のみ。

各タイプの想定される動作と外観の詳細については、クリエイティブの詳細を参照するか、以下の表のリンクを確認してください。これらのコンテンツカードタイプは、モバイルアプリと Web アプリケーションの両方で使用できます。

メッセージタイプ	例	説明
クラシック		クラシックカードは、太字のタイトル、メッセージテキスト、およびタイトルとテキストの左側に配置されるオプションの画像を含むシンプルなレイアウトです。クラシックカードには正方形の画像またはアイコンを使用するのが最適です。
キャプション付き画像		キャプション付き画像カードは、コピーと目を引く画像でコンテンツを紹介します。
画像のみ		画像のみカードは、画像、GIF、その他のクリエイティブなテキスト以外のコンテンツ用のスペースで注目を集めます。

ステップ 3:コンテンツカードを作成する

メッセージエディターの作成タブで、メッセージのコンテンツと動作のすべての側面を編集できます。

ここに表示されるコンテンツは、前のステップで選択したカードタイプによって異なりますが、以下のオプションのいずれかが含まれる場合があります。

言語

言語を追加を選択して、提供されたリストから希望の言語を追加します。これにより、メッセージに Liquid が挿入されます。コンテンツを作成する前に言語を選択して、Liquid 内の適切な場所にテキストを入力できるようにすることをお勧めします。使用可能な言語の完全なリストについては、サポートされている言語を参照してください。

右から左に読むメッセージの作成

右から左に読むメッセージの最終的な表示は、サービスプロバイダーのレンダリング方法に大きく依存します。できるだけ正確に表示される右から左に読むメッセージを作成するためのベストプラクティスについては、右から左に読むメッセージの作成を参照してください。

タイトルとメッセージ

好きな内容を記述できます。制限はありませんが、メッセージを素早く伝えてユーザーにクリックしてもらえるほど効果的です。明確で簡潔なタイトルとメッセージコンテンツをお勧めします。これらのフィールドは画像のみカードには提供されません。

画像

コンテンツカードに画像を追加するには、画像を追加を選択するか、画像 URL を入力します。画像を追加を選択するとメディアライブラリが開き、以前にアップロードした画像を選択するか、新しい画像を追加できます。

メッセージタイプとプラットフォームごとに推奨される比率と要件が異なる場合があるため、画像を発注または作成する前に必ず確認してください。コンテンツカードのメッセージフィールドは合計サイズが 2 KB に制限されていることに注意してください。

トップに固定

Braze は固定されたカードをユーザーのフィードの上部に表示し、ユーザーはそれを閉じることができません。ユーザーのフィードに複数の固定カードがある場合、Braze は時系列順に並べます。カードを送信した後、固定オプションを遡って更新することはできません。キャンペーン送信後にこのオプションを変更しても、将来の送信にのみ影響します。

クリック時の動作

ユーザーがカード内の表示されたリンクをクリックすると、リンクはアプリ内のより深い場所または別のサイトに誘導できます。コンテンツカードのクリック時の動作を選択する場合は、それに応じてリンクテキストを更新することを忘れないでください。

コンテンツカードのリンクで使用できるアクションは以下のとおりです。

アクション	説明
Web URL にリダイレクト	ネイティブでない Web ページを開きます。
アプリへのディープリンク	アプリ内の既存の画面にディープリンクします。
カスタムイベントをログに記録	トリガーするカスタムイベントを選択します。別のコンテンツカードの表示や追加のメッセージングのトリガーに使用できます。
カスタム属性をログに記録	現在のユーザーに設定するカスタム属性を選択します。

カスタムイベントをログに記録とカスタム属性をログに記録オプションには、以下の SDK バージョンの互換性が必要です。

ステップ 4:追加設定を構成する（オプション）

キーと値のペアを使用して、カードのカテゴリを作成したり、複数のコンテンツカードフィードを作成したり、カードのソート方法をカスタマイズしたりできます。

メッセージにキーと値のペアを追加するには、設定タブに移動して新しいペアを追加を選択します。

ステップ 5:キャンペーンまたはキャンバスの残りの部分を構築する

• campaign
• canvas

ステップ 6:確認してデプロイする

キャンペーンまたはキャンバスの最後の構築が完了したら、詳細を確認し、テストを行い、準備ができたら送信します。詳細については、テストメッセージの送信を参照してください。

次に、コンテンツカードレポートを確認して、コンテンツカードキャンペーンの結果にアクセスする方法を学びましょう。

知っておくべきこと

ペイロードとフィードの制限

パフォーマンスをサポートするために、コンテンツカードには2つの主要な制約があります。各カードのペイロードサイズの制限と、フィードに表示できるカードの最大数です。

コンテンツカードのサイズ制限

単一のコンテンツカードのデータペイロード全体は、Liquid パーソナライゼーションがレンダリングされた後で 2 KB を超えることはできません。これには以下が含まれます。

• タイトル
• メッセージ
• 画像 URL（URL 文字列自体の長さであり、画像ファイルサイズではありません）
• リンクテキスト
• 指定されたすべてのプラットフォームのリンク URL（iOS、Android、Web の個別の URL はすべて合計にカウントされます）
• キーと値のペア（キー名とその値の両方）

Liquid を使用して長いテキスト文字列（カスタム属性からなど）を取得すると、制限を超える可能性があります。

キャンペーンコンポーザーは、静的コンテンツが制限を超えた場合に警告を表示します。（Liquid を使用した動的コンテンツのサイズは予測しません。）メッセージサイズが 2 KB を超えた場合、送信時に中止されます。これらの中止は、メッセージアクティビティログで理由 Content card maximum size exceeded として確認できます。

コンテンツカードのペイロードサイズを管理するためのベストプラクティスは以下のとおりです。

• 長いリンクには URL 短縮サービスを使用します。URL、特に広範なトラッキングパラメーターを含むものは、サイズ制限の問題が発生する可能性があります。URL 短縮サービスを使用すると、文字数を大幅に削減し、ペイロード内のスペースを確保できます。
• Liquid で動的コンテンツを切り詰めます。ユーザー属性や API 呼び出しからの動的テキストでカードをパーソナライズする場合、コンテンツの長さが予測できないことがあります。truncate などの Liquid フィルターを積極的に使用して、動的テキストの長さに上限を設定してください。
• マルチプラットフォーム URL を効率的に使用します。2 KB の制限には、定義したすべてのプラットフォームの URL が含まれます。各プラットフォームに長くユニークな URL を使用すると、ペイロードのサイズが倍増する可能性があります。可能であれば、すべてのプラットフォームで機能する単一のリンクを使用するか、必要に応じて URL 短縮サービスを使用してください。
• よりリッチなコンテンツにはバナーを検討します。大量のコンテンツを常に必要とするユースケースでは、コンテンツカードが適切なチャネルではない場合があります。バナーには同じ 2 KB のペイロード制限がなく、アプリや Web サイトのエクスペリエンスにリッチなコンテンツを直接埋め込むのに適しています。

フィード内のカード数

各ユーザーは、フィード内に最大250枚の有効期限内のコンテンツカードを同時に保持できます。この制限を超えると、Braze は未読であっても最も古いカードを返さなくなります。閉じたカードもこの制限にカウントされるため、閉じたカードが多いと古いカード用のスペースが減少する可能性があります。

カード制限に関する問題を防ぐために、以下のベストプラクティスをお勧めします。

• 短い有効期限を使用する: 時間に敏感なキャンペーン（週末セールなど）の場合、特定の有効期限日を設定します。これにより、カードはフィードから自動的に削除され、関連性がなくなった後は制限にカウントされません。
• アクションベースの削除を活用する: トランザクションまたは目標ベースのカードに削除イベントを設定します。たとえば、ユーザーにプロファイルの完成を促すカードは、profile_completed イベントがログに記録されたらすぐに削除する必要があります。
• 長期実行キャンペーンを監査する: 定期的または継続的なキャンペーンを確認して、時間の経過とともにフィードに多すぎるカードが蓄積され、ユーザーに悪い体験を与えていないことを確認します。

コンテンツカードの再適格性について

再適格性は、ユーザーが同じキャンペーンからメッセージを複数回受信できるかどうか、またいつ受信できるかを決定します。コンテンツカードの場合、この仕組みを理解することは、定期的なキャンペーンを管理し、ユーザーが重複したメッセージや古いメッセージを受信しないようにするために重要です。

再適格性の計算方法

再適格性を有効にすると、ユーザーがキャンペーンに「再エントリ」できるまでのカウントダウンは、メッセージが送信された後に開始されます。このカウントダウンが開始される具体的なタイミングは、カード作成の設定によって異なります。

• ファーストインプレッション時を使用するコンテンツカードは、インプレッション時刻を使用して再適格性を計算します。
• キャンペーン起動時またはキャンバスステップエントリ時に作成されたコンテンツカードは、送信時刻またはインプレッション時刻のいずれか遅い方を使用します。

30日間の有効期限と再適格性

よくある混乱の原因は、キャンペーンの再適格性とすべてのコンテンツカードの自動30日間有効期限の相互作用です。

すべてのコンテンツカードは、送信または削除されてから30日後に Braze のシステムから自動的にパージされます。再適格性をオフにした長期実行の定期キャンペーンがある場合、ユーザーは30日後に同じカードを再度受信する可能性があります。元のカードがパージされると、システムはそのユーザーがキャンペーンを受信した記録を認識しなくなり、次のセッションで再び適格になります。

ユーザーが特定のキャンペーンからメッセージを1回だけ受信するようにするには、キャンペーンまたはキャンバスステップに、このキャンペーンからメッセージを受信していないユーザー向けのオーディエンスフィルターを追加してください。このフィルターは、長期実行キャンペーンからの重複送信を防ぐ最も信頼性の高い方法です。

ライブコンテンツカードの管理

コンテンツカードが送信された後、ユーザーに配信される準備ができた「受信トレイ」で待機します（メールの場合と同様）。コンテンツがコンテンツカードに取り込まれた後（表示時）、その有効期間中は変更できません。これは、コネクテッドコンテンツを通じて API を呼び出し、エンドポイントからのデータが変更された場合でも適用されます。このデータは更新されません。新しいユーザーへの送信を停止し、ユーザーのフィードから削除することのみ可能です。キャンペーンを変更した場合、送信される将来のカードのみが更新されます。

起動済みカードの更新

すでにカードを受信したユーザーのカードを変更するには、以下のいずれかの方法を使用する必要があります。

オプション 1: キャンペーンを複製する（即時変更に推奨）

最初のアプローチは、キャンペーンをアーカイブし、新しい複製キャンペーンを起動することです。

1. 元のキャンペーンを停止し、プロンプトが表示されたら Remove card after the next sync を選択します。
2. キャンペーンを複製し、編集を行い、新しいバージョンを起動します。

キャンペーンを複製する場合、新しいバージョンのオーディエンスを定義する必要があります。セグメンテーションフィルターを使用して、更新されたカードを受信するユーザーを制御します。

• ユーザーがコンテンツカードに再適格になるべきでない場合、Received Message from Campaign フィルターの条件を Has Not に設定して、以前のバージョンのコンテンツカードを受信していないユーザーをフィルタリングできます。
• 以前のカードを受信したユーザーが X 日後に再適格になるべき場合、Last Received Message from specific campaign フィルターを X 日以上前に設定するか、または Received Message from Campaign フィルターの条件を Has Not に設定できます。

影響

• 既存の受信者: 新規および既存の受信者は、適格であれば次のフィード更新時に更新されたカードを確認できます。
• レポート: カードの各バージョンには個別の分析があります。

たとえば、セッション開始時にトリガーされるキャンペーンを設定し、再適格性を30日に設定したとします。ユーザーが2日前にキャンペーンを受信し、コピーを変更したいとします。まず、キャンペーンをアーカイブしてフィードからカードを削除します。次に、キャンペーンを複製し、新しいコピーで再起動します。ユーザーが別のセッションを開始すると、すぐに新しいカードを受信します。

オプション 2: 同じキャンペーンを停止して再起動する

このアプローチでは、すべての分析が単一のキャンペーンに統一されます。新たに適格になったユーザーは新しいカードを受信しますが、既存の受信者への更新は再適格になるまで遅延します。

1. キャンペーンを停止し、プロンプトが表示されたら次の同期後にカードを削除を選択します。
2. 必要に応じてキャンペーンを編集します。
3. キャンペーンを再開します。

影響

• 既存の受信者: すでにカードを受信したユーザーは、再適格になるまで更新されたカードを受信しません。再適格性がオフの場合、新しいカードを受信することはありません。
• レポート: 1つのキャンペーンに、起動されたカードバージョンのすべてのレポート分析が含まれます。Braze は起動されたバージョン間を区別しません。

たとえば、セッション開始時にトリガーされ、再適格性が30日に設定されたキャンペーンがあるとします。ユーザーが2日前にキャンペーンを受信し、コピーを変更したいとします。まず、キャンペーンを停止してフィードからカードを削除します。次に、新しいコピーでキャンペーンを再公開します。ユーザーが別のセッションを開始すると、28日後に新しいカードを受信します。

カードの削除と有効期限

手動によるカードの削除

キャンペーンを停止することで、いつでもすべてのユーザーのフィードからカードを手動で削除できます。

1. コンテンツカードキャンペーンを開き、キャンペーンを停止を選択します。
2. プロンプトが表示されたら、次の同期後にカードを削除を選択します。カードは次のフィード更新時に削除されます。

自動カード削除

購入の完了や機能の有効化など、ユーザーが特定のアクションを実行したときにカードを自動的に削除できます。

キャンペーンまたはキャンバスステップで、削除イベントを指定します。ユーザーがそのイベントを実行すると、Braze がイベントを処理した後の次のフィード更新時にカードがフィードから削除されます。

カードの有効期限

コンテンツカードは、送信されてから最大30日間利用可能です。30日後、Braze はユーザーのフィードからカードを削除し、Braze のシステムからパージします。

カードを30日以上持続させる

カードが常に利用可能であるように見せたい場合は、30日ごとにカードを効果的に置き換える定期キャンペーンを作成できます。

1. コンテンツカードの期間を30日に設定します。
2. キャンペーンの再適格性を30日に設定します。
3. キャンペーンを「セッション開始」時にトリガーするように設定します。