パラメータ
ページ単位のパラメータの説明
これらのパラメータは、ページごとに 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 には独自の URL を パラメータは除きますが、自動的に追加される検索クエリは除きます。 例: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
関連する検索ユニットがページにある場合は必須です。 関連する検索ユニットをリクエストする場合、このパラメータは必須です。使用するデータのタイプを 関連する検索機能は、ページの内容に応じて表示されます。
注: relatedSearchTargeting ページ パラメータは、 「query」できます。ただし、このデフォルト値は 30 日ごとの 検索結果ページのみ(検索の関連する検索)用に作成されました。もし 他の種類のページ(記事、ブログ投稿など)で関連する検索を使用する場合は、 明示的に「content」に設定します。 注: このパラメータの使用には、次のガイドラインが適用されます。
例: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
必須 上の広告または関連する検索ユニットに適用されるカスタム検索スタイルの ID を指定します。 表示されます。 カスタム検索スタイルの使用に関する詳細リクエストに styleId が設定されている場合、 広告または関連する検索はそのスタイルでレンダリングされ、以前のスタイル パラメータは 無視されます。リクエストで styleId が指定されていない場合、システムのデフォルト スタイルがレンダリングされます。 例: 'styleId': '1234567890' |
省略可
パラメータ | 説明と例 |
---|---|
linkTarget
|
省略可 広告をクリックしたときと同じウィンドウで開くか、新しいウィンドウで開くかを指定します クリックします。デフォルトは「_top」です。このパラメータはユニットレベルで使用することもできます。
例: 'linkTarget' : '_blank' |
maxTermLength
|
省略可 関連する検索キーワードの最大文字数を指定します(スペースを含む)。 設定しない場合、最大値はありません。 例: 'maxTermLength' : 50 |
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 が ページをクロールして、コンテンツがコンテンツとの関連性が高いことを確認します。まだページが開いていない場合は robots.txt などによって、クローラーによってクロールされた AdSense クローラ ユーザーが入力した関連する検索語句の候補は表示されなくなります。 コンテンツ ページの関連する検索では、Google のコンテンツ クロール システムを使用してインデックスに登録します 関連性の高い検索語句を生成できます。「 ユーザー ID、セッション ID、その他の動的識別子が、 クローラはページのコア コンテンツを評価できないため、 関連性の低い関連検索語句に対して入札します。このページ パラメータは、Google のクローラに コンテンツを適切にインデックス登録し、不要なクロールを減らす 負荷を軽減できます。これにより、Google はページがすでにクロールされたことをより正確に認識して、クロールを開始できるようになります。 推奨キーワードを表示(Google と、該当する場合はパートナー様の両方)。 このパラメータの使用には、次のガイドラインが適用されます。
例:
http://example.com/content?utm_medium=social&page_id=123&click_id=456次の無視できない URL パラメータを指定します。 'ignoredPageParams' : 'utm_medium,click_id,session_ref'この場合、コンテンツ ページの URL は次のように処理されます。 http://example.com/content?page_id=123 |
設定
パラメータ | 説明と例 | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe
|
省略可 検索クエリに一致する広告に適用されるフィルタリング ルールを指定します。adsafe の有効な設定と、返される広告に対する各値の影響は次のとおりです。
デフォルトでは、adsafe は高に設定されています。 例: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
省略可 adtest パラメータは、広告のリクエストがテストであることを示すために使用されます。adtest パラメータの値が on の場合、Google はそのリクエストをテストとして扱い、広告のインプレッションのカウントやクリックスルーの結果のトラッキングは行いません。 adtest パラメータの値が on の場合、収益は発生しません。 adtest パラメータが on に設定された広告リクエストが、 [サイト] タブで承認されていないドメインから送信された場合は、「テスト広告」を含む広告が返されます。クリックはできません。 このパラメータはテスト時に使用しますが、本番用システムでは使用しないでください。使用すると、表示された広告に対して支払いが行われません。 デフォルトの adtest 値はオフです。 例: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
省略可 さまざまなページのパフォーマンスをトラッキングするために、検索向け AdSense のチャネルを含めることができます。一意のチャンネル ID を使用する ご自身で作成した AdSense アカウントまたはテクニカル アカウント マネージャーが作成してください。 チャネルについて詳しくは、こちらをご覧ください。 チャンネルが複数ある場合は「+」で区切ります記号で示されます。 例: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
省略可 このパラメータでは、リクエストされた広告または関連する検索のターゲット言語を指定します。デフォルト値は en です。 Google では、AdWords API のすべての言語コードをサポートしています。 注: 広告のターゲット言語は広告主様が指定します。このパラメータをリクエストに含めると、Google は指定された言語またはすべての言語をターゲットとする広告のみを返します。ただし、広告文が指定された言語であることが保証されるわけではありません。 通常、hl パラメータは、このパラメータの送信元ページのメイン言語に設定する必要があります。 例: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
省略可
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
省略可
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
省略可 このパラメータを使用すると、無効なトラフィック検出専用の Cookie を使用する広告を許可することを Google に通知するブール値を指定できます。同意済みのトラフィックと同意のないトラフィックの両方でローカル ストレージに保存されます。
無効なトラフィックはデフォルトで true に設定されています。 例: 'ivt': false |
ユニット単位のパラメータの説明
これらのパラメータは、ページ上の個々の広告ユニットがユーザーに表示される方法に影響します。各パラメータは、広告ユニットごとに個別に設定できます。
必須
パラメータ | 説明と例 |
---|---|
container
|
必須 広告が表示される空の広告コンテナ <div> の ID です。
例: 'container' : 'afscontainer1' |
maxTop
|
広告ユニットが検索結果の上部にある場合は必須。 このパラメータを使用して、上部の広告ユニットに表示する広告の数を指定します。 注: このパラメータは、'number'パラメータを指定します。この広告ユニット 広告の最初の行が折り返されないように十分な幅にするmaxTop の使用 パラメータは、ポリシー違反となります。 例: 'maxTop' : 4 |
width
|
必須 広告または関連する検索ユニットの幅をピクセル単位で指定します。 例: 'width' : '700px' 'width' : 700 |
設定
パラメータ | 説明と例 | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
省略可 広告または関連する検索に 広告または関連する検索が配信されていないときにも発生します。このパラメータは、 呼び出されたときにアクションを実行できる、実装する 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 |