リファレンス

adPage パラメータは、広告が表示されている結果ページを指定します。このパラメータは、ユーザーが検索結果の最初のページから移動するときに使われます。たとえば、5 つの広告がリクエストされ、adPage パラメータが 2 に設定されている場合、返される広告は検索結果の 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' このオプションは、検索結果ページの関連する検索にのみ使用してください。

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

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

• このページ パラメータの値に応じて、関連する検索機能の一部が有効または無効になることがあります。
• ページのタイプを誤って表したり、検索結果ページ以外のページで relatedSearchTargeting パラメータのデフォルトの「query」設定を使用したりすることは、これらの文書による指示への違反と見なされます。
• この値が手動で設定されているかデフォルトで設定されているかにかかわらず、Google はこの値の正確性を定期的に確認することがあります。

例:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

例:

'styleId': '1234567890'

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

例:

'linkTarget' : '_blank'

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

• このパラメータは、コンテンツ リクエストの関連する検索に対してのみ指定します。その他のリクエストでは無視されます。
• 他のウェブサイトから意図的に誘導しているトラフィックに対してのみ使用します。オーガニック トラフィックには使用できません。
• 広告またはリンク クリエイティブのタイトル行、説明、その他の文言を含める必要があります。
• 広告やリンクのクリエイティブから値を省略したり、値を追加したりすることは、これらの文書による指示に違反しているとみなされます。
• 大文字と小文字は区別されません。
• 有効な 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 のコンテンツ クロール システムを利用してページをインデックス登録し、関連性の高い検索語句を生成します。トラッキング変数、ユーザー ID、セッション ID やその他の動的識別子などのクエリ パラメータを含むコンテンツ ページの URL は、クローラーがページのコア コンテンツを評価する機能を妨げる可能性があり、関連性のない検索語句や不正確な検索語句につながる可能性があります。このページ パラメータは、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 は high に設定されています。

例:

'adsafe': 'medium'

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

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

このパラメータはテスト時のみに使用し、運用中のシステムでは使用しないでください。使用すると、表示される広告に支払いが行われないことになります。

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

例:

'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 パラメータの代わりに使われます。この広告ユニットでは、広告の 1 行目が折り返さないように、十分に幅を持たす必要があります。ページの他のプレースメントで 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