リファレンス

パラメータ

ページ単位のパラメータの説明

これらのパラメータは、ページごとに 1 回だけ指定する必要があります。 ページ上のすべての広告ユニットに適用されます。

必須

パラメータ 説明と例
adPage ユーザーが次の結果ページまたは前の結果ページに移動するときに必須。

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

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 関連する検索ユニットがページにある場合は必須です。
関連する検索ユニットをリクエストする場合、このパラメータは必須です。使用するデータのタイプを 関連する検索機能は、ページの内容に応じて表示されます。 <ph type="x-smartling-placeholder">
    </ph>
  • 'content'このオプションはコンテンツ ページの関連する検索に使用します(例: 記事、 ブログ投稿など)。
  • 'query' このオプションは、Google 検索の関連する検索にのみ使用します 検索結果ページ。

注: relatedSearchTargeting ページ パラメータは、 「query」できます。ただし、このデフォルト値は 30 日ごとの 検索結果ページのみ(検索の関連する検索)用に作成されました。もし 他の種類のページ(記事、ブログ投稿など)で関連する検索を使用する場合は、 明示的に「content」に設定します。

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

  • 特定の関連する検索機能は、この値に応じて有効または無効にできます。 ページ パラメータを指定します。
  • ページの種類を偽っている、またはデフォルトの「クエリ」に依存しているの 検索結果ページ以外のページの relatedSearchTargeting パラメータは、 指示を出すこともできます。
  • Google は、この値が設定されているかどうかにかかわらず、この値の正確性を定期的に検証します。 デフォルトを使用できます。

例:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId 必須
上の広告または関連する検索ユニットに適用されるカスタム検索スタイルの ID を指定します。 表示されます。 <ph type="x-smartling-placeholder"></ph> カスタム検索スタイルの使用に関する詳細リクエストに styleId が設定されている場合、 広告または関連する検索はそのスタイルでレンダリングされ、以前のスタイル パラメータは 無視されます。リクエストで styleId が指定されていない場合、システムのデフォルト スタイルがレンダリングされます。

例:

'styleId': '1234567890'

省略可

パラメータ 説明と例
linkTarget 省略可
広告をクリックしたときと同じウィンドウで開くか、新しいウィンドウで開くかを指定します クリックします。デフォルトは「_top」です。このパラメータはユニットレベルで使用することもできます。
  • '_top' 同じウィンドウで開きます。
  • '_blank' 新しいウィンドウで開きます。

例:

'linkTarget' : '_blank'
maxTermLength 省略可
関連する検索キーワードの最大文字数を指定します(スペースを含む)。 設定しない場合、最大値はありません。

例:

'maxTermLength' : 50
referrerAdCreative 省略可
ユーザーが「コンテンツ ページの関連する検索」ユニットを含むコンテンツ ページを表示した場合 他のウェブサイト上の広告またはリンクをクリックすること、その広告またはリンクがご自身の管理下にあること。 このパラメータには、広告またはリンクのクリエイティブ テキストをそのまま設定する必要があります。

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

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

注: terms パラメータ。

次に例を示します。

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

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam 省略可
検索結果ページの検索クエリの URL パラメータの名前を指定します。 指定しない場合のデフォルトは「q」です。

例:

'resultsPageQueryParam' : 'query'
terms 省略可
このパラメータを使用すると、関連する検索キーワードのカンマ区切りのリストを指定できます。 関連する検索リクエストで返されますが、Google は、 利用規約に記載されます。

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

次に例を示します。

'terms' : 'cars rental, flight ticket'
ignoredPageParams 省略可
コンテンツの関連する検索を含むコンテンツ ページの URL パラメータのリストを指定します コアコンテンツやユーザー エクスペリエンスに影響を与えずに無視しても差し支えない広告ユニットを配置します。

注: 関連する検索語句をサイトに表示する前に、Google が ページをクロールして、コンテンツがコンテンツとの関連性が高いことを確認します。ページがまだダウンロードされていない場合 robots.txt などによって、クローラーによってクロールされた AdSense クローラ ユーザーが入力した関連する検索語句の候補は表示されなくなります。

コンテンツ ページの関連する検索では、Google のコンテンツ クロール システムを使用してインデックスに登録します 関連性の高い検索語句を生成できます。「 ユーザー ID、セッション ID、その他の動的 ID などによって、 クローラはページのコア コンテンツを評価できないため、 関連性の低い関連検索語句を見つけます。このページ パラメータは、Google のクローラに コンテンツを適切にインデックス登録し、不要なクロールを減らす 負荷を軽減できます。これにより、Google はページがすでにクロールされたことをより正確に認識して、クロールを開始できるようになります。 推奨キーワードを表示(Google と、該当する場合はパートナー様の両方)。

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

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

例:
ユーザーがコンテンツ ページにアクセスし、URL が次のようになっているとします。

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 の有効な設定と、返される広告に対する各値の影響は次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • 'high': 一般向けの広告を返します。成人向け広告や、アダルト コンテンツの広告は返しません。
  • 'medium': 一般向け広告と成人向け広告を返します。アダルト コンテンツの広告は返しません。
  • 'low': すべてのタイプの広告を返します。

