ValueTrack パラメータは、広告のランディング ページ URL に追加できる URL パラメータの一種です。このパラメータでは、広告クリックの発生元に関する情報を収集できます。広告のクリックについての詳細を知りたい場合や、トラッキングを始めたばかりの場合に最適です。
自動タグ設定を有効にすると、すべての URL に Google クリック ID(GCLID) が自動的に追加され、後で広告クリックを レポートの行にマッピングするために使用できます。
ValueTrack パラメータの仕組みの概要については、
ValueTrack パラメータについてをご覧ください。
ValueTrack パラメータの完全なリストについては、利用可能な ValueTrack パラメータ セクションを
ValueTrack パラメータでトラッキングを設定するでご覧ください。
Google アナリティクスとその関連 APIを使用して、クリックに関する指標を収集することもできます。
Google Ads API レポートには、ValueTrack パラメータに対応するフィールドをクエリできるリソースとビューがあります。ただし、マッピングされたフィールドのテキスト値が必ずしも同じであるとは限りません。たとえば、{matchtype} が
e(完全一致の略)の場合、
ad_group_criterion.keyword.match_type
などの対応するレポート フィールドには EXACT と表示されます。次の表に、マッピングの例をいくつか示します。
ValueTrack パラメータとレポート フィールドのマッピング
| ValueTrack パラメータ | レポート リソースのフィールド | 説明 |
|---|---|---|
{adgroupid} |
ad_group.id |
広告グループ ID(トラッキング情報がアカウント単位かキャンペーン単位で設定されていて、広告を配信した広告グループを把握する場合に使用します)。 |
{adposition} |
次の組み合わせにマッピングされます。
「top」や「side」など、広告の掲載位置にマッピングされるフィールドはありません。 |
広告が表示されたページ上の位置( 「1t2」などの値。これは 1 ページ目の上部、2 番目の位置を意味します)。 |
{advanced_booking_window} |
segments.hotel_booking_window_days |
広告クリックの日付から広告で宣伝しているチェックイン 日までの日数。たとえば、広告クリックが 6 月 5 日に発生して、 チェックイン日が 6 月 8 日の場合は「3」になります。 |
{campaignid} |
campaign.id |
キャンペーン ID(トラッキング情報がアカウント単位で設定されていて、広告を配信したキャンペーンを把握する場合に使用します)。 |
{creative} |
ad_group_ad.ad.id |
広告の一意の ID。 |
{device} |
segments.device |
クリックが行われた端末の種類。 |
{feeditemid} |
なし(提供終了。
asset.id で {extensionid} を使用)
|
クリックされたフィードベースの広告表示オプションの ID。
注: フィードベースの広告表示オプションは提供終了となり、サポートされている Google Ads API バージョンに対応する
レポート リソースはありません。アセットベースの広告表示オプション
では、{extensionid} が使用され、
asset.id にマッピングされます。
|
{extensionid} |
asset.id |
クリックされたアセットベースの広告表示オプションの ID。 |
{hotelcenter_id} |
segments.hotel_center_id |
クリック時に広告を生成したキャンペーンにリンクされている Hotel Center アカウントの ID。 |
{hotel_id} |
segments.partner_hotel_id |
関連付けられたアカウントのホテルフィードからのホテルのホテル ID。 |
{keyword} |
segments.keyword.ad_group_criterion
テキスト クエリは条件 リソース名を使用して確認できます。 |
検索ネットワークの場合: ご利用のアカウントで、対象の検索語句と一致したキーワード。 ディスプレイ ネットワークの場合: ご利用のアカウントで、対象のコンテンツと一致したキーワード。 |
{loc_interest_ms} |
click_view.area_of_interest.most_specific |
広告表示につながった、関心対象地域の ID。(条件 ID は
GeoTargetConstantService.SuggestGeoTargetConstants を使用して検索できます)。
|
{loc_physical_ms} |
click_view.location_of_presence.most_specific |
クリックの地理的位置の ID。(条件 ID は
GeoTargetConstantService.SuggestGeoTargetConstants を使用して検索できます)。
|
{lpurl} |
最終ページ URL。トラッキング テンプレートの先頭に {lpurl} を挿入しなければ、最終ページ URL はエスケープされます。トラッキング テンプレートの先頭に {lpurl} がない場合、?、=、"、#、\t、'、[space] の文字はエスケープされます。 |
|
{matchtype} |
広告表示につながったキーワードのマッチタイプ。 (マッチタイプの詳細。) | |
{merchant_id} |
segments.product_merchant_id |
クリックされたショッピング広告を直接所有している Google Merchant Center アカウントの ID。 |
{placement} |
広告がクリックされたコンテンツ サイト(キーワード ターゲティング キャンペーンの場合)、または広告がクリックされたサイトと一致するプレースメントのターゲティング条件(プレースメント ターゲティング キャンペーンの場合)。 | |
{product_channel} |
segments.product_channel |
クリックされた商品リスティング広告に表示されている商品が売れたときのショッピング チャネルのタイプ。 |
{product_country} |
segments.product_country |
クリックされた広告が扱う商品の販売先の国。 |
{product_id} |
segments.product_item_id |
Merchant Center のデータフィードに表示される、クリックされた広告で紹介されている商品の ID。 |
{product_language} |
segments.product_language |
Merchant Center のデータフィードに表示される、商品情報に使用される言語。 |
{product_partition_id} |
ad_group_criterion.criterion_id |
クリックされた商品広告が属する商品グループの一意の ID。 |
{rate_rule_id} |
segments.hotel_rate_rule_id
|
クリックされた特別価格の ID。旅行代理店の広告主は、特定のユーザー(ポイント会員など)、特定のデバイス(モバイル ユーザーへの割引など)、特定の国に限定価格を適用できます。 |
{store_code} |
segments.product_store_id |
ローカル ショッピング チャネルを使用するキャンペーンでは、実店舗の一意の ID が表示されます。 |
{targetid} |
広告表示につながったキーワード(ラベル「kwd」)、AI 最大化設定キーワードなしマッチ(「kwl」)、
動的検索広告(「dsa」)、リマーケティング リスト ターゲット(「aud」)の ID。たとえばリマーケティング リストを広告グループに追加し(条件 ID「456」)、キーワード ID「123」をターゲットとする場合、{targetid} は「kwd-123:aud-456」となります。 |
|
{travel_start_day}{travel_start_month}{travel_start_year} |
segments.hotel_check_in_date |
広告に表示されるチェックイン日(日、月、年)。 |
Google 広告管理画面と Google Ads API 間での ValueTrack パラメータのマッピング
次の表に、Google 広告管理画面と Google Ads API 間での ValueTrack パラメータのマッピングを示します。特に、
AdNetworkType 列挙型値へのマッピングを示します。
| UI 名 | API 列挙型 | ValueTrack パラメータ |
メモ |
|---|---|---|---|
| Google ディスプレイ ネットワーク | CONTENT |
d |
Google 動画パートナーの場合、ValueTrack パラメータ vp は API で CONTENT と表示されます。 |
| Google TV | GOOGLE_TV |
gtv |
|
| クロスネットワーク | MIXED |
x |
ValueTrack パラメータが常に存在するとは限りません。 |
| Google 検索 | SEARCH |
g |
|
| 検索パートナー | SEARCH_PARTNERS |
s または a |
a は AI 最大化設定マッチを表し、通常はキーワードなしトラフィックに関連付けられます。 |
| なし | UNKNOWN |
なし | クエリ対象の Google Ads API バージョンで Google 広告管理画面のネットワーク値がサポートされていない場合に返されます。 |
| なし | UNSPECIFIED |
なし | |
| YouTube | YOUTUBE |
ytv |
|
| Google が所有するチャンネル | UNKNOWN |
デマンド ジェネレーションでは、ネットワークの ValueTrack パラメータは返されません。 |