ValueTrack パラメータをレポート フィールドにマッピングする

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 パラメータは返されません。