カスタムチャネルの設定 create-custom-channel

左側のナビゲーションパネルで​管理 > チャネル​に移動します。

「チャネルビルダー」セクションで「カスタムチャネル」を選択します。

{width="100%"}

インベントリには、サンドボックス内のすべてのカスタムチャネルが一覧表示されます。これには、現在のステータスと、外部エンドポイントへの接続に使用された認証タイプが含まれます。

カスタムチャネルは、作成者のステータス（ドラフト、アクティブ、または​アーカイブ）でフィルタリングし、名前で検索できます。

チャネルを編集するには、インベントリ内のチャネル名をクリックし、変更を加えて保存します。 アクティブなチャネルの場合は、特定のフィールドのみを編集できます – 詳細情報。

チャネルをアーカイブするには、インベントリからチャネルを開き、アーカイブ​をクリックします。

アクティブなチャネルをアーカイブすると、キャンペーンアクションセレクター、ジャーニーアクションパレット、個のチャネル設定、コンテンツテンプレートなど、すべての選択ドロップダウンからチャネルが削除されます。 すでにチャネルを使用している既存のジャーニーやキャンペーンは、引き続き正常に機能します。

「カスタムチャネルを作成」ボタンをクリックして、チャネル作成フォームを開きます。 まず、カスタムチャネルの一般的な設定を定義します。

{width="70%"}

「プロパティ」セクションに、カスタムチャネルの​ 名前 ​を入力します。 この名前は、ジャーニーキャンバスおよびキャンペーンアクションセレクターに表示されます。

デフォルトのアイコンライブラリからアイコンを選択するか、コンピューターからSVG ファイルを選択できます。

このアイコンは、ジャーニーキャンバスのチャネル名の横に表示されます。 アイコンがアップロードされない場合は、デフォルトのアイコンが使用されます。

オプションの​ 説明 ​を入力します。

エンドポイント設定 セクションで、外部メッセージシステムのホスト URL​を入力します。 例：https://api.my-messaging-provider.com/v1/messages。

必要に応じて​ Headers ​を追加します。 ヘッダーは、HTTP リクエストレベルで送信されるキーと値のペアです。 エンドポイントへのあらゆるリクエストと並行して送信され、通常は認証トークン、コンテンツタイプの仕様、または外部システムに必要なその他のメタデータに使用されます。

{width="60%"}

各ヘッダーについて、その値が次であるかどうかを定義できます。

• 定数 – 静的値が1回設定され、すべてのリクエストに含まれます。 例えば、値application/jsonのContent-Type パラメーターまたは値UTF-8のCharset パラメーターを定義できます。
• 変数 - デフォルト値がここに入力されている場合は、チャネル設定で上書きされない限り使用されます。 例えば、実行時に解決されるユーザーIDの変数を定義できます。 詳細情報

必要に応じて、同じ定数/変数パターンを使用して​ クエリパラメーター ​を追加します。 クエリパラメーターは、配信時にエンドポイント URLに追加されます。 定数パラメーターは常に同じ値で追加されます。変数パラメーターは送信時に解決されます。例えば、ユーザー識別子をプロファイルから渡します。

{width="60%"}

「ポリシー設定」セクションで、Journey Optimizerがリクエストのスループットと失敗をどのように処理するかを定義します。 これは、外部システムがリクエストの量を処理できるようにし、過剰な負荷を避けるために重要です。

{width="70%"}

• スロットルを有効にする - デフォルトでは無効になっています。 1秒あたりのリクエストの最大数を設定します（デフォルト：5,000c）。 制限に達すると、リクエストはキューに入れられ、できるだけ早く送信されます。
• 再試行を有効にする - デフォルトで有効になっています。 失敗したリクエストの最大再試行回数（デフォルト：3、設定可能な範囲：0 ～ 10）を設定します。 これにより、一時的なエラー時にエンドポイントに負担をかけるのを防ぐことができます。
• タイムアウト - デフォルト：5,000 ミリ秒。リクエストが失敗したと考える前に、エンドポイントからの応答を待つための最大時間を設定します。

「ペイロードを定義」をクリックし、ペイロードの定義方法を選択します。

• サンプル JSON ペイロードの貼り付け – 代表的なJSON オブジェクトを貼り付けると、Journey Optimizerは、そのオブジェクトからスキーマを自動的に推測します。 次に例を示します。

  code language-json
  { "channelId": "KakaoTalk08", "title": "Flash Sale: 48 Hours Only", "body": "New arrivals just dropped. Shop now before they're gone!", "image": "https://demo-system-next.s3.amazonaws.com/assets/luma/luma-flash-sale-banner.jpg" }

• JSON スキーマの読み込み （近日リリース予定） – 完全なJSON スキーマファイルをアップロードします。

  note availability
  AVAILABILITY
  この機能はまだ利用できません。 将来のリリースで追加される予定です。

スキーマを生成すると、Journey Optimizerは検出されたすべてのフィールドをフォームビューに表示します。

{width="80%"}

各フィールドに対して、次の設定を行います。

ネストされたフィールドは、ドット表記法を使用して表されます（例：image.id）。