パラメータ
ページ単位のパラメータの説明
これらのパラメータは、ページごとに 1 回のみ指定します。指定されたパラメータはページ上のすべてのユニットに影響します。
必須
パラメータ | 説明と例 |
---|---|
adPage
|
ユーザーが次の結果ページまたは前の結果ページに移動するときに必須です。
|
pubId
|
必須 AdSense クライアント ID です。pubId はクライアント ID の一部で、'partner-' の後に続きます。たとえば、クライアント ID が 'partner-test-property' の場合、pubId は 'test-property' になります。これは CSA の標準プロトコルです。 例: 'pubId' : 'test-property' |
query
|
必須(コンテンツ ページの関連する検索を除く)。 ユーザーが入力した検索クエリです。クエリ パラメータの値はデコードされている必要があります。 注: コンテンツ ページの関連する検索でこのパラメータを使用すると、予期しない結果になります。 次に例を示します。 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl
|
関連する検索ユニットがページにある場合は必須です。 検索クエリの入力内容が、ユーザーがクリックした検索語句と関連する場合に表示される検索結果ページの URL を指定します。resultsPageBaseUrl には独自のパラメータを設定できます(自動的に追加される検索クエリを除く)。 例: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
関連する検索ユニットがページにある場合は必須です。 関連する検索ユニットをリクエストする場合、このパラメータは必須です。ページのコンテキストに応じて、表示される関連検索のエクスペリエンスのタイプを制御します。
注: relatedSearchTargeting ページ パラメータは、デフォルトで自動的に「query」に設定されます。ただし、このデフォルト値は、検索結果ページ(検索の関連する検索)のみを対象に設計されていることに注意してください。他のタイプのページ(記事、ブログ投稿など)で関連する検索を使用する場合は、パラメータを明示的に「content」に設定する必要があります。 注: このパラメータを使用する際は、次のガイドラインが適用されます。
例: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
必須 ページ内の広告または関連する検索ユニットに適用されるカスタム検索スタイルの ID を指定します。 カスタム検索スタイルの使用について詳しくは、 こちらをご覧ください。なお、リクエストに styleId を設定すると、広告または関連する検索にそのスタイルが適用され、以前のスタイル設定パラメータは無視されます。リクエストで styleId が指定されていない場合、システムのデフォルトのスタイルが適用されます。 例: 'styleId': '1234567890' |
省略可
パラメータ | 説明と例 |
---|---|
linkTarget
|
省略可 クリックされた広告が同じウィンドウで開くか、新しいウィンドウで開くかを指定します。デフォルトは '_top' です。このパラメータはユニット単位で使用することもできます。
例: 'linkTarget' : '_blank' |
referrerAdCreative
|
省略可 ユーザーが別のウェブサイトで広告かリンクをクリックしたことによって関連する検索ユニットを含むコンテンツ ページがユーザーに表示されていて、かつ、お客様がその広告またはリンクを管理している場合、このパラメータをその広告のクリエイティブ テキストまたはリンクテキストに設定する必要があります。 このパラメータを使用する際は、次のガイドラインが適用されます。
注: このパラメータは、 次に例を示します。 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
省略可 検索結果ページでの検索クエリの URL パラメータ名を指定します。 指定しない場合、デフォルトは ‘q’ です。 例: 'resultsPageQueryParam' : 'query' |
terms
|
省略可 このパラメータでは、関連する検索リクエストに返される語句として、独自の関連する検索語句をカンマ区切りのリストで指定できます。ただし、Google でそれらの語句が使用されない場合もあります。
注: このパラメータを使用する場合は、 次に例を示します。 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
省略可 コンテンツの関連検索ユニットを含むコンテンツ ページの URL パラメータのリストを指定します。このパラメータは、コア コンテンツやユーザー エクスペリエンスに影響を与えることなく安全に無視できます。 注: 関連する検索語句をサイトに表示する前に、Google がページをクロールして、検索語句がコンテンツとの関連性が高いことを確認する必要があります。ページがまだクロールされていない場合や、AdSense クローラによってクロールがブロックされている場合(robots.txt によるブロックなど)、Google に提供した関連検索キーワードの候補は表示されません。 コンテンツに関する関連検索プロダクトは、Google のコンテンツ クロール システムを使用してページをインデックス化し、関連する検索語句を生成します。トラッキング変数、ユーザー ID、セッション ID やその他の動的識別子などのクエリ パラメータを含むコンテンツ ページの URL は、クローラーがページのコア コンテンツを評価する機能を妨げる可能性があり、関連する検索語句が不正確または関連性が低くなる可能性があります。このページ パラメータは、これらの不要なパラメータを無視するよう Google のクロールツールに指示します。これにより、コンテンツのインデックス登録が適切に行われ、不要なクロール負荷が軽減されます。これにより、Google はページがすでにクロール済みであることをより正確に認識し、候補キーワード(Google とパートナーの両方、該当する場合)の表示を開始できるようになります。 このパラメータを使用する際は、次のガイドラインが適用されます。
例:
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 |
設定
パラメータ | 説明と例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe
|
省略可 検索クエリと一致する広告に Google が適用するフィルタリング ルールを指定します。adsafe の有効な設定と、返される広告にそれぞれの値が与える影響は、以下のとおりです。
デフォルトでは、adsafe は高に設定されています。 例: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
省略可 adtest パラメータは、広告のリクエストがテストであることを示すために使用されます。adtest パラメータの値が on の場合、Google はそのリクエストをテストとして扱い、広告の表示をカウントしたり、クリックスルーの結果をトラッキングしたりしません。 adtest パラメータの値が on の場合、収益は発生しません。 [サイト] タブで承認されていないドメインから、adtest パラメータが on に設定された広告リクエストが送信された場合、「テスト広告」オーバーレイが表示され、クリックできない広告が返されます。 このパラメータはテスト時のみに使用し、運用中のシステムでは使用しないでください。使用すると、表示される広告に支払いが行われないことになります。 adtest のデフォルト値はオフです。 例: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
省略可 さまざまなページのパフォーマンスを追跡するために、検索向け AdSense のチャネルを含めることができます。AdSense アカウントまたはテクニカル アカウント マネージャーによって作成された一意のチャネル ID を使用します。 チャンネルについて詳しくは、こちらをご覧ください。 複数のチャネルは '+' 記号で区切る必要があります。 次に例を示します。 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
省略可 このパラメータは、リクエストされた広告または関連する検索のターゲット言語を示します。デフォルト値は en です。 Google では、AdWords API の言語コードのすべてをサポートしています。 注: 広告のターゲット言語は広告主が指定します。このパラメータをリクエストに含めると、Google ではその言語の広告またはすべての言語をターゲットにしている広告のみを配信しますが、広告文が指定された言語で記述されているとは限りません。 通常、hl パラメータは、このパラメータの送信元となるページの主要言語に設定する必要があります。 次に例を示します。 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
省略可
デフォルトの
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
省略可
デフォルトの
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
省略可 このパラメータでは、同意ありのトラフィックと同意なしのトラフィックの両方で、無効なトラフィック検出専用の Cookie とローカル ストレージを使用する広告を許可することを Google に通知するブール値を指定できます。
デフォルトでは IVT は true に設定されています。 例: 'ivt': false |
広告ユニット単位のパラメータの説明
これらのパラメータは、ページ上の個別の広告ユニットをユーザーに表示する方法に影響します。各パラメータは、広告ユニットごとに個別に設定できます。
必須
パラメータ | 説明と例 |
---|---|
container
|
必須 広告を表示する空の広告コンテナ <div> の ID です。
例: 'container' : 'afscontainer1' |
maxTop
|
広告ユニットが検索結果の上部にある場合は必須です。 このパラメータでは、ページ上部の広告ユニットに表示する広告の数を指定します。 注: このパラメータは、number パラメータの代わりに使用されます。この広告ユニットでは、広告の 1 行目が折り返さないように、十分に幅を持たす必要があります。ページの他のプレースメントで maxTop パラメータを使うことは、ポリシー違反に該当します。 例: 'maxTop' : 4 |
width
|
必須 広告または関連する検索ユニットの幅をピクセル単位で指定します。 例: 'width' : '700px' 'width' : 700 |
設定
パラメータ | 説明と例 | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
省略可 広告または関連する検索が読み込まれたとき、あるいは広告または関連する検索が表示されなかったときに呼び出される JavaScript 関数を指定します。このパラメータは、広告呼び出しの完了時に操作が行われるように、実際に実装する JavaScript コールバック関数に設定する必要があります。 このコールバック関数には次のパラメータを使用できます。
注: コールバック関数をテストして、エラーが発生しないか確認してください。特にページの読み込みを妨げる可能性があるコールバック関数については、テストすることを強くおすすめします。 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
|
省略可 この広告ユニットに表示される広告の数です。デフォルト値は 2 です。 例: 'number' : 4 |
||||||||
relatedSearches
|
省略可 このユニットに表示される関連する検索の数です。指定しない場合、デフォルトは 0 です。 例: 'relatedSearches' : 4 |