ブランドメッセージ
カカオブランドメッセージは、ブランドメッセージAPIを使用して、広告の受信に同意したカカオトークチャネルの友達やユーザーにパーソナライズされた広告メッセージを送信するマーケティングツールです(カカオトーク広告同意)。これにより、イベント、プロモーション、キャンペーンのセグメント化されたオーディエンスにカスタマイズされたメッセージを効果的に配信できます。
リクエストスキーマ、ボタンタイプ、クーポンオブジェクト、ターゲティングオプションなど、API実装の詳細については、 ブランドメッセージの送信を参照してください。テンプレート管理については、「 ブランドメッセージテンプレートの取得」を参照してください。
NTT CPaaSプラットフォームでブランドメッセージを送信する方法は、カカオトークでメッセージを送信するをご参照ください。API連携ガイドは、 カカオトーク over APIをご参照ください。
概要
次の表は、各ブランドメッセージタイプのコンテンツ、ボタン、クーポンの制限をまとめたものです。
| メッセージの種類 | テキスト制限 | 最大ボタン数 | ボタン ラベルの制限 | 配置 | クーポン |
|---|---|---|---|---|---|
| テキスト | 1,300文字/99改行 | 5 | 14文字 | 垂直 | 1 |
| 画像 | 1,300文字/99改行 | 5 | 14文字 | 垂直 | 1 |
| ワイド画像 | 76文字/5改行 | 2 | 8文字 | 水平 | 1 |
| ワイドリスト | ヘッダー: 20/リスト 1: 25/リスト 2-5: 30 文字 | 2 | 8文字 | 水平 | 1 |
| 回転木馬 | ヘッダー:20/コンテンツ:180文字 | カードごとに1〜2個 | 8文字 | 水平 | カルーセルごとに 1 個 |
| プレミアムビデオ | ヘッダー:20/コンテンツ:76文字 | 1 | 8文字 | N/A | N/A |
| 商業 | 商品名:30文字 | 2 | 8文字 | 水平 | コマースごとに 1 つ |
| カルーセルコマース | ヘッダー: 20/製品: 30 文字 | カードごとに1〜2個 | 8文字 | 水平 | カルーセルごとに 1 個 |
コマースとカルーセルコマースは、視覚的に目立つクーポン配置であるクーポン強調ボタンを使用します。他のすべてのメッセージタイプは、標準のクーポンボタンを使用します。クーポンタイプの値とスキーマの詳細については、 ブランドメッセージの送信 API リファレンスを参照してください。
画像仕様
次の表は、イメージをサポートするメッセージの種類のイメージ要件をまとめたものです。
| メッセージの種類 | 推奨サイズ | アスペクト比 | 最小幅 | 形式 | 最大サイズ |
|---|---|---|---|---|---|
| 画像 | 800ピクセル×400ピクセル | 2:1から3:4 | 500ピクセル | .jpg、.png | 5MB |
| ワイド画像 | 800ピクセル×600ピクセル | 2:1から1:1 | 500ピクセル | .jpg、.png | 5MB |
| 回転木馬 | 800px x 600px または 600px x 800px | 2:1から3:4 | 500ピクセル | .jpg、.png | 5MB |
| 商業 | 800px x 600px または 600px x 800px | 2:1から3:4 | N/A | .jpg、.png | 5MB |
| カルーセルコマース | 800px x 600px または 600px x 800px | 2:1から3:4 | N/A | .jpg、.png | 5MB |
| プレミアムビデオ | 該当なし(カカオ主催) | 2:1から9:16 | N/A | AVI、FLV、MP4 | 1ギガバイト |
テキスト
テキスト メッセージは 1 つのテキスト ブロックで構成され、ボタンとクーポンが含まれる場合があります。
| カテゴリ | 詳細 |
|---|---|
| コンテンツ | テキストのみ、単一ブロック。言語(EN/KR)に関係なく、スペースを含めて最大1,300文字です。最大 99 個の改行。 |
| ボタン | 縦に並べたボタンは最大5つ。各ボタン ラベルは、スペースを含めて最大 14 文字をサポートします。クーポン強調ボタンが含まれている場合、リンクボタンの最大数は 4 つです。 |
| クーポンボタン | 最大 1 個 |
画像
画像メッセージには、画像とテキストブロックが含まれます。
| カテゴリ | 詳細 |
|---|---|
| 画像 | 必要なアスペクト比: 3:4 (縦向き) から 2:1 (横向き)。推奨サイズ:800px x 400px。最小幅は500pxです。 ファイル形式:.jpg、.png。最大ファイルサイズ: 5 MB。 |
| コンテンツ | テキストのみ、単一ブロック。言語(EN/KR)に関係なく、スペースを含めて最大1,300文字です。最大 99 個の改行。 |
| ボタン | 縦に並べたボタンは最大5つ。各ボタン ラベルは、スペースを含めて最大 14 文字をサポートします。クーポン強調ボタンが含まれている場合、リンクボタンの最大数は 4 つです。 |
| クーポンボタン | 最大 1 個 |
ワイド画像
ワイド イメージ メッセージには、ワイド フォーマットのイメージと短いテキストが含まれます。
| カテゴリ | 詳細 |
|---|---|
| 画像 | 水平と垂直の比率は2:1から1:1です。推奨サイズ:800px x 600px。最小幅は500pxです。 ファイル形式:.jpg、.png。最大ファイルサイズ: 5 MB。 |
| コンテンツ | テキストのみ、単一ブロック。言語(EN/KR)に関係なく、スペースを含めて最大76文字です。改行は最大 5 回です。 |
| ボタン | 最大2つのボタンを水平に配置。各ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
| クーポンボタン | 最大 1 個 |
ワイドリスト
ワイド リスト (API タイプ: ITEM_LIST_FREE_FORM) メッセージには、構造化されたリスト形式で画像とテキストを含む複数のアイテムが表示されます。
| カテゴリ | 詳細 |
|---|---|
| ヘッダー | テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 20 文字です。LINE 改行は許可されません。 |
| リスト 1 - 画像とテキスト | 推奨画像サイズは800px x 400px、比率は2:1です。 ファイル形式: .jpg、.png、最大 5 MB。 テキストのみ、単一ブロック。言語(EN/KR)に関係なく、スペースを含めて最大25文字です。最大1つの改行。 |
| リスト 2-5 - 画像とテキスト | 画像が 3 枚以上、合計 5 枚まで (リスト 1 の項目を含む)。推奨画像比率は1:1(正方形)、推奨サイズは800px x 800pxです。 ファイル形式: .jpg、.png、最大 5 MB。 テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 30 文字です。最大1つの改行。 |
| ボタン | 最大2つのボタンを水平に配置。各ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
| クーポンボタン | 最大 1 個 |
カルーセルフィード
カルーセル メッセージには、ユーザーがスワイプできる複数のカードが表示されます。
| カテゴリ | 詳細 |
|---|---|
| 画像 | 推奨サイズ:800px x 600pxまたは600px x 800px。最小幅は500pxです。必要なアスペクト比: 3:4 (縦向き) から 2:1 (横向き)。 ファイル形式: .jpg、.png、最大 5 MB。 |
| ヘッダー | テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 20 文字です。LINE 改行は許可されません。 |
| コンテンツ | テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 180 文字です。最大 10 個の改行。 |
| ボタン | カルーセルカードごとに、最小1個、最大2個のボタンが水平に配置されています。各ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
| クーポンボタン | カルーセル設定ごとに最大 1 つ |
最小2枚、最大6枚のカルーセルカードを取り付けることができます。
プレミアムビデオ
プレミアム動画メッセージには、カカオにアップロードされた動画コンテンツが含まれます。
| カテゴリ | 詳細 |
|---|---|
| ビデオ | カカオにアップロードされた動画のみ、動画リンクを通じて使用できます。推奨される水平対垂直の比率: 2:1 から 9:16。 推奨形式: AVI、FLV、MP4、最大 1 GB。 |
| ヘッダー | テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 20 文字です。LINE 改行は許可されません。 |
| コンテンツ | テキストのみ、単一ブロック。言語(EN/KR)に関係なく、スペースを含めて最大76文字です。改行は最大 5 回です。 |
| ボタン | 最大1つのボタン。ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
商業
コマースメッセージには、価格などの商品情報が表示されます。
| カテゴリ | 詳細 |
|---|---|
| 画像 | 推奨サイズ:800px x 600pxまたは600px x 800px。推奨されるアスペクト比は 2:1 から 3:4 の間です。 ファイル形式: .jpg、.png、最大 5 MB。 |
| 製品名 | テキストのみ、単一ブロック。言語 (EN/KR) に関係なく、スペースを含めて最大 30 文字です。LINE 改行は許可されません。 |
| 料金情報 | 通常価格、通常価格+割引価格+割引率、または定額割引価格として入力します。数字のみが許可されます。 |
| 追加情報 | EN/KRも同様に適用された。スペースを含めて最大34文字。最大1つの改行。 |
| ボタン | 最大2つのボタンを水平に配置。各ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
| クーポン強調ボタン | カルーセルごとに最大 1 個 |
カルーセルコマース
カルーセルコマースメッセージは、カルーセルレイアウトとコマースコンテンツを組み合わせたものです。
| カテゴリ | 詳細 |
|---|---|
| 画像(共通) | 推奨サイズ:800px x 600pxまたは600px x 800px。必要なアスペクト比: 3:4 (縦向き) から 2:1 (横向き)。 ファイル形式: .jpg、.png、最大 5 MB。すべてのカルーセル画像は、同じ縦横比を使用する必要があります。 |
| ヘッダー | EN/KRも同様に適用された。スペースを含めて最大 20 文字。LINE 改行は許可されません。 |
| コンテンツ | EN/KRも同様に適用された。スペースを含めて最大 50 文字。改行は最大 2 回です。 |
| 製品名 | EN/KRも同様に適用された。スペースを含めて最大 30 文字。絵文字は許可されていません。LINE 改行は許可されません。 |
| 料金情報 | 通常価格、通常価格+割引価格+割引率、または定額割引価格として入力します。数字のみが許可されます。 |
| 追加情報 | EN/KRも同様に適用された。スペースを含めて最大34文字。最大1つの改行。 |
| ボタン | カルーセルカードごとに、最小1個、最大2個のボタンが水平に配置されています。各ボタン ラベルは、スペースを含めて最大 8 文字をサポートします。 |
| クーポン強調ボタン | カルーセル設定ごとに最大 1 つ |
イントロが含まれている場合:最小1枚、最大6枚のカルーセルカード。イントロが含まれていない場合:最小2枚、最大6枚のカルーセルカード。
関連する API リファレンス
このページで説明されていない実装の詳細については、次の API リファレンスを参照してください。
- ブランドメッセージの送信 - リクエストスキーマ、ボタンタイプ(
APP_LINK、URL、BOT_KEYWORD、MESSAGE_DELIVERY、BUSINESS_FORM、ADD_CHANNEL)、クーポンオブジェクト、ターゲティングオプション(ALL_CONSENT、NON_FRIENDS、TARGETED_FRIENDS)、SMSフェイルオーバー、配信時間枠 - ブランドメッセージテンプレートの取得 - 登録済みのブランドメッセージテンプレートの取得
- ブランドメッセージテンプレートの作成 - 変数タイプのテンプレート(
TEXT_VARIABLE、IMAGE_VARIABLE、IMAGE_WIDE_VARIABLE、ITEM_LIST_VARIABLE)を作成します。 - ブランドメッセージ配信レポートの取得 - 配信ステータスレポートの取得
- メッセージ・ログの取得 - アウトバウンド・メッセージ・ログの取得