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

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

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

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

• campaign
• canvas

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

次の3つ主なコンテンツカードタイプのいずれかを選択します。Classic、キャプションイメージ、およびイメージのみ。

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

メッセージの種類	例	説明
クラシック		クラシックカードはシンプルなレイアウトで、太字のタイトル、メッセージ本文、そしてタイトルと本文の左側に配置されるオプションの画像, 写真がある。クラシックカードには正方形の画像やアイコンを使うことがいます。
キャプション付き画像		キャプション付き画像カードでは、コピーと注目を集める画像でコンテンツを紹介できます。
画像のみ		画像のみのカードは、画像、GIF、およびその他のクリエイティブな非テキストコンテンツ用のスペースで注目を引きます。

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

メッセージエディターのComposeタブで、メッセージの内容と動作のあらゆる面を編集できる。

ここでの内容は、前のステップで選択したカード・タイプによって異なるが、以下のオプションのいずれかを含むことができる：

言語

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

右から左へのメッセージを作成する

右から左へのメッセージの最終的な出現は、サービスプロバイダがそれらをどのようにレンダリングするかに大きく依存します。右から左へのメッセージを可能な限り正確に表示するためのベストプラクティスについては、右から左へのメッセージを作成するを参照してください。

タイトルとメッセージ

何でも好きなことを書けばいい。制限はありませんが、メッセージを素早く伝え、顧客にクリックしてもらうほど良いです!明確で簡潔なタイトルとメッセージ内容を推奨する。これらのフィールドはイメージ専用カードには提供されていないことに注意してください。

画像

Add Imageを選択するか、画像URLを指定して、コンテンツカードに画像を追加します。Add Imageを選択すると、Media Libraryが開き、以前にアップロードしたイメージを選択したり、新しいイメージを追加したりできます。各メッセージタイプとプラットフォームには、独自の提案された比率と要件がある場合があるため、それらが何であるかを確認してから、試運転を開始したり、イメージをゼロから作成したりしてください。コンテンツカードメッセージフィールドの合計サイズは2KB に制限されていることに注意してください。

先頭にピン留め

Brazeはユーザーのフィード上部に固定カードを提示し、ユーザーはそれを閉じることができない。ユーザーのフィードに複数の固定カードがある場合、Brazeはそれらを時系列順に並べる。カードを送信した後は、ピン留めオプションを後から更新することはできない。キャンペーン送信後にこのオプションを変更しても、影響があるのは今後の送信のみだ。

オン・クリック動作

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

コンテンツカードのリンクには、次のアクションを使用できます。

アクション (Action)	説明
ウェブURLにリダイレクトする	ネイティブでないウェブページを開く。
アプリにディープリンクする	アプリの既存画面にディープリンクする。
カスタムイベントを記録する	トリガーするカスタムイベントを選択する。別のコンテンツカードを表示したり、追加メッセージのトリガーとして使用できる。
カスタム属性を記録する	現在のユーザーに設定するカスタム属性を選択する。

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

ステップ 4:追加の設定を行う (オプション)

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

キーと値のペアをメッセージに追加するには、Settings タブに移動し、Add New Pair を選択します。

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

• campaign
• canvas

ステップ 6:レビューと展開

キャンペーンまたはキャンバスの最後のビルドが完了したら、その詳細を確認してから、test itを実行し、準備ができたら送信します。

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

知っておくべきこと

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

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

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

単一のコンテンツカードの全データペイロードは、Liquidパーソナライゼーションのレンダリング後、2KBを超えてはならない。これには以下が含まれます:

• タイトル
• メッセージ
• 画像URL（URL文字列自体の長さであり、画像ファイルのサイズではない）
• リンクテキスト
• 指定された全プラットフォームのリンクURL（iOS、Android、WebのURLはそれぞれ別々にカウントされ、合計数に加算される）
• キーと値のペア（キー名とその値の両方）

カスタム属性などから長い文字列を取得するためにLiquidを使うと、制限を超える可能性がある。

キャンペーン作成ツールは、静的コンテンツが制限を超えた場合に警告を表示する。(ダイナミックなコンテンツのサイズについては、Liquidを使用して予測しない。)メッセージサイズが2KBを超える場合、送信時に中断される。これらの中止は、メッセージング活動ログで理由と共に確認Content card maximum size exceededできる。

コンテンツカードのペイロードサイズを管理するためのベストプラクティスを以下に示す：

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

フィードのカードの枚数

各ユーザーのフィードには、有効期限が切れていないコンテンツカードを常時250枚まで含めることができます。この制限を超えると、Braze は、未読のカードであっても、最も古いカードの返却を停止します。破棄されたカードもこの制限にカウントされる。つまり、破棄されたカードが多いと、古いカードのための空きスペースが減る。

カードの利用限度額に関する問題を防止するため、以下のベストプラクティスを推奨する：

• より短い有効期限を使う：時間制限のあるキャンペーン（週末セールなど）には、具体的な終了日を設定する。こうすることで、カードは自動的にフィードから削除され、関連性がなくなった後は制限数にカウントされなくなる。
• アクションベースの除去を活用する：トランザクションベースまたは目標ベースのカードに対して、削除イベントを設定する。例えば、プロファイルを完成させるようユーザーに促すカードは、イベントprofile_completedが記録されたらすぐに削除すべきだ。
• 長期にわたるキャンペーンを監査する：定期的または継続的なキャンペーンを見直し、時間の経過とともにフィードに過剰なカードを表示することで、ユーザーに不快な体験を強いることがないようにする。

コンテンツカードの再利用資格について

再適格性は、ユーザーが同じキャンペーンからメッセージを複数回受信できるかどうか、またそのタイミングを決定する。コンテンツカードについては、この仕組みを理解することが重要だ。繰り返しキャンペーンを管理し、ユーザーが重複したメッセージや古いメッセージを受け取らないようにするためである。

再資格の計算方法

再参加を有効にすると、ユーザーがキャンペーンに「再参加」できるまでのカウントダウンは、メッセージが送信された後に開始される。このカウントダウンが始まる具体的なタイミングは、カード作成時の設定次第だ：

• コンテンツカードは、最初のインプレッション時にインプレッション時間を用いて再適格性を計算する。
• キャンペーン開始時またはキャンバスステップの開始時に作成されたコンテンツカードは、送信時間とインプレッション時間のいずれか遅い方を使用する。

30日間の有効期限と再資格取得

よくある混乱の原因は、キャンペーンの再参加資格と、全てのコンテンツカードが自動的に30日で期限切れになることとの相互関係にある。

すべてのコンテンツカードは、送信または削除されてから30日後にBrazeのシステムから自動的に削除される。長期にわたり繰り返し実施されるキャンペーンで再対象化を無効にしている場合でも、ユーザーは30日後に同じカードを再度受け取る可能性がある。元のカードが削除されると、システムはそのユーザーがキャンペーンを受信した記録を認識しなくなる。そのため、次のセッションでは再び対象となる資格を得る。

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

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

コンテンツカードが送信されると、彼らは”inbox”で待機し、ユーザーに配信する準備ができています(メールの場合と同様)。コンテンツがコンテンツカードに取り込まれた後 (表示時)、その有効期間にコンテンツを変更することはできません。これは、コネクテッドコンテンツ経由で 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日以上長持ちさせる

カードを常に利用可能に見せたい場合（i.eつまり、30日という上限を超えて長く表示させたい場合）、30日ごとにカードを実質的に更新する定期的なキャンペーンを作成すればよい。

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