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: 検証スクリプトはサンドボックス化されているため、クリエイティブまたはパブリッシャーのページにアクセスできず、どのパブリッシャーのドメインにあるかを直接確認できません。
視認性データの提供元によっては、一部のアクセスモードに対応していない場合があります。サポートされているモードについては、ビューアビリティ プロバイダにお問い合わせください。
リクエストのアクセスモード ルールを設定する
アクセスモードのルールは 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.DOMAIN;
CREATIVE アクセスモードを実装するには、次の両方の手順を行う必要があります。
サイトの他の部分から分離された安全な iframe で動画プレーヤーをサンドボックス化します。
視認性パートナーの
OmidAccessModeをFULLに設定します。