> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).

# 検証とトラブルシューティング

## テストと検証

### 公開前の検証チェックリスト

**技術統合**

* [ ] API :`POST /ads/v3/brand-pages` 200を返します `contentData`.
* [ ] レンダリング : コンテンツモジュールがサイト上で正しい順序で正しくレンダリングされている。
* [ ] テーマ : `theme` フィールドが正しく適用されている。 `null` 値はリテール企業のスタイルガイドのデフォルト値にフォールバックする。
* [ ] オプショナルフィールド : レンダラーとトラッキングロジックは、エラーを発生させることなく、省略された、nullの、または空のオプショナルモジュールフィールド、および省略されたトラッキングノードを許容する必要がある（単一のデモブランドページだけでなく、複数のライブテンプレートを使用して検証する）。
* [ ] スタイリング : ブランドページがサイトのデザインシステムと一致している。
* [ ] モバイル : ブランドページがモバイルデバイスで正しく表示される。
* [ ] キャッシュバスター : `{TS}` 値がリクエストごとに変更される。

**トラッキングの検証**

* [ ] インプレッションピクセル (C2S) : 次の各エントリー `trackingTemplates.client.impressionPixelUrls` が発火し、200を返す `image/gif`
* [ ] インプレッション通知 (S2S) : 構築されたサーバーインプレッションURL。**GET** または **POST** で Epsilon トラッキングホストへ直接送信すると、204 No Content を返す。
* [ ] クリックトラッキング (C2S) : 構築された `client.clickRedirect` URLが正しい遷移先へ 302 を返すか、構築された `client.clickEvent` が 204 No Content を返す（フローで使用するいずれか一方のオプション。両方ではない）。
* [ ] クリック通知 (S2S) : 構築されたサーバーURLへ直接 **GET** または **POST** を送信すると 204 No Content を返す
* [ ] カート追加 (C2S) : 構築された `client.addToCartEvent` がイベントビーコンとして発火し、204 No Content を返す
* [ ] カート追加 (S2S) : 構築された `server.addToCartEvent` がトラッキングホストへ直接呼び出され、204 No Content を返す

**インフラストラクチャとプライバシー**

* [ ] リバースプロキシ : C2Sトラッキングリクエストがドメイン経由で転送されている。S2Sはプロキシ経由で送信されていない
* [ ] ヘッダー : `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` がプロキシされたリクエストに存在する
* [ ] プライバシー : パラメーターやURLにPIIが含まれていない
* [ ] HTTPS : すべてのリクエストで安全な接続を使用する
* [ ] 商品ページ : クリックリダイレクト後にページが正しくレンダリングされる

### 推奨ツール

* ブラウザの開発者ツール: ピクセルの読み込みとリダイレクトを検査するためのネットワークタブ。
* FiddlerまたはCharles Proxy: リバースプロキシの動作とヘッダーの転送を検査します。

### トラブルシューティング

| 問題                           | 確認事項                                                                                                                                 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| ピクセルの読み込みに失敗する               | DNS/SSLを検証し、プロキシパスの書き換えを確認し、以下への到達可能性を確認します Epsilon トラッキングホスト。                                                                       |
| リダイレクトが転送されない                | 以下を確認してください `{RURL}` URLエンコードされていること、プロキシがクエリ文字列を保持していることを確認します。                                                                     |
| APIがコンテンツを返さない               | 以下を確認してください `catalogId` および `urlSlug` アクティブなブランドページキャンペーンに一致していること。                                                                  |
| 広告ブロッカーによってトラッキングがブロックされる    | リバースプロキシが設定されていることを確認します - トラッキングは自社ドメイン経由でルーティングされる必要があります。                                                                         |
| カート追加がトラッキングされない             | カート操作後に、構成されたクライアントまたはサーバーのカート追加URLを発火させているか確認してください。                                                                                |
| 一部のブランドページの読み込み時にページで例外が発生する | doc/exampleフィールドを常に必須として扱っている可能性があります。生のモジュールJSONをログに出力し、オプショナルのキーや不足しているトラッキングに対するガードを追加し、テンプレートがそれらのフィールドを許可または無効化していることを確認してください。 |
| テーマの色が正しく適用されない              | 以下を確認してください `null` テーマフィールドが、リテラルのnull値や空文字列としてレンダリングされるのではなく、スタイルガイドのデフォルトにフォールバックすること。                                             |

## 用語集

**ブランドページ統合の重要用語**

