IMA SDK for HTML5 には、Open Measurement（OM）SDK が含まれています。これは、サードパーティによる視認性と検証の測定を可能にするために Interactive Advertising Bureau（IAB）によって開発された業界標準です。IMA SDK for HTML5 を使用する場合、含まれる OM SDK は VAST 広告タグ内の <AdVerifications> タグを自動的に解析し、OMID API を使用して指定された測定ベンダーに視認性データを送信します。必要に応じて、リクエストごとにアクセスモード ルールを設定して、検証スクリプトがアクセスできるコンテンツを制御できます。
IMA SDK は OM SDK v1.4 をサポートしています。
前提条件
VAST 4.1 以降を使用している場合は、
<AdVerifications>を使用して検証情報を提供するように広告を設定する必要があります。以前のバージョンの VAST を使用している広告では、<Extension type="AdVerifications">を使用する必要があります。広告がアド マネージャー経由でトラフィックされている場合は、アド マネージャー ネットワークの視認性データの提供元を設定し、その視認性データの提供元を広告申込情報に割り当てます。詳細については、アド マネージャー ネットワークで視認性データの提供元を設定するをご覧ください。
アクセスモード
OM SDK は、検証スクリプトがアクセスできる範囲を制御する 4 つの異なるアクセスモードで検証スクリプトの実行をサポートしています。
FULL: 検証スクリプトは、クリエイティブとパブリッシャー ページに直接アクセスできます。CREATIVE: 検証スクリプトとクリエイティブは、パブリッシャー ページからサンドボックス化されます。ただし、スクリプトはクリエイティブに直接アクセスできます。LIMITED: 検証スクリプトはサンドボックス化されているため、クリエイティブ ページやパブリッシャー ページにアクセスできず、パブリッシャーのドメインがどこにあるかを直接確認できません。
視認性測定プロバイダによっては、すべてのアクセス モードがサポートされていない場合があります。サポートされているモードを確認するには、ビューアビリティ プロバイダにお問い合わせください。以前、IMA は DOMAIN アクセス モードをサポートしていましたが、デフォルトは LIMITED モードになりました。
リクエストのアクセスモード ルールを設定する
アクセスモード ルールは StreamRequest レベルで設定する必要があります。検証スクリプト プロバイダごとに異なるアクセスモードを設定するには、各 OmidVerificationVendor を上記のいずれかのアクセスモードにマッピングする辞書を渡します。OmidVerificationVendor.OTHER フィールドは、ディクショナリに明示的に含まれていないすべてのベンダーのデフォルトのアクセス モードを設定するために使用されます。アクセスモード ルールが指定されていない場合、検証スクリプトはベンダーの LIMITED アクセスモードで実行されます。
GOOGLE を google.ima.dai.api.OmidAccessMode.FULL に設定する次の例をご覧ください。OmidVerificationVendor に記載されているプロバイダを含む、他のすべてのプロバイダは、デフォルトで OmidVerificationVendor.OTHER の設定方法になります。
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.GOOGLE]
= google.ima.dai.api.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.OTHER]
= google.ima.dai.api.OmidAccessMode.LIMITED;
CREATIVE アクセス モードを実装するには、次の両方を行う必要があります。
サイトの他の部分から分離された安全な iframe で動画プレーヤーをサンドボックス化します。
視認性パートナーの
OmidAccessModeをFULLに設定します。