リファレンス

adPage パラメータは、広告が表示される検索結果ページを指定します。このパラメータは、ユーザーが検索結果の最初のページから移動する場合に使用します。たとえば、5 つの広告がリクエストされ、adPage パラメータが 2 に設定されている場合、返される広告は 5 つの広告のうち 2 ページ目になります。

例:

'pubId' : 'test-property'

注: コンテンツ ページの関連する検索でこのパラメータを使用すると、予期しない結果が発生します。

例:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

例:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content'このオプションは、コンテンツ ページ（記事、ブログ投稿など）の関連する検索に使用します。
• 'query'このオプションは、検索結果ページの関連する検索にのみ使用します。

注: relatedSearchTargeting ページ パラメータは、デフォルトで自動的に「query」に設定されます。ただし、このデフォルト値は検索結果ページのみ（検索の関連する検索）専用に設計されている点に注意してください。他の種類のページ（記事、ブログ投稿など）で関連する検索を使用する場合は、明示的にパラメータを「content」に設定する必要があります。

注: このパラメータの使用には、次のガイドラインが適用されます。

• 一部の関連する検索機能は、このページ パラメータの値に応じて有効または無効にできます。
• ページの種類を偽って表示したり、検索結果ページ以外のページで relatedSearchTargeting パラメータのデフォルトの「query」設定をそのまま利用したりすると、これらの手順に対する違反と見なされます。
• Google は、この値が手動で設定されているか、デフォルト値を使用しているかにかかわらず、定期的にこの値の精度を検証することがあります。

例:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

例:

'styleId': '1234567890'

• '_top' 同じウィンドウで開きます。
• '_blank' 新しいウィンドウで開きます。

例:

'linkTarget' : '_blank'

例:

'maxTermLength' : 50

このパラメータの使用には、次のガイドラインが適用されます。

• このパラメータは、コンテンツ ページの関連する検索のリクエストでのみ指定してください。他のすべてのリクエストでは無視されます。
• 他のウェブサイトから意図的に誘導しているトラフィックに限って使用し、オーガニック トラフィックには使用しないでください。
• 広告またはリンク クリエイティブのタイトル行や説明を含める必要があります。
• 広告やリンク クリエイティブに含まれていない値を入力した場合は、これらの指示に対する違反と見なされます。
• 大文字と小文字は区別されません。
• 有効な UTF-8 エンコードを使用できます。Unicode 文字や発音区別符号がサポートされています。
• Google は、送信されたパラメータを使用または無視する場合があります。使用すると、用語の選択とランキングに影響する可能性があります。

注: terms パラメータを使用する場合、このパラメータは必須です。

例:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

例:

'resultsPageQueryParam' : 'query'

注: このパラメータを使用する場合は、referrerAdCreative も必須で、relatedSearchTargeting が必須であり、「content」に設定する必要があります。

例:

'terms' : 'cars rental, flight ticket'

注: 関連する検索語句をサイトに表示する前に、Google はページをクロールして、語句がコンテンツと関連していることを確認する必要があります。AdSense クローラによってページがクロールされていない場合や、クロールが（robots.txt などによって）ブロックされている場合は、お客様が Google に提供した関連する検索語句の候補は表示されません。

「コンテンツ内の関連する検索」サービスは、Google のコンテンツ クロール システムを使用してページをインデックスに登録し、関連性の高い検索キーワードを生成します。コンテンツ ページの URL にトラッキング変数、ユーザー ID、セッション ID、その他の動的 ID などのクエリ パラメータが含まれていると、クローラがページのコア コンテンツを評価できなくなり、不正確または無関係な関連検索キーワードが表示される可能性があります。このページ パラメータは、こうした必須ではないパラメータを無視するよう Google のクローラに指示します。これにより、コンテンツのインデックス登録が適切に行われ、不要なクロールの読み込みが軽減されます。これにより、Google はページがすでにクロールされていると認識しやすくなり、キーワードの候補が表示されるようになります（Google と、該当する場合はパートナーの両方）。

