コンバージョンAPIゲートウェイとSignals Gateway: トラブルシューティングガイド

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

以下のようにトラブルシューティング手順を実行し、ゲートウェイ製品、コンバージョンAPIゲートウェイ、またはSignals Gatewayの問題を解決します。

ゲートウェイ製品ヘルスチェックエンドポイント

まず、

https://<Gateway Products Endpoint>/hub/health/

ホストは、このヘルスチェックサービスを通してインスタンスのサーバーの状態をモニタリングすることができます。

問題1: ホストゲートウェイUIにアクセスできない、または情報が表示されない

ステップ1. https://dnschecker.org/のようなオンラインDNSチェッカーを使用して、ゲートウェイのドメインがインスタンス設定で指定された正しいIPアドレスに解決され完全に伝播されているかどうかを確認します。そうでない場合は、DNSが完全に伝播されるまでしばらく待ちます。また、ドメインレジストラーにCNAMEレコードを作成してあることを確認します。

ステップ2.ネットワークが一時的にアクセスできない可能性があります。数分待ってからゲートウェイ製品UIに再ログインするか、ページを更新してください。

ステップ3. インスタンスのリソースが不足している可能性があります。以下の手順に沿ってポッドを終了してリソースを解放します。

セッションマネージャに接続し、以下のコマンドを実行してゲートウェイ製品のポッドを終了します。
5分待機してから、コマンド[kubectl get pods -A]を実行してください。ポッドのステータスはすべて[実行中]か[完了]のいずれかであるはずです。
いずれかの状態でない場合は、コマンド[kubectl delete deployment hub]を実行して、Hubポッドを終了します。上記のステップを繰り返します

ステップ4. 新しいインスタンスを使用している場合は、アンインストールしてからインスタンスを再インストールします。

ステップ5.以下のものをMetaの連絡窓口と共有します(該当する場合)

ゲートウェイ製品のログ
これらは、/hub/settings/updatesページから[ログをダウンロードする]ボタンをクリックしてダウンロードできます。
エラーが発生しているホストゲートウェイUIツールのスクリーンショット。

GCPホストのオンボーディング中に「エラー400: IDプールが存在しません(myproject-3-XXXXX.svc.id.goog)」が発生する

通常、このエラーが発生するのは、GCPアカウントでGoogle Kubernetes Engineクラスターが作成されておらず、基礎となるリソースを初めて作成する際に時間がかかるためです。インストールをクリーンアップし、新しいインストールを再試行するには、アンインストールガイドに記載されたアンインストールスクリプトを使用してください。

GCPホストのオンボーディング中にCloudShellセッションがタイムアウトした

CloudShellセッションを長期間放置すると、CloudShell端末が切断されることがあります。その場合でも、インストールがすでに完了していることがあります。インストール手順を確認するには、GCP Cloud Storageページを開き、capig-{your_login_id}-XXX-storage-bucket という名前のバケットを探してください。capig-onboarding-guide.txtという名前のファイルがあります。このファイルを開いて、表示される指示に従ってください。

アカウントのトラブルシューティングステップ: ゲートウェイへの接続

以下のトラブルシューティング手順に沿って問題を解決します。

問題1: インストールを完了できない

オンボーディングガイドに記載されたすべての手順を実施したことを確認してください。それでもブロックが解除されない場合は、Metaの連絡窓口にご連絡いただき、問題の明確な説明をご提示ください。その際、スクリーンショットをご提供いただけますと、より対応の支援につながります。

問題2: ゲートウェイUIにアクセスできない、または情報が表示されない

ステップ1. ネットワークが一時的にダウンしていないかどうかを確認します。数分待ってからゲートウェイ製品UIに再ログインするか、ページを更新します。

ステップ2.以下のものをMetaの連絡窓口と共有します(該当する場合)

ゲートウェイ製品のログ
エラーが発生しているホストゲートウェイUIの開発者ツールのコンソールのスクリーンショット

問題3: インストールが完了した後にゲートウェイイベントを受信できない

ステップ1. ウェブサイトがブロックされている可能性があります。デフォルトでは、ゲートウェイ製品に関連付けられたピクセルからイベントを受信するすべてのウェブサイトが、イベントの受信および公開を許可されています。イベントを受信および公開できないのは、ウェブサイトがブロックされている場合のみです。

