広告ユニットとコード生成

広告ユニットは AdSense 広告コードにより表示される 1 組の広告で、AdSense Host API を利用して広告ユニットを作成、削除、編集、更新することで、広告枠を管理できます。また、サイトに広告を表示するための広告コードを生成することもできます。

広告ユニットでは、サイズ、色、フォント、角のスタイルが定義されます。また、ホストでパフォーマンス トラッキングのためのチャネルを作成することも可能です。前者は広告ユニットの作成時に、後者はコードの生成時に関係します。

広告ユニットのスタイル

広告ユニットの作成時にカスタマイズできる項目は次のとおりです。

  • サイズ
  • タイプ
  • カスタム スタイル: 色、角、フォント
  • バックアップ オプション
  • モバイル テキスト広告(従来型)

サイズ

サイズは、「SIZE_728_90」のような文字列になります(初めの整数は幅を、後の整数は高さを表します)。なお、サイズのセットには限りがありますので、AdSense の管理画面で最新のリストをご確認ください。

サンプルの広告ユニット 1 サンプルの広告ユニット 2
図 1: 異なる広告ユニットサイズ

タイプ

テキスト広告やイメージ広告、リッチメディア広告は、ページに表示できる広告タイプの一例です。

タイプには TEXTTEXT_IMAGEIMAGELINK があります。一部のフォーマット(サイズ)ではイメージ広告を作成できません。イメージ広告で利用できるフォーマットの最新のリストについては AdSense ヘルプページをご覧ください。

カスタム スタイル

カスタム スタイルは、広告ユニットや表示された広告のデフォルトの色やフォントなどの各種プロパティよりも優先されます。

"customStyle": {
  "colors": {
    "border": "800040",
    "title": "0000CC",
    "background": "FFFDFD",
    "text": "1F1F1F",
    "url": "008000"
  },
  "corners": "VERY_ROUNDED"
  "font": {
    "family": "ACCOUNT_DEFAULT_FAMILY",
    "size": "ACCOUNT_DEFAULT_SIZE"
  }
}

現時点では、保存したスタイルを広告ユニットに適用する方法がないため、カスタム スタイルを完全に記述する必要があります。これは、角(SQUARESLIGHTLY_ROUNDEDVERY_ROUNDED)、フォント ファミリー(ACCOUNT_DEFAULT_FAMILYADSENSE_DEFAULT_FAMILYARIALTIMESVERDANA)、フォントサイズ(ACCOUNT_DEFAULT_SIZEADSENSE_DEFAULT_SIZESMALLMEDIUMLARGE)に当てはまります。

やや丸みのある角とかなり丸みのある角
図 2: やや丸みのある角とかなり丸みのある角のスタイル

バックアップ オプション

関連性の高い広告がない場合、レイアウトに影響が出ないように、表示するバックアップ オプションを定義することができます。空白や無地一色、実装した HTML ページの URL が利用可能です。

モバイル設定

モバイル設定では、従来型端末で使用するマークアップ言語やスクリプト言語などを設定できます。

詳細情報

これらのプロパティの定義方法についてさらに理解を深める場合は、Adunits のページでリソースの表記をご確認ください。これらの概念の詳細については、AdSense ヘルプページをご覧ください。

コード生成

広告ユニットが作成されたら、広告をページに表示するために Javascript の短いコードが必要になります。このコードは、getAdCode メソッドを使用して API で生成されます。

GET https://www.googleapis.com/adsensehost/v4.1/accounts/accountId/adclients/adClientId/adunits/adUnitId/adcode

アカウント ID は、関連付けセッション時、特にトークンの確認段階でホストによって保存される必要があるサイト運営者の ID です。

広告ユニットを作成するには、広告クライアント ID が必要になりますのでご注意ください。コンテンツ広告を表示するために必要な商品コードは「AFC」となります。このコードは既に生成されている場合もありますので、広告クライアントをリストアップして、広告クライアント ID を決定してください。

アカウント ID、広告クライアント ID、広告ユニット用の ID があれば、コードを生成できます。生成される AFC 商品コードの構造には、ページの HTML コードに挿入する必要のある短い文字列が含まれます。この JavaScript コードは次のようになります。

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-7654321";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

なお、幅と高さはこのコードで定義されている数値になるため、サイズの変更時には再生成する必要があります。また、このコードはホストサイドで保存され、インプレッションごとに再生成する必要がない点にもご留意ください。

カスタム チャネル

AdSense Host API では、カスタム チャンネル(ホスト カスタム チャネル)は、コード生成時に広告ユニットに関連付けられます。getAdCode メソッドは、hostCustomChannelId というオプション パラメータを使用して呼び出すことができます。このフィールドは生成されたコードに含まれるため、カスタム チャネルが広告ユニットに追加されたり、広告ユニットから削除されるたびに再生成する必要があります。

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-654321";
google_ad_host_channel = "123456789";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

複数のカスタム チャネルは広告ユニットのパフォーマンスをトラッキングでき、複数の広告ユニットはカスタム チャネルによってトラッキング可能です。

フィードバックを送信...