コンテンツカードを作成する

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

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

キャンペーンは、単一のシンプルなメッセージング（例えば、一つのメッセージで製品についてユーザーに知らせるなど）に使います。キャンバスは、複数のステップからなるユーザージャーニー（例えば、ユーザーの行動履歴に基づいてカスタマイズされた商品提案を送信するといった場合）に使います。

• campaign
• canvas

ステップ 2:メッセージの種類を指定する

次の3つの主なコンテンツカードタイプのいずれかを選択します。クラシック、キャプション付き画像、および画像のみです。

各タイプの予想される動作と外観の詳細については、クリエイティブ詳細を参照するか、次の表のリンクを確認してください。これらのコンテンツカードのタイプは、モバイルアプリと 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 日後に同じカードを再度受け取る可能性があります。元のカードが削除されると、システムはそのユーザーがキャンペーンを受信した記録を認識しなくなるため、次のセッションで再び適格となります。

ユーザーが特定のキャンペーンからメッセージを一度だけ受け取るようにするには、キャンペーンまたはキャンバスステップにオーディエンスフィルターを追加して、当該キャンペーンからメッセージを受け取っていないユーザーを対象にしてください。このフィルターは、長期にわたるキャンペーンからの重複送信を防ぐ最も確実な方法です。

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

コンテンツカードが送信されると、「受信トレイ」で待機し、ユーザーに配信される準備ができています（メールの場合と同様です）。コンテンツがコンテンツカードに取り込まれた後（表示時）、その有効期間中にコンテンツを変更することはできません。これは、コネクテッドコンテンツ経由で 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 日という上限を超えて長く表示させたい場合）、30 日ごとにカードを実質的に更新する定期的なキャンペーンを作成できます。

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