ドキュメントTargetTarget ガイド

ホスト

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者

サイトと実稼動前の環境を整理し、Adobe Target での管理と環境別レポートを容易にします。

ホスト管理の主な目的は、非アクティブなコンテンツが誤って web サイトに表示されるのを確実に防ぐことです。ホスト管理では、レポートデータを環境ごとに分離することもできます。

ホストは、Target リクエストが行われる任意のドメインです。Web サイトでは、通常、Target リクエストを送信する URL の location.hostname プロパティです。

デフォルトでは、Target は、Target リクエストを行ったり Target レスポンスを受信できるホストを制限しません。新しいホストがリクエストを行うと、そのホストは自動的に機能します。このプロセスにより、不明なドメインや予期できないドメインでのテストも可能になります。 このデフォルトの動作を上書きする場合は、許可リストまたはブロックリストを設定して、Target で機能するホストを制限することができます。

ホストを管理するには、Administration/Hosts をクリックします。

hosts_list image

ホストの認識 concept_0D4B43E23AA9408F8B28A57ED754BF65

ホストを認識し、Hosts リストに追加するには、次の条件を満たす必要があります。

  • 1 つ以上の Target リクエストがホストに存在する必要があります。

  • ホスト上のページには、以下が含まれている必要があります。

    • 正しい mbox.js の参照
    • Target リクエストまたは自動生成されたグローバル Target リクエスト

  • Target リクエストのあるページはブラウザーで表示する必要があります。

ページの表示後に、ホストが Hosts リストに表示され、環境内でホストを管理したり、アクティビティとテストをプレビューしたり開始したりできます。

NOTE
この説明は、個人で使用する開発サーバーも対象となります。

ホストが Host リストに追加されたら、そのホストが認識されていることを確認します。

  1. Administration／Hosts ​をクリックします。

  2. ホストが一覧に表示されていない場合は、ブラウザーを更新します。

    デフォルトでは、新しく認識されたホストは Production 環境に配置されます。 この Production 環境は最も安全な環境です。なぜなら、これらのホストからは、非アクティブなアクティビティを表示できないからです。

  3. （条件次第） Move 動アイコン（ 移動アイコン ）をクリックして、ホストを Development、Staging、またはその他の環境に移動します。

NOTE
Production 環境は、たとえ名前を変更したとしても、削除できません。 なぜなら、この環境で、最終のアクティブなキャンペーンとテストを扱うことを前提としているからです。このデフォルト環境では、非アクティブなキャンペーンの表示は許可されていません。

ホストリストの並べ替えと検索 section_068B23C9D8224EB78BC3B7C8580251B0

Hosts リストを並べ替えるには、任意の列ヘッダー（Name、Environment、Last Requested）をクリックして、昇順または降順で並べ替えます。

Hosts リストを検索するには、検索語を Search Hosts ボックスに入力します。

Target リクエストを Target に送信できるホストを指定する許可リストの作成 allowlist

Target リクエストを Target に送信できるホスト（ドメイン）を指定する許可リストを作成できます。この場合、許可リストにないホストがリクエストを生成すると、許可されていない旨を記した承認エラーレスポンスが送信されます。デフォルトでは、Target リクエストを含むホストは、Production 環境の Target に登録され、アクティブで承認済みのすべてのアクティビティへのアクセス権を持ちます。 これが期待された手法でない場合は、代わりに許可リストを使用して、Target リクエストの生成と Target コンテンツの受け取りの資格がある特定のホストを記録できます。すべてのホストは、引き続き Hosts リストに表示されます。また、環境では引き続きこれらのホストをグループ化したり、ホストごとに異なるレベル（ホストがアクティブまたは非アクティブなアクティビティを表示できるかどうかなど）を割り当てることができます。