| 用語         | 定義                                                                                                                                                                                                                                                                                                     | 例                                                                |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| APIキー      | 以下に対する認証資格情報: Epsilon サービス                                                                                                                                                                                                                                                                             | `Basic abc123xyz...`                                             |
| ブランドページ    | サイト上のブランドランディングページ体験                                                                                                                                                                                                                                                                                   | yoursite.com/brands/nike                                         |
| C2Sトラッキング  | Client-to-Server: ブラウザベースのトラッキング。インプレッションは1x1ピクセルを使用、クリックは302リダイレクトまたはイベントビーコンを使用、カート追加はイベントビーコンを使用します。                                                                                                                                                                                                | `<img src="impression-pixel">, navigator.sendBeacon(clickEvent)` |
| S2Sトラッキング  | Server-to-Server: バックエンドトラッキング（構成されたトラッキングURLへのGETまたはPOST）                                                                                                                                                                                                                                             | お客様のサーバー → Epsilon サーバー                                          |
| コンテンツモジュール | 個別のコンテンツブロック（ヒーロー、テキスト、商品など）                                                                                                                                                                                                                                                                           | ヒーローバナー、商品グリッド                                                   |
| モジュールタグ    | モジュール上のオプションの文字列ラベル（例: `["header"]`）で、テンプレート内で設定されます。リテールメディアがレイアウトのルーティング、アナリティクス、または自社コンポーネントへのマッピングに使用します。空の場合はレスポンスから省略されます。                                                                                                                                                                       | `"tags": ["header"]`                                             |
| テーマ        | APIレスポンスの成功時には常に存在: ネストされた `colors` （背景 + 7つのテキスト役割）および `buttons` (`primary` / `secondary` （ `background` および `text`付き）。すべてのテーマカラーフィールドは必須です（hex6）。以下を参照してください: [テーマオブジェクト](/retail-media-interface/integration/ja/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } }               |
| インプレッション   | ユーザーがブランドページを表示したとき                                                                                                                                                                                                                                                                                    | ページ読み込み = 1インプレッション                                              |
| クリック       | ユーザーがブランドページのコンテンツをクリックしたとき                                                                                                                                                                                                                                                                            | CTAボタンのクリック                                                      |
| コンバージョン    | ユーザーがブランドページから商品をカートに追加したとき                                                                                                                                                                                                                                                                            | カートに追加するアクション                                                    |
| リバースプロキシ   | 広告ブロッカーを回避するためにドメイン経由でトラッキングをルーティングします                                                                                                                                                                                                                                                                 | `yoursite.com/epsilon/` → Epsilon                                |
| URLスラグ     | URLパス内のブランド識別子                                                                                                                                                                                                                                                                                         | `nike` in `/brands/nike`                                         |
| カタログID     | 一意の商品カタログ識別子                                                                                                                                                                                                                                                                                           | 提供元: Epsilon                                                     |
| マクロ        | レスポンスのプレースホルダー（`{TS}`, `{RURL}`) in `tracking.params` 実行時に置き換えます。                                                                                                                                                                                                                                      | `{TS} → 1737485823910`                                           |
| IAB TCF    | Interactive Advertising Bureau Transparency & Consent Framework                                                                                                                                                                                                                                        | GDPR遵守標準                                                         |
| PII        | 個人識別情報（絶対に送信しないでください！）                                                                                                                                                                                                                                                                                 | メールアドレス、電話番号、本名                                                  |
| キャッシュバスター  | キャッシュされたレスポンスを防ぐためにタイムスタンプを追加すること                                                                                                                                                                                                                                                                      | `?ts=1737485823910`                                              |

### 技術略語

| 略語    | 正式名称                       | 意味                   |
| ----- | -------------------------- | -------------------- |
| RMN   | Retail Media ネットワーク        | Epsilonの広告プラットフォーム   |
| CTA   | Call-to-Action             | クリック可能なボタン/リンク       |
| JSON  | JavaScript Object Notation | APIリクエスト/レスポンスのデータ形式 |
| HTTPS | HTTP Secure                | 暗号化されたWebプロトコル       |
| GDPR  | 一般データ保護規則                  | EUプライバシー法            |
| TLS   | Transport Layer Security   | 暗号化プロトコル             |
| DNS   | Domain Name System         | インターネットアドレスシステム      |
| SSL   | Secure Sockets Layer       | 暗号化プロトコル             |
| RFC   | Request for Comments       | 技術標準文書               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/ja/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.