Google Interactive Media Ads SDK に関するよくある質問


一部のフォーマットの広告が表示されない理由
テスト広告タグは、有効なリクエストで常に広告を返すように設定されています。これにより、統合が容易になり、プレーヤーによる広告のリクエストとレンダリングを簡単にテストできるようになります。ただし、サイト、アカウント、広告ユニットのフォーマットによっては広告が表示されないことがあります。統合がテストタグでは正しく機能しているのに、独自のタグでは機能していない場合、原因は次のいずれかである可能性があります。
  • サポートされていない形式の動画を環境に提供しています。たとえば、iOS または Android に HTML5 広告のみを配信する場合などです。
  • アド マネージャーを使用している場合、現時点ではパブリッシャー ID のターゲットに設定されている広告がないことがあります。また、アド マネージャーで関連する広告とクリエイティブが承認されていることを確認します。
  • AdSense を使用している場合は、サイトまたはテストページのターゲティング条件に有効な広告がない場合があります。最も一般的な原因は、クロールされていない非公開ウェブサイトの使用です。
  • Ad Exchange ネットワーク パートナー管理を使用している場合に、descriptionURL が未設定または所有または運営しているドメイン管理リストに含まれていない場合は、広告は配信されません。
  • Ad Exchange 動画で定義されている最小しきい値を確認します。CPM がかなり高い場合、広告掲載率が非常に低くなることがあります。これを修正するには、minCPM を削除するか、広告リクエストから広告ユニットパラメータ(スロット名)を削除して、広告掲載率に影響が生じているかどうかを確認します。
適切なdescriptionUrlとはどのようなものでしょうか。
効果を最大限に引き出すには、descriptionUrl が参照するページのコンテンツを、単語やフレーズの集合ではなく、その内容と提供する役割が実際に示す 1 ~ 3 の段落にしましょう。 これまで成功した方法の 1 つは、事前定義されたブロックから動的に descriptionUrl ページのコンテンツを合成することです。たとえば、コンテンツに関する数行の文章と、サイトのサービスについての簡単な文章のほか、各 AdSense チャネルに関連付けられた事前定義のスニペット(「エンターテイメント」、「スポーツ」など)を用意します。その結果、各コンテンツには合理的に異なる descriptionUrl が関連付けられ、一般情報(ジャンル記述子など)と特定の情報(コンテンツに関するコンテンツを直接)の両方が提供されます。

このメタデータ HTML はシンプルである必要があります。次に例を示します。

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
「広告レスポンスに有効な広告タイプが含まれていません」というエラーが表示されるのはなぜですか?
このエラーは通常、特定の publisherId にターゲティングされた広告がまったくない場合に発生します。この条件は、キャンペーンの開始と終了に伴って 1 日または数日にわたって変化する可能性があります。ターゲットとする広告の有効期限が切れていないこと、広告のターゲティング条件が正しいことを確認してください。 テスト publisherId を使用して広告が適切にリクエスト、受信、レンダリングされさえすれば、広告が利用可能であれば、ライブ publisherId を使用して適切に処理できます。
テストに使用できるアド マネージャーの動画広告タグはありますか?
サンプルタグは、サンプルタグページに掲載されています。
adSlotWidthadSlotHeight は、アド マネージャーの広告タグに含まれる sz と同じ値に設定する必要がありますか?
必ずしもそうとは限りません。adSlotWidthadSlotHeight は、広告を表示するプレーヤーまたは領域の幅と高さに設定する必要があります。AdSense では、スペースに合う広告を決定する際に使用されます。アド マネージャーの広告タグの Key-Value ペアはターゲティング パラメータであり、配信されたクリエイティブに影響するとは限りません(詳しくは下記をご覧ください)。sz
デモの広告タグは正しく表示されますが、広告タグに切り替えたときに広告は表示されません。
リクエストする広告タグに何かが入稿されていることを確認します。最も簡単に調べられる方法は、HTTP トラフィックを確認することです。HTML アンカー ブロック内で 1x1 ピクセルの grey.gif 画像が返された場合は、アド マネージャーでターゲティングを確認する必要があります。
同じタグを使用して広告を複数回リクエストしたいのですが、最初のリクエストに対してのみ広告があります。どうすればよいですか?
広告のリクエストを複数回行う場合は、偶発的な重複ではない正当なリクエストを、広告サーバーに知らせる必要があります。SDK は、次の 2 つのクイック API 呼び出しを行います。
  1. AdsManager インスタンスで destroy() を呼び出します。これにより、以下の contentComplete() の呼び出し時にポストロールが再生されなくなります。次のリクエストを行うと、新しい AdsManager が送信されます。
  2. AdsLoader インスタンスで contentComplete() を呼び出します。これにより SDK がリセットされるため、新しい広告リクエストは前の広告リクエストと重複しないようにできます。
上記の 2 つの呼び出しを行った後、AdsLoader インスタンスで requestAds() を呼び出して、新しい動画で再生される別の広告セットを取得できます。
IMA SDK でオーバーレイ広告とフルスロットの AdSense 広告をリクエストするにはどうすればよいですか?

SDK を使って AdSense 広告をリクエストするには、まず AdSense 広告タグを取得する必要があります。詳しくは、動画向け AdSense のページをご覧ください。タグを取得したら、次の手順を行って、オーバーレイまたはフルスロットの広告リクエストを行います。

オーバーレイ広告
  1. AdsRequest で、ViewModes を NORMAL に設定します。
  2. 広告タグにパラメータ overlay=1 を追加します。
フルスロット広告
  1. AdsRequest で、ViewModes を FULLSCREEN に設定します。
  2. 広告タグにパラメータ overlay=0 を追加します。
広告をクリックすると「無効なリンク先 URL」というエラーが表示されます。考えられる原因は何ですか。
このエラーの最も一般的な原因は、エスケープ処理されたリンク先 URL です。このエラーが表示される場合は、VAST レスポンスでリンク先 URL が正しくエスケープされているかどうかを確認してください。
Android SDK と iOS SDK で、動画広告全体をクリック可能にする方法はありますか?
動画全体のクリック トラッキングに関しては、モバイル デバイスでの動画の標準的な視聴体験として、動画をタップして、プレーヤーを一時停止する、またはプレーヤー コントロールを表示するというものがあります。ユーザーがプレーヤー コントロールへのアクセスを本当に必要としたときに、意図せず広告をクリックしてしまうのを防ぐため、IMA では [詳細] ボタンを使って、ユーザーが広告をクリックし、宣伝されている商品の詳細を確認できるようにします。
「VAST ドキュメントが空です」というエラーが表示されるのはなぜですか?
このエラーは、広告が適切に配信されなかったことを示す空の VAST ドキュメントを広告タグから返された場合に発生します。広告タグが機能しない理由については、アカウント マネージャーまたは広告サーバーの担当者にお問い合わせください。
[広告をスキップ] ボックスやその他の UI 要素のサイズやテキストを変更できますか?
IMA SDK では、UI 要素のレイアウト、サイズ、コンテンツの変更はサポートされていません。 UI 要素の詳細については、AdsManager.uiElements をご覧ください。
iOS で広告の音量を変更できないのはなぜですか?
iOS では、音量をプログラムで設定することはできません。HTML5 SDK を使用している場合、adsManager.setVolume() は無視されます。iOS SDK では、この理由により、IMAModifier にボリューム セッターを設定していません。
複数のスレッドを使用して UI を初期化したり操作したりできますか?
UI の初期化はすべてメインスレッドで行う必要があります。初期化の後、バックグラウンド広告の再生を実装するかどうかを選択できます。