For the complete documentation index, see llms.txt. This page is also available as Markdown.

AdBlock動的ドメインAPIの使い方

AdBlockツールはますます高度化しており、オンライン広告からの収益を最大化したいパブリッシャーにとって大きな課題となっています。これらの課題を軽減するために、このAPIでは、アクティブなドメインに基づいてスクリプトを動的に調整でき、AdBlockソフトウェアによってコンテンツがブロックされるリスクを大幅に低減します。

定期的にローテーションされるドメインを通じて広告配信を確実にすることで、パブリッシャーは次のことができます:

  • 収益源を維持する: ブロックされた広告による中断を防ぎます。

  • ユーザー体験を向上させる: AdBlock検知を引き起こさずに、広告コンテンツをシームレスに配信します。

  • ドメイン管理を自動化する: 自動化された7日間のドメインライフサイクルにより、手動更新を不要にします。

新しいドメインは3日ごとに生成され、APIで利用できます。ドメインのライフサイクルは6日間です。

  • 3日間有効

  • 3日間非推奨

ライフサイクルが終了すると、ドメインは無効化されます。パフォーマンス上の理由から、新しいドメインをAPIに要求する前に、24時間ドメインをキャッシュすることを推奨します。

このAPIは次の場合にのみ利用できます Popunderのインラインスクリプトインストリーム動画 ゾーン。

要件

このAPIを使用するには、パブリッシャーは次のことを行う必要があります:

  • 次の GETリクエスト をエンドポイントに送信します: https://ads.exoclick.com/adblock-domains.php

  • レスポンスで新しい広告配信ドメインを受け取ります

  • その後、広告ゾーンタグで使用しているシンジケーションエンドポイントを、APIレスポンスで提供された新しいものに変更する必要があります。

実装手順

1

有効なドメインを取得する

有効なドメインを動的に取得するには、 サーバー間でAPIコールを行う必要があります。これは、クライアント側から呼び出すとAPIコールがブロックされる可能性があるため重要です。

以下はPHPでのサーバー間コールの例です:

以下はAPIから期待されるレスポンスです:

2

スクリプトを更新する

を使って ドメイン エンドポイントから返されたものを使用して、広告ゾーンで使用するドメインを更新します。元のドメインは広告フォーマットによって異なります:

  • 次の インストリーム動画 ゾーンでは次を変更します: 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

AdBlockの検出

ユーザーがアドブロック拡張機能を有効にしているかを検出するには、 ホストする必要があります ads.js をパブリッシャー側で (あなた自身のドメイン/CDN)でホストし、あなたの body タグの最初に含めてください。

絶対に して リクエスト https://www.exoclick.com/ads.js しないでください。

独自の ads.js ファイルを作成します:

  1. 次の名前のファイルを作成し、 ads.js あなたのWebサイト上の公開パスに配置します(例: /js/ads.js).

  2. そのファイルに以下の内容を追加します。

  3. 広告統合ロジックの前に、そのファイルをページから読み込んでください。

参照用ファイルの内容:

その後、あなたの body タグの先頭に次の行を追加します:

このスクリプトは、クライアントがAdblockを使用している場合、「exoclick」と「ads」というキーワードが含まれているためブロックされます。このスクリプトの読み込み後、JSスニペットが特定の変数の読み取りを試みます。変数が未定義またはアクセス不能であれば、スクリプトがブロックされたと判断できます。

統合例

これら2つの例では fetchAdblockDomain.php を、アドブロックドメインを取得するサーバー間コールの名前として使用しています。

インストリーム

In-StreamでDynamic Domainsを使用するには、必ず VASTプレーヤーをスクリプト内に含めてください、そうしないと、プレーヤーは更新されたドメインを使用せず、デフォルトのインストリーム広告ゾーンを読み込みます。この例では、Fluidplayer HTML5プレーヤーを使用しています。

ポップアンダー

トラブルシューティング

ドメインが返されない

エンドポイントが空のドメインを返す場合があります。

デバッグ中は常にエンドポイントのレスポンスをログに記録し、潜在的な問題を特定してください。success が falseでない場合は、サポートにお問い合わせください。

Adblockが有効なのにデフォルトドメインが返される

Adblockが有効にもかかわらず、スクリプトがデフォルトドメインを使用している可能性がある一般的な理由は次のとおりです:

  • ads.js がパブリッシャー側でホストされていない。この統合では、 ads.js をあなた自身のドメインから提供する必要があります(例: /js/ads.js)。直接リクエストすることは https://www.exoclick.com/ads.js サポートされていません。

  • アドブロックドメインより前にデフォルトドメインが描画されている。サイト上で広告ゾーンを挿入するスクリプトが 必ずサーバー間コールを待つようにしてください。実行チェーンによっては、アドブロックドメインが返される前にデフォルトドメインがサイトに追加されることがあり、その場合、Webサイトが更新されたドメインを挿入できなくなります。

さらにサポートが必要な場合は、サポートチームにお問い合わせください こちら.

最終更新

役に立ちましたか?