このパラメータの使用には、次のガイドラインが適用されます。

• このパラメータは、コンテンツ ページの関連する検索のリクエストでのみ指定してください。他のすべてのリクエストでは無視されます。
• このパラメータの値は、ユーザーがコンテンツ ページにアクセスしたときに表示される URL パラメータのカンマ区切りのリストにする必要があります。
• 大文字と小文字は区別されます。
• このリストに含まれるいずれかの URL パラメータがコンテンツ ページの URL から削除されても、ページのコンテンツ、外観、ユーザー エクスペリエンスに大きな影響はありません。
• ページのコンテンツ、デザイン、ユーザー エクスペリエンスに重大な影響を与える URL パラメータを含めると、これらの手順への違反と見なされます。
• Google は、指定された URL パラメータを無視した場合の影響を定期的に検証することがあります。

例:
ユーザーがコンテンツ ページにアクセスし、URL が

http://example.com/content?utm_medium=social&page_id=123&click_id=456

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• 'high': 一般向けの広告を返します。成人向け広告や、アダルト コンテンツの広告は返しません。
• 'medium': 一般向け広告と成人向け広告を返します。アダルト コンテンツの広告は返しません。
• 'low': すべてのタイプの広告を返します。

デフォルトでは、adsafe は高に設定されています。

例:

'adsafe': 'medium'

adtest パラメータの値が on の場合、収益は発生しません。

adtest パラメータが on に設定された広告リクエストが、 [サイト] タブで承認されていないドメインから送信されると、「テスト広告」オーバーレイが含まれ、クリックできない広告が返されます。

このパラメータはテスト時に使用しますが、本番用システムでは使用しないでください。使用すると、表示された広告に対して支払いが行われません。

デフォルトの adtest 値はオフです。

例:

'adtest' : 'on'

例:

'channel' :  'testA'  

'channel' :  'testA+testB'  

Google では、AdWords API のすべての言語コードをサポートしています。

注: 広告のターゲット言語は広告主様が指定します。このパラメータをリクエストに含めた場合、Google は指定された言語またはすべての言語をターゲットとする広告のみを返します。ただし、広告文が指定された言語であることが保証されるわけではありません。

通常は、hl パラメータに、このパラメータの送信元ページのメイン言語を設定します。

例:

'hl' : 'es'

ie パラメータでは、クエリ文字列の解釈に使用する文字エンコード スキームを設定します。

ie のデフォルト値は utf-8 です。

oe パラメータでは、Google が広告のテキストのエンコードに使用する文字エンコード スキームを設定します。このパラメータは必須ではありませんが、値を渡すことをおすすめします。

oe のデフォルト値は utf-8 です。

• trueこのパラメータが存在しないか「true」に設定されている場合、無効なトラフィック専用の Cookie が設定され、同意済みのトラフィックでのみローカル ストレージが使用されます。
• falseこのパラメータを「false」に設定すると、無効なトラフィック検出専用の Cookie が設定され、同意済みのトラフィックと同意のないトラフィックの両方でローカル ストレージが使用されます。

IVT はデフォルトで true に設定されています。

例:

'ivt': false

例:

'container' : 'afscontainer1'

このパラメータを使用して、上部の広告ユニットに表示する広告の数を指定します。

注: このパラメータは「number」パラメータの代わりに使用されます。この広告ユニットでは、広告の最初の行が折り返されないように十分な幅を確保する必要があります。ページの他のプレースメントで maxTop パラメータを使用することは、ポリシー違反です。

例:

'maxTop' : 4

例:

'width' : '700px'

'width' : 700

このコールバック関数は次のパラメータを取ります。

注: コールバック関数をテストして、エラー（特にページの読み込みを妨げる可能性があるもの）が生成されていないことを確認してください。

JavaScript コールバックの例:

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
      

例:

'number' : 4

例:

'relatedSearches' : 4