Last updated 2025年3月6日

リンクナビゲーションリクエストメッセージ

概要

リンクナビゲーションリクエストメッセージは、パートナーがランチャーでoverrideLinkNavigationをtrueに指定した場合にのみ送信されます（Integration Launcher Optionsを参照）。このオプトインが行われると、セレクションまたはプレースメントにサブスクライブするとLINK_NAVIGATION_REQUESTメッセージを受け取ります。

例えば、ランチャーでoverrideLinkNavigationをオプトインした後、以下のコードでサブスクライブすることで、ユーザーがリンクをクリックして別のページに移動するたびにイベントを受け取ることができます。

// Roktスクリプトがすでに読み込まれている

const selection = await launcher.selectPlacements({
  attributes: {
    // カタログアイテムを取得するためにRoktが必要とする属性
    eventId: "eventId",
    venueName: "venueName",
    // 追加の属性
    email: "email",
  },
});

selection.on("LINK_NAVIGATION_REQUEST").subscribe((event) => {
  // urlプロパティを使用してナビゲーションリクエストを処理する
  window.open(event.body.url);
});

プロパティ

url

• url: 文字列

overrideLinkNavigation が有効になっているときに顧客がオファーリンクをクリックすると、新しいブラウジングタブが自動的に開かれることはありません。代わりに、Rokt SDK は url を文字列として含むイベントをパートナーに送信します。この URL は顧客体験の低下を避けるために、要求されるブラウジングコンテキスト (合意された Web ビューまたはネイティブ ブラウザー) で即座に開かれる必要があります。