Google Ads (AdWords) データコネクタ

フォローする
Avatar
Vaibhav Gupta
Updated
Google Ads（AdWords）の設定
コスト集計
データコネクタの設定

 

概要情報

データコネクタテクノロジー API (Google Ads API v19)
データの内訳（セグメンテーション）

デフォルト設定では、データは次のディメンションで分類されます:

  • 国
  • キャンペーン
  • サブキャンペーン (Ad Group)
  • サブアドネットワーク (Ad Network Type).

別の設定を選択する場合は、以下の データマッピング を参照してください。
データの取得期間 Singular は毎日、7日前までのデータを取得します。週に1回、月曜日には30日前までのデータを取得します。
タイムゾーン Google の設定でアカウントごとに顧客が定義
データはクリエイティブ（広告）レベルで利用できますか？ はい
Singularはクリエイティブアセットを表示しますか？ はい（YouTube 動画を除く。YouTube 動画はサムネイルのみ表示されます）
既知の制限事項
  • クリエイティブでは国別の粒度は利用できません。
  • クリエイティブレポートにおいて、アセット粒度の Installs 指標は biddable_app_install_conversions" からマッピングされており、次を使用する他の粒度とは異なります: "metrics.conversions"

データマッピング

データは複数の内訳設定のいずれかで取得でき、それぞれ異なるディメンションのセットを提供し、独自の利点と制限があります。

  • デフォルト設定は Countryです。別の設定を選択するには、Singular サポートにお問い合わせください。
  • Metro (DMA) 設定は米国向け広告にのみ有用です（DMA 情報は米国でのみ利用可能）。キャンペーンの一部またはすべてが米国外で運用されている場合は、代わりに City 設定を使用してください。
  • Keyword と Publisher の設定は、 UAC キャンペーンのデータを含みません （Google Ads API の制限によるものです）。
  • Keyword と Publisher の設定には国やその他の位置ディメンションが含まれませんが、Singular はターゲット国の設定に基づいて国を提供できる場合があります。
  • 年齢 または 性別 の内訳は、別個の人口統計内訳として利用できます（例: 女性/男性、20〜29歳など）。   

用語に関するヒント:

Country Metro (DMA) City Keyword Keyword+Quality Score Publisher Shopping Video