デフォルトでは、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 省略可

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

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

標準名 関連するサポート対象言語
latin1 ISO-8859-1 西ヨーロッパ言語(カタルーニャ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、インドネシア語、イタリア語、ノルウェー語、ポルトガル語、スペイン語、スウェーデン語)
latin2 ISO-8859-2 東ヨーロッパ言語(クロアチア語、チェコ語、ハンガリー語、ポーランド語、ルーマニア語、セルビア語、スロバキア語、スロベニア語)
latin3 ISO-8859-3  
latin4 ISO-8859-4 バルト語(エストニア語、ラトビア語、リトアニア語)
キリル文字 ISO-8859-5 ブルガリア語、ロシア語
アラビア語 ISO-8859-6  
ギリシャ語 ISO-8859-7 ギリシャ語
ヘブライ暦 ISO-8859-8 ヘブライ語
latin5 ISO-8859-9  
latin6 ISO-8859-10 アイスランド語
euc-jp EUC-JP 日本語
EUC EUC-KR 韓国語
Sjis Shift_JIS 日本語
big5 Big5 中国語(繁体)
gb GB2312 中国語(簡体)
utf-8 UTF-8 すべて
oe 省略可

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

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

標準名 関連するサポート対象言語
latin1 ISO-8859-1 西ヨーロッパ言語(カタルーニャ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、インドネシア語、イタリア語、ノルウェー語、ポルトガル語、スペイン語、スウェーデン語)
latin2 ISO-8859-2 東ヨーロッパ言語(クロアチア語、チェコ語、ハンガリー語、ポーランド語、ルーマニア語、セルビア語、スロバキア語、スロベニア語)
latin3 ISO-8859-3  
latin4 ISO-8859-4 バルト語(エストニア語、ラトビア語、リトアニア語)
キリル文字 ISO-8859-5 ブルガリア語、ロシア語
アラビア語 ISO-8859-6  
ギリシャ語 ISO-8859-7 ギリシャ語
ヘブライ暦 ISO-8859-8 ヘブライ語
latin5 ISO-8859-9  
latin6 ISO-8859-10 アイスランド語
euc-jp EUC-JP 日本語
EUC EUC-KR 韓国語
Sjis Shift_JIS 日本語
gb GB2312 中国語(簡体)
utf-8 UTF-8 すべて
ivt 省略可
このパラメータを使用すると、無効なトラフィック検出専用の Cookie を使用する広告を許可することを Google に通知するブール値を指定できます。同意済みのトラフィックと同意のないトラフィックの両方でローカル ストレージに保存されます。
  • trueこのパラメータが存在しない場合、または「true」に設定した場合は、無効なトラフィック検出専用の Cookie が設定され、同意済みのトラフィックでのみローカル ストレージが使用されます。
  • falseこのパラメータを「false」に設定した場合無効なトラフィック専用の Cookie が設定され、同意済みのトラフィックと同意のないトラフィックの両方でローカル ストレージが使用されます。

無効なトラフィックはデフォルトで true に設定されています。

例:

'ivt': false

ユニット単位のパラメータの説明

これらのパラメータは、ページ上の個々の広告ユニットがユーザーに表示される方法に影響します。各パラメータは、広告ユニットごとに個別に設定できます。

必須

パラメータ 説明と例
container 必須
広告が表示される空の広告コンテナ <div> の ID です。

例:

'container' : 'afscontainer1'
maxTop 広告ユニットが検索結果の上部にある場合は必須。

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

注: このパラメータは、'number'パラメータを指定します。この広告ユニット 広告の最初の行が折り返されないように十分な幅にするmaxTop の使用 パラメータは、ポリシー違反となります。

例:

'maxTop' : 4
width 必須
広告または関連する検索ユニットの幅をピクセル単位で指定します。

例:

'width' : '700px'
'width' : 700

設定

パラメータ 説明と例
adLoadedCallback 省略可
広告または関連する検索に 広告または関連する検索が配信されていないときにも発生します。このパラメータは、 呼び出されたときにアクションを実行できる、実装する JavaScript コールバック関数です。 完了です。

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

containerName 広告または関連する検索ユニットのコンテナ名。
adsLoaded 表示する広告または関連する検索語句が 1 つ以上ある場合は true、false に設定します 広告または関連検索が返されなかったとき。
isExperimentVariant カスタム スタイルのテストが実行中で、 広告を表示するにはテストが選択されます
callbackOptions 次のフィールドを含む JSON オブジェクト。
termPositions: 関連する検索ブロックの場合は、map<string,int> が含まれます。パブリッシャーが提供した割合 ゼロ インデックス位置にキーワードを追加します。キーワードを指定すると、 返されないと、地図に表示されません。

注: コールバック関数をテストして、エラーが発生しないことを確認してください。 ページの読み込みを妨げる可能性がある要素には特に注意します。

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