許可リストを作成するには、次の手順を実行します。

  1. Hosts リストで、「Authorize Hosts」をクリックします。

  2. 「Enable Authorized Hosts for content delivery」切替スイッチを有効にします。

  3. 必要に応じて、Host contains ボックスに目的のホストを追加します。

    複数のホストを追加することもできます。この場合、1 行に 1 つずつ表示されます。

  4. 必要に応じて、Host does not contains ボックスに目的のホストを追加します。

    複数のホストを追加することもできます。この場合、1 行に 1 つずつ表示されます。

  5. Save をクリックします。

許可されていないホストで Target リクエストが行われた場合、/* no display - unauthorized mbox host */ というレスポンスが返されます。

IMPORTANT
セキュリティのベストプラクティス:Target の ubox 機能を使用する場合、この許可リストは、 リダイレクターを使用した場合の移動先であるドメインのリストも制御します。 実装の一部として ubox を使用する場合は、リダイレクト先のドメインを必ず追加してください。許可リストが指定されない場合、Adobe は、リダイレクト URL を検証できず、悪意のあるリダイレクトの可能性から保護できません。
許可リストは、環境よりも優先されます。許可リスト機能を使用する前に、すべてのホストをクリアしてください。すると、許可リストで許可されているホストのみがホストリストに表示されます。その後、ホストを必要な環境に移動できます。

場合によっては、他のサイトからのドメインが環境内に表示されることがあります。ドメインが at.js を呼び出すと、そのドメインがリストに表示されます。例えば、自分の web ページのいずれかが他のユーザーのサーバーにコピーされた場合は、そのサーバーのドメインが自分の環境に表示されます。スパイダーエンジン、言語翻訳サイトまたはローカルディスクドライブからのドメインが表示されることもあります。

mboxHost が API 呼び出しで渡される場合、渡される環境のコンバージョンが記録されます。環境が渡されない場合、この呼び出しでのホストは、デフォルトで Production になります。

Host Does Not Contain ールボックスに目的のホストを追加することで、Target にリクエストを送 Target できないホスト（ドメイン）を指定するブロックリストを作成することもできます。

NOTE
Authorized Hosts リストは、Target ホストとデフォルトのリダイレクトホストの両方に使用されます。 Adobe Target JavaScript SDK（at.js）の使用を許可されているすべての既存のドメイン、および ubox のデフォルトのリダイレクト URL で使用されるすべてのドメインを追加してください。今後、同様のドメインが新しく出てきた場合は、そのドメインを許可リストに追加してください。

ホストの削除 section_F56355BA4BC54B078A1A8179BC954632

不要になったホストは削除することができます。

  1. Hosts リストで、「Delete」アイコンをクリックします。
  2. 「Delete」をクリックして削除を確認します。
NOTE
削除されたホストで、Target リクエストを含むページが他のユーザーによって参照された場合、そのホストは再びリストに表示されます。

ホストのトラブルシューティング concept_B3D7583FA4BB480382CC7453529FE1B7

ホストにおいて問題が発生した場合は次のトラブルシューティングのヒントを試してください。

ホストがアカウントのリストに表示されない。

  • ブラウザーで Hosts ページを更新します。
  • at.js の参照を含め、Target リクエストが正しいことを確認します。
  • そのホストでいずれかの Target リクエストを参照します。ホスト上にあるどの Target リクエストも、これまでブラウザーでレンダリングされたことがなかった可能性があります。

ランダムなドメインまたは不明なドメインが Host リストに表示される。

あるドメインから Target へのリクエストが行われると、そのドメインがリストに表示されます。場合によっては、スパイダーエンジン、言語翻訳サイトまたはローカルディスクドライブからのドメインが表示されることがあります。リストに表示されたドメインがチームで使用されていない場合は、「Delete」をクリックして削除できます。

Target リクエストで「/* no display - unauthorized mbox host */」が返される。

許可されていないホストで Target リクエストが行われた場合、「/* no display - unauthorized mbox host */」というレスポンスが返されます。

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654