Field in Singular UI Field in Singular API Field in Google Country Breakdown
Dimensions
Account ID adn_account_id customer.id
Account Name adn_account_name customer.descriptiveName
App Site ID app_site_id campaign.appCampaignSetting.appId
Asset ID asset_id asset.id
Asset Name asset_name asset.name (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL adn_campaign_url ad.finalUrl
if not available, then ad.trackingUrlTemplate
Country country_field geographicView.countryCriterionId
Creative Format creative_format ad.type
Creative ID creative_id adGroupAd.ad.id
Creative Name creative_name adGroupAd.ad.name
Creative Reported URL creative_reported_url adGroupAd.ad.finalUrls.0
Date date_field segments.date
Final URL final_url campaign.finalUrls OR
adGroupCriterion.finalUrls OR
adGroup.ad.finalUrls
Network Campaign ID adn_campaign_id campaign.id
Network Campaign Name adn_campaign_name campaign.name
Network Creative ID adn_creative_id adGroupAd.ad.id
Network Creative Name adn_creative_name adGroupAd.ad.name
Network Sub Campaign ID adn_sub_campaign_id adGroup.id
Network Sub Campaign Name adn_sub_campaign_name adGroup.name
OS os campaign.appCampaignSetting.appStore
Platform platform A combination of campaign.appCampaignSetting.appStore and segments.device
Public Id site_public_id campaign.appCampaignSetting.appId
Retargeting retention campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network adn_subadnetwork segments.adNetworkType
Target Countries target_countries_str See country
Text creative_text To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. 
Timezone adn_timezone customer.timeZone
(Singular receives time data from Adwords in the client's timezone and converts it to UTC.)
Tracking URL tracking_url adGroupAd.ad.trackingUrlTemplate
Asset Performance
 asset_performance performance_label
Metrics
Cost adn_cost metrics.costMicro
Network Clicks adn_clicks metrics.clicks
Network Impressions adn_impressions metrics.impressions
Network Installs adn_installs metrics.conversions / metrics.allConversions
Original Cost adn_original_cost metrics.costMicro
Original Currency adn_original_currency customer.currencyCode
Video Views video_views metrics.videoViews
Completed Video Views completed_video_views metrics.video_quartile_p100_rate
Video Views - 25% video_views_25pct metrics.video_quartile_p25_rate
Video Views - 50% video_views_50pct metrics.video_quartile_p50_rate
Video Views - 75% video_views_75pct metrics.video_quartile_p75_rate

Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細は こちらをご覧ください。

特別な設定手順

認証

データコネクタの設定に関する一般的な情報は、 データコネクタ FAQ を参照してください。

AdWords データコネクタを設定する際、Google Ads アカウントでのログインを求められます。 Google Ads マネージャーアカウント（旧称 MCC アカウント）でのサインインを強く推奨します。

Google マネージャーアカウント（MCC）を使用すると、すべての広告アカウントに一度にアクセスできます。その後、Singular のレポートに含めるアカウントをリストから選択できます。マネージャーアカウント（MCC）を使用しない場合は、広告アカウントごとに別々のデータコネクタを追加する必要があります。

カスタマー ID を確認するには（マネージャーアカウント・個別アカウントの両方）:

  1. 次にログインします: Google Ads アカウント。
  2. 右上のヘルプアイコンをクリックします。
  3. メニュー下部の Customer ID を確認します。

コンバージョンイベント

上の表にあるデフォルトの指標に加えて、Singular は Google Ads から必要な任意の指標を取得し、その統計を Singular のレポートに表示できます。

アセットレベルでより詳細なインサイトが必要な場合は、'biddable-app-post-install-conversion' をイベントとして追加することを検討してください。このデータは Google Ads の API から取得されます。この機能により、'アプリ内アクション' イベントの追加データを該当するキャンペーンに取り込めます。ただし、コンバージョンイベントにはコホートデータがなく、'実際の' コホート期間にのみ関連付けられる点にご注意ください。

Singular で コンバージョンイベント を設定するには、次の手順を実行します:

  1. Singular で Settings > Eventsに移動します。 Custom Events と Conversion Events の両方のタブがある場合は、 Conversion Eventsを選択します。
  2. New Eventをクリックします。

  3. AdWords のドロップダウンには、AdWords で利用可能な指標の一覧が表示されます。各アクティビティを個別の Singular イベントにマッピングすることも、複数の指標を1つのイベントにまとめることもできます。

    翌日、Singular がアカウントの日次データを取得する際に、これらのアクティビティの統計も併せて取得します。

  4. Singular が新しいコンバージョンイベントにデータを取り込んだ後、 Reports ページでレポートを実行するときに、 Events ドロップダウンから該当するコンバージョンイベントを選択します。

FAQ とトラブルシューティング

マネージャーアカウント ID（MCC ID）はどこで確認できますか？

カスタマー ID を確認するには（マネージャーアカウント・個別アカウントの両方）:

  1. 次にログインします: Google Ads アカウント。
  2. 右上のヘルプアイコンをクリックします。
  3. メニュー下部の Customer ID を確認します。

詳細については、Google のドキュメントの Google Ads マネージャーアカウントについて を参照してください。

Google Ads マネージャーアカウントを 認証 できないのはなぜですか？

Google Ads マネージャーアカウントで、次に移動します: Settings > Network Settings。 API accessがオンになっていることを確認してください。その後、Singular で Google Ads マネージャーアカウントの再認証をお試しください。

google_auth.png

別の内訳を使用しているのに、レポートに 国のデータ が表示されることがあるのはなぜですか？

国の情報を提供しない内訳を使用している場合でも、Singular は Google の キャンペーン ターゲティング設定 および/または トラッカーデータ （保有している場合）を参照して、国の粒度を提供しようとします:

  1. キャンペーンが1つの国をターゲットにしている場合、その国をレポートに表示します。
  2. 複数の国がターゲットになっており、同じキャンペーンのトラッカーデータも保有している場合は、トラッカーデータの国別インストール比率に基づいて国別コストを推定します。次を参照してください: 国別のコスト指標はどのように計算されますか？
Singular は AdWords キャンペーンの Network Installs をどのように取得しますか？

Google Ads は「コンバージョンアクション」と呼ばれるさまざまな種類（アプリのダウンロード、ユーザー登録、購入など）をトラッキングしています。お客様の多くがアプリインストールに関心をお持ちのため、Singular はデフォルトで download タイプのコンバージョンを取得し、その指標をレポートの Network Installs フィールドに表示します。

注: Network Installs は広告ネットワークが報告したインストール数を示す Singular の指標であり、 Installsと混同しないようご注意ください。後者は通常、アトリビューショントラッカーのデータに基づいています。AdWords の場合、 Network Installs は AdWords が報告した "first_open" コンバージョンの数です。

レポートクエリを作成する際、 Network Installs を Source Metrics セクションで選択できます。詳細については、 Source Metrics とは？ を参照してください。

Singular は AdWords から クリエイティブ を取得しますか？

はい。Singular はクリエイティブの指標だけでなく、クリエイティブそのもの（画像、テキスト、動画など）も取得します。これは旧バージョンの AdWords 連携でも新バージョンでも同じです。ただし、 UAC キャンペーンのクリエイティブを表示するのは新しい連携のみです。

AdWords の文脈における "creative" とは何ですか？ 「creative」と「asset」の違いは何ですか？

Singular の Creative は Google Ads の Adに相当します。

Singular の新しい Asset ディメンションは Google Ads の Assetに相当します。Google では、UAC（モバイルアプリ）広告など一部の広告タイプが複数のアセットを含むため、この新しい粒度を追加しました。アセットについて報告されるインストール数は "biddable_app_install_conversions" 指標から取得され、次を使用する他の粒度とは異なります: "metrics.conversions"

Singular はどの Google の広告タイプ に対応していますか？

Singular は次の Google 広告タイプに対応しています:

広告タイプ 含まれる広告アセット
テキスト 画像 動画
Gmail 含まれる    
Hotel 含まれる    
Local 含まれる    
Text 含まれる    
Expanded Text 含まれる    
Expanded Dynamic Search 含まれる    
Shopping Product 含まれる    
Shopping Smart 含まれる    
Call Only 含まれる    
HTML5 Upload 含まれる    
Dynamic HTML5 含まれる    
Responsive Search 含まれる    
Legacy Responsive Search 含まれる    
Legacy App Install 含まれる    
Responsive Display   含まれる  
Video     含まれる
VIDEO BUMPER     含まれる
VIDEO NON SKIPPABLE IN STREAM     含まれる
VIDEO OUTSTREAM     含まれる
VIDEO TRUEVIEW DISCOVERY     含まれる
VIDEO TRUEVIEW IN STREAM     含まれる
VIDEO RESPONSIVE     含まれる
App (UAC) 含まれる 含まれる 含まれる
App Engagement (UAC - deep linked ads) 含まれる 含まれる 含まれる
APP PRE REGISTRATION 含まれる 含まれる 含まれる

注: Google の広告タイプ名（「App Engagement」「Responsive Search」など）は Singular のレポートには 表示されません。レポートに表示される Creative Type ディメンションはこれとは無関係で、クリエイティブが画像・テキスト・動画のいずれであるかを示します。

国の内訳を取得しています。 国の情報がない行が表示されるのはなぜですか？

これは、 同じキャンペーンについて Google が異なるエンドポイントで提供するデータに差異がある場合に発生することがあります。

Singular は Google Ads API からデータを取得する際、次の手順を実行します:

  1. 選択した内訳のデータを、対応する Google Ads API エンドポイントから取得します。この場合は国の情報を提供する location_view エンドポイントです。
  2. 完全な指標を取得するため、同じキャンペーンのデータを Google の campaign エンドポイントから取得します。
  3. 各キャンペーンの指標を比較し、必要に応じて データを揃えるための行を追加します。例については下の図を参照してください。 キャンペーンレベルのデータが信頼できる基準とみなされる点にご注意ください。

Screen_Shot_2019-12-01_at_19.29.13.png

クリエイティブレポートで 動画 を確認できないのはなぜですか？

Google のプライバシーポリシーにより、YouTube 動画をダウンロードすることはできません。そのため、動画クリエイティブについては、動画のサムネイルと YouTube 動画へのリンクを提供しています。

video views と video views - 25%, 50%, 75%の違いは何ですか？ video views が video views - completedより多くなったり少なくなったりすることはありますか？

video views 指標は、開始された動画視聴の回数をカウントします。動画が最後まで視聴されたか、1秒だけ見られたかにかかわらず、動画のすべてのインプレッションをカウントします。

video views - 25%, 50%, and 75% 指標は、 次を計算します: それらのインプレッションのうち、動画をそれぞれ 25%、50%、75% の地点まで視聴した人数です。同様に、 completed video views 指標は 次のみを計算します: 動画が最後まで視聴されたインプレッションです。これらの値を計算するには、Google が推奨する次の計算式を使用します: impressions * video_view_rate.

必要に応じて、動画視聴回数の指標の代わりにパーセンテージ指標のいずれかを使用することもできます。 Google のドキュメントの "Video played to" セクションを参照してください。

注: YouTube 動画の視聴回数と Google Ads アカウントに表示される視聴回数の間には、本質的な差異があります。YouTube の視聴回数と Google Ads アカウントの視聴回数は、異なる指標で計算されています。

  • YouTube は、動画を30秒以上視聴した場合、または動画が終わるまで視聴した場合（いずれか早い方）を1回の視聴としてカウントします。
  • Google Ads は、YouTube またはパートナーサイトで広告が表示された際にカウントされる広告インプレッションを1回の視聴としてカウントします。
  • その結果、YouTube アナリティクスで報告される視聴回数と Google Ads アカウントに表示される視聴回数に差が生じることがあります。
  • また、YouTube アナリティクスはリアルタイムで更新されますが、Google Ads のデータは更新に最大48時間かかることがあります。

さらに、YouTube 広告と視聴指標は従来のオンライン広告とは異なる仕組みで動作します。YouTube 広告を配信する場合、誰かが広告を30秒以上視聴した場合、またはクリック誘導オーバーレイやコンパニオンバナーのクリックなど何らかの形で操作した場合にのみ課金されます。 そのため、YouTube 広告の効果を測るには、単なる視聴回数ではなく、視聴率（view-through rate）や獲得アクション（earned actions）などのエンゲージメント指標に 注目することが重要です。

クリエイティブレポートで Media Bundles を確認できないのはなぜですか？

Media Bundle は、「Image」「Text」「Video」と並ぶもう1つのクリエイティブタイプです。広告クリエイティブにメディアバンドルが含まれる場合、そのクリエイティブの指標は確認できますが、Google Ads API がクリエイティブを提供しないため、クリエイティブそのものは表示されません。

Creative Name ディメンションが常に利用できるとは限らないのはなぜですか？

UAC クリエイティブについては、Google は名前を提供せず、ID のみを提供します。