> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/publishers/ja/adblock/adblock-dynamic-domains-api.md). # AdBlock Dynamic Domains APIの使い方 AdBlockツールはますます高度化しており、オンライン広告からの収益を最大化したいパブリッシャーにとって大きな課題となっています。これらの課題を軽減するために、このAPIでは、アクティブなドメインに基づいてスクリプトを動的に調整でき、AdBlockソフトウェアによってコンテンツがブロックされるリスクを大幅に低減します。 定期的にローテーションされるドメインを通じて広告配信を確実にすることで、パブリッシャーは次のことができます： * **収益源を維持する：** ブロックされた広告による中断を防ぎます。 * **ユーザー体験を向上させる：** AdBlock検知を引き起こさずに、広告コンテンツをシームレスに配信します。 * **ドメイン管理を自動化する：** 自動化された7日間のドメインライフサイクルにより、手動更新を不要にします。 新しいドメインは3日ごとに生成され、APIで利用できます。ドメインのライフサイクルは6日間です。 * 3日間有効 * 3日間非推奨 ライフサイクルが終了すると、ドメインは無効化されます。パフォーマンス上の理由から、新しいドメインをAPIに要求する前に、24時間ドメインをキャッシュすることを推奨します。 このAPIは次の場合にのみ利用できます **Popunderのインラインスクリプト** と **インストリーム動画** ゾーン。 ## 要件 このAPIを使用するには、パブリッシャーは次のことを行う必要があります： * 次の **GETリクエスト** をエンドポイントに送信します: * レスポンスで新しい広告配信ドメインを受け取ります * その後、広告ゾーンタグで使用しているシンジケーションエンドポイントを、APIレスポンスで提供された新しいものに変更する必要があります。 ## 実装手順 {% stepper %} {% step %} ### 有効なドメインを取得する 有効なドメインを動的に取得するには、 **サーバー間でAPIコールを行う必要があります**。これは、クライアント側から呼び出すとAPIコールがブロックされる可能性があるため重要です。 以下はPHPでのサーバー間コールの例です： ```php false, 'message' => $e->getMessage() ]); } ?> ``` 以下はAPIから期待されるレスポンスです： ```json { "success": true, "message": "ドメインが見つかりました", "domain": "newsub.newdomain.com" } ``` {% endstep %} {% step %} ### スクリプトを更新する を使って **ドメイン** エンドポイントから返されたものを使用して、広告ゾーンで使用するドメインを更新します。元のドメインは広告フォーマットによって異なります： * 次の **インストリーム動画** ゾーンでは次を変更します： *VASTタグ*: * **変更前** : `https://s.magsrv.com/v1/vast.php?t={random}&idzone={zoneId}` * **変更後** : `https://newsub.newdomain.com/v1/vast.php?t={random}&idzone={zoneId}` * Popunderゾーンでは次を変更します： *syndication\_host* インラインスクリプト内の * **変更前** : `s.pemsrv.com` * **変更後** : `newsub.newdomain.com` {% endstep %} {% endstepper %} ## AdBlockの検出 ユーザーがアドブロック拡張機能を有効にしているかを検出するには、 **ホストする必要があります `ads.js` をパブリッシャー側で** （あなた自身のドメイン/CDN）でホストし、あなたの `body` タグの最初に含めてください。 絶対に **して** リクエスト `https://www.exoclick.com/ads.js` しないでください。 独自の `ads.js` ファイルを作成します： 1. 次の名前のファイルを作成し、 `ads.js` あなたのWebサイト上の公開パスに配置します（例： `/js/ads.js`). 2. そのファイルに以下の内容を追加します。 3. 広告統合ロジックの前に、そのファイルをページから読み込んでください。 参照用ファイルの内容： ```javascript let bait_b3j4hu231 = true; ``` その後、あなたの `body` タグの先頭に次の行を追加します： ```html ``` このスクリプトは、クライアントがAdblockを使用している場合、「exoclick」と「ads」というキーワードが含まれているためブロックされます。このスクリプトの読み込み後、JSスニペットが特定の変数の読み取りを試みます。変数が未定義またはアクセス不能であれば、スクリプトがブロックされたと判断できます。 ```html ``` ## 統合例 これら2つの例では `fetchAdblockDomain.php` を、アドブロックドメインを取得するサーバー間コールの名前として使用しています。 ### インストリーム In-StreamでDynamic Domainsを使用するには、必ず **VASTプレーヤーをスクリプト内に含めてください**、そうしないと、プレーヤーは更新されたドメインを使用せず、デフォルトのインストリーム広告ゾーンを読み込みます。この例では、Fluidplayer HTML5プレーヤーを使用しています。 ```html ``` ### ポップアンダー ```html ここをクリック