診断

ゲートウェイ製品UIを開き、左側のメニューから[ウェブサイト] > [ブロックされたウェブサイト]を選択してください。

解決策

イベントを受信および公開することが必要なウェブサイトのブロックを解除します。

ステップ2.ピクセルが標準的な方法でインストールされていない可能性があります。ゲートウェイ製品を正しく機能させるために、ウェブサイトの<head>タグに直接ピクセルを追加することをおすすめします。

診断

[解決方法]のセクションに記載されているガイドラインに従って、ピクセルがインストールされているかどうかを確認します。
イベント設定ツールを使用して、イベントが設定されているかどうかを確認します。現在、ゲートウェイ製品はイベント設定ツールを使用して構成されたイベントのトラッキングには対応していません。

解決策

ピクセルにベースコードをインストールする
- Metaピクセルについては、こちらの手順をご覧ください
- Signals Gatewayピクセルについては、データソースの詳細モーダルに手順が記載されています
また、コンバージョンをトラッキングする場合は、コンバージョントラッキングコードを実装します。コンバージョンをトラッキングするすべてのページにベースコードがインストール済みであることを確認します。

ステップ3. DNSの設定が不完全または間違っている可能性があります。ピクセルは、ゲートウェイとの通信に適切なドメインを使用します。ピクセルが起動するページと同じドメインを使用するのが理想的です。例えば、ピクセルがadvertiser.comで起動する場合は、gateway.advertiser.comでピクセルがゲートウェイに到達できるようになるのが理想です。

アカウントのドメイン(ピクセルが起動するドメイン)のサブドメインは、広告主のDNSプロバイダーでCNAMEレコードを使用してホストのサブドメインに関連付ける必要があります。これにより、ピクセルが一人称のリクエスト呼び出しによってゲートウェイ製品のエンドポイントにアクセス可能になります。

診断

https://dnschecker.org/のようなオンラインDNSチェッカーを使用して、上記で説明したCNAMEレコードが正しく設定されているかどうかを確認してください。つまり、アカウントのサブドメインがホストサブドメインを正しく指し、そのホストサブドメインが作成時に割り当てられた負荷分散ドメインを指していることを確認してください。アカウントのサブドメインが最終的に負荷が分散されたドメインを指し示していない場合、続くステップについては[解決方法]のセクションをご覧ください。

解決策

ドメインレジストラーの管理者と共同で作業します。
ドメインレジストラーでDNSレコードを更新し、ゲートウェイ製品サーバーのIPアドレスを設定します。DNS CNAMEレコードを設定し、ゲートウェイ製品のサブドメインをセットアップ時に生成されたサーバーのIPアドレスにマッピングします。

ステップ4. コンテンツセキュリティポリシー(CSP)に基づいて、イベントがブロックされる場合があります。一部のウェブサイトでは、CSPが設定されており、これがゲートウェイ製品によるイベントの受信をブロックすることがあります。

診断

広告主のウェブサイトのサーバー上にコンテンツセキュリティポリシーの応答ヘッダーが設定されているかどうかを確認します。

解決策

サブドメインをCSPルールの許可リストに追加して、ポリシーの例外としてください。

ステップ5.ピクセルを完全に接続解除して再接続します。

ステップ6.有効なシステムアクセストークンを使用していることを確認します。

診断

広告主のウェブサイトのサーバー上にコンテンツセキュリティポリシーの応答ヘッダーが設定されているかどうかを確認します。

https://<Gateway Product Endpoint>/capig/graphiql/にアクセスします。以下のコマンドにtenantIdを貼り付けて、対応するアクセストークンを取得します。

query test {
   tenantQueries (tenantId:"") {
    account {
      signalConfigs {
        connectionId
        connectionStatus {
          badToken
          accessTokenAvailable 
        }
      }
    }
  }
}

tenantIdを見つけるには、ゲートウェイ製品のUIに移動し、URLリンクがhttps://<Gateway Product Endpoint>/hub/capig/?tenant=<tenentId>として表示されている該当アカウントを選択します。

badTokenの結果がtrueを返す場合は、[データソースの追加]ボタンをクリックして同じデータソースを再度追加して修正します。

ステップ7.ホストUIにアクセス可能であるかどうかをホストで確認し、このガイドのトラブルシューティングの手順を実施します。