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
: 確認スクリプトとクリエイティブは、パブリッシャーのページからサンドボックス化されます。ただし、スクリプトはクリエイティブに直接アクセスできます。DOMAIN
: 確認スクリプトはサンドボックス化されているため、クリエイティブやパブリッシャーのページにアクセスできません。ただし、スクリプトはどのパブリッシャー ドメインにあるかを直接確認できるように読み込まれます。LIMITED
: 検証スクリプトはサンドボックス化されているため、クリエイティブまたはパブリッシャーのページにアクセスできず、どのパブリッシャーのドメインにあるかを直接確認できません。
視認性測定プロバイダによっては、すべてのアクセス モードがサポートされていない場合があります。サポートされているモードについては、ビューアビリティ プロバイダにお問い合わせください。
リクエストのアクセスモード ルールを設定する
アクセスモード ルールはAdsRequest
レベルで設定する必要があります。検証スクリプト プロバイダごとに異なるアクセス モードを設定するには、各 OmidVerificationVendor
を上記のいずれかのアクセス モードにマッピングする辞書を渡します。OmidVerificationVendor.OTHER
フィールドは、ディクショナリに明示的に含まれていないすべてのベンダーのデフォルトのアクセス モードを設定するために使用されます。アクセスモード ルールが指定されていない場合、検証スクリプトはベンダーの LIMITED
アクセスモードで実行されます。
GOOGLE
を google.ima.OmidAccessMode.FULL
に設定する次の例をご覧ください。OmidVerificationVendor
に記載されているプロバイダを含む、他のすべてのプロバイダは、デフォルトで OmidVerificationVendor.OTHER
の設定方法になります。
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.DOMAIN;
CREATIVE
アクセス モードを実装するには、次の両方を行う必要があります。
サイトの他の部分から分離された安全な iframe で動画プレーヤーをサンドボックス化します。
視認性パートナーの
OmidAccessMode
をFULL
に設定します。