Google Ads（AdWords）データコネクタ

フォローする
Avatar
Vaibhav Gupta
Updated
グーグル広告（アドワーズ）の設定
コスト集計
データコネクターの設定

 

クイック詳細

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

デフォルトの設定では、データの内訳は以下のとおりです：

  • 国
  • キャンペーン
  • サブキャンペーン（広告グループ）
  • サブアドネットワーク（アドネットワークの種類）。

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

データのマッピング

それぞれ異なるディメンション・セットを提供し、それぞれに利点と制限があります。

  • デフォルトの構成は「国」です。その他の設定をご希望の場合は、Singularサポートまでお問い合わせください。
  • メトロ（DMA）設定は、米国ベースの広告にのみ有効です（DMA情報は米国でのみ利用可能です）。キャンペーンの一部または全部が米国外で運営されている場合は、代わりにCity（都市）設定を使用してください。
  • Google Ads APIの制限により、Keyword および Publisher 設定にはUACキャンペーンのデータは含まれません。
  • キーワードと パブリッシャー設定には国やその他のロケーションディメンションは含まれていませんが、Singularは対象国の設定に基づいて国を提供できる場合があります。

用語に関するヒント

  • SingularのクリエイティブはGoogle Adsの広告に対応します。
  • Singularの新しいアセットディメンションはGoogle広告のアセットに対応します。Googleでは、UAC（モバイルアプリ）広告のように、複数のアセットを含むタイプの広告があるため、この新しいレベルの粒度を追加しました。
  • Singularレポートのすべてのフィールドの説明については、Singular Metrics and Dimensions Glossaryを参照してください。
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

特別な設定方法

認証

データコネクタのセットアップに関する一般的な情報については、データコネクタFAQを参照してください。

AdWords データコネクタを設定する際、Google Ads アカウントを使用してログインするよう求められます。Google Ads Manager アカウント（旧称：MCC アカウント）でのログインを強くお勧めします。

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

顧客IDを検索するには（マネージャーアカウントと個別アカウントの両方について）：

  1. Google Adsアカウントにログインします。
  2. 右上のヘルプアイコンをクリックします。
  3. メニューの一番下にあるカスタマーIDを検索します。

コンバージョンイベント

上表のデフォルトメトリクスに加え、SingularはGoogle Adsから必要なメトリクスを取得し、Singularレポートに表示することができます。

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

Singularでコンバージョンイベントを設定するには、以下のステップを踏む：

  1. Singularで、設定 > イベントに進みます。カスタムイベントと コンバージョンイベントの両方のタブがある場合は、コンバージョンイベントを選択します。
  2. 新規イベントをクリックします。

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

    翌日、Singularがアカウントのデイリーデータを取得すると、これらのアクティビティの統計も取得されます。

  4. Singularが新しいコンバージョンイベントにデータを入力した後、レポートページでレポートを実行する際に、イベントドロップダウンからコンバージョンイベントを選択します。

よくある質問とトラブルシューティング

マネージャーアカウントID（MCC ID）はどうすればわかりますか？
#

顧客IDを確認するには（マネージャーアカウントと個人アカウントの両方）：

  1. Google Adsアカウントにログインします。
  2. 右上のヘルプアイコンをクリックします。
  3. メニューの一番下にあるカスタマーIDを検索します。

詳細については、Google のドキュメントにある「Google Ads Manager アカウントについて」を参照してください。

Google Ads Managerアカウントを認証できないのはなぜですか？

Google Ads Managerアカウントで、[設定] > [ネットワーク設定]に進みます。API アクセスが有効になっていることを確認してください。その後、SingularでGoogle Ads Managerアカウントを再認証してください。

google_auth.png

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

国情報を提供しない内訳を使用している場合、SingularはGoogleのキャンペーンターゲティング設定や トラッカーデータ（もしあれば）を見て、国の粒度を提供しようとします：

  1. キャンペーンが1つの国をターゲットにしている場合は、レポートにその国を表示します。
  2. 複数の国をターゲットにしており、同じキャンペーンのトラッカーデータもある場合は、トラッカーデータの国ごとのインストール比率に基づいて、国ごとのコストを推定します。国ごとのコスト指標はどのように計算されますか？
SingularはどのようにしてAdWordsキャンペーンのネットワークインストールデータを取得するのですか？

Google Adsは、アプリのダウンロード、ユーザー登録、購入など、さまざまなタイプの「コンバージョンアクション」をトラッキングします。デフォルトでは、ほとんどのお客様がアプリのインストールに興味を持っているため、ダウンロードタイプのコンバージョンをプルし、レポートのネットワークインストールフィールドにその指標を表示します。

注： ネットワークインストールは 、広告ネットワークから報告されたインストール数を反映するSingularの指標です。 通常アトリビューショントラッカーからのデータに基づいているインストールと混同しないでください。 Adwordsの場合、ネットワークインストールはAdwordsから報告された「first_open」コンバージョンの数です。

レポートクエリを作成する際、ソースメトリクスセクションで ネットワークインストール数を選択することができます。 詳しくはソースメトリクスとはをご覧ください。

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

はい、Singularはクリエイティブそのもの（画像、テキスト、動画など）だけでなく、クリエイティブメトリクスも引き出します。これは旧バージョンのAdWords統合でも新バージョンでも同じです。ただし、UACキャンペーンのクリエイティブが表示されるのは新しい統合版のみです。

AdWordsにおける「クリエイティブ」とは何ですか？クリエイティブ」と「アセット」の違いは何ですか？

SingularのクリエイティブはGoogle Adsの広告に対応します。

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

SingularはどのGoogle広告タイプをサポートしていますか？

Singularは以下のGoogle広告タイプに対応しています：

広告タイプ 含まれる広告アセット
テキスト 画像 動画
Gメール    
ホテル    
ローカル    
テキスト    
拡大テキスト    
拡張ダイナミック検索    
ショッピング商品    
スマートショッピング    
通話のみ    
HTML5アップロード    
ダイナミックHTML5    
レスポンシブ検索    
レガシーレスポンシブ検索    
レガシーアプリインストール    
レスポンシブ表示    
ビデオ    
ビデオバンパ    
ストリームでスキップできないビデオ    
ビデオ・アウトストリーム    
ビデオ・トゥルービュー・ディスカバリー    
ビデオ・トゥルービュー・イン・ストリーム    
ビデオレスポンシブ    
アプリ（UAC）
アプリエンゲージメント（UAC - ディープリンク広告）
アプリ事前登録

注：広告タイプに対するGoogleの名前（「アプリエンゲージメント」、「レスポンシブ検索」など）は、Singularレポートには表示されません。レポートに表示されるクリエイティブタイプのディメンションは無関係で、クリエイティブが画像、テキスト、動画のいずれかを示しています。

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

これは、Googleが同じキャンペーンに対して異なるエンドポイントで提供するデータの間に矛盾がある場合に発生する可能性があります。

SingularはGoogle Ads APIからデータを取得する際、以下のステップを実行します：

  1. 選択した内訳のデータを、対応するGoogle Ads APIエンドポイント（この場合は国情報を提供するlocation_viewエンドポイント）から引き出します。
  2. Googleのキャンペーンエンドポイントから同じキャンペーンのデータを取得し、完全なメトリクスを取得します。
  3. 各キャンペーンのメトリックスを比較し、必要に応じて行を追加してデータを揃えます。例として下の図をご覧ください。キャンペーンレベルのデータが真実のソースと見なされることに注意してください。

Screen_Shot_2019-12-01_at_19.29.13.png

クリエイティブ レポートに動画が表示されないのはなぜですか？

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

動画再生回数と 動画ビューの違いは何ですか - 25％、50％、75％？動画再生回数は、動画再生回数より高くすることも低くすることもできますか？

動画視聴の指標は、動画視聴が開始された回数のカウントです。動画全体が視聴されたか、一瞬だけ視聴されたかに関わらず、動画のすべてのインプレッションをカウントします。

動画視聴 - 25%、50%、75%メトリクスは、これらのインプレッションのうち、それぞれ 25%、50%、75% マークまで動画を視聴した人の数を計算します。同様に、完了した動画ビューの指標は、動画全体が視聴されたインプレッションのみを計算します。これらの値を計算するには、Google が提案する式を使用します：impressions * video_view_rate.

ニーズによっては、動画視聴数メトリクスではなく、パーセンテージ メトリクスのいずれかを使用することもできます。Google のドキュメントの「Video played to」のセクションを参照してください。

注意:YouTube 動画の再生回数と Google Ads アカウントの再生回数には、固有の不一致があります。YouTubeの再生回数とGoogle広告アカウントの再生回数は異なる指標で計算されます。

  • YouTubeでは、少なくとも30秒間、または動画の最後まで視聴した方を再生回数としてカウントします。
  • Google 広告では、YouTube またはパートナー サイトに広告が表示されたときにカウントされる広告インプレッションとしてビューをカウントします。
  • そのため、YouTubeアナリティクスで報告される再生回数とGoogle広告アカウントで表示される再生回数が異なる場合があります。
  • また、YouTubeアナリティクスはリアルタイムで更新されますが、Google Adsのデータは更新に最大48時間かかる場合があります。

さらに、YouTube広告と再生回数の指標は、従来のオンライン広告とは異なる仕組みになっています。YouTube広告を掲載する場合、誰かが30秒間広告を見るか、コールトゥアクションのオーバーレイやコンパニオンバナーをクリックするなど、何らかの方法で広告とインタラクションした場合にのみ課金されます。 したがって、YouTube広告の効果を測るには、ビュースルー率やアーンドアクションなどのエンゲージメント指標に注目することが重要 です。

クリエイティブレポートでメディアバンドルが表示されないのはなぜですか？

メディアバンドルは、「画像」、「テキスト」、「動画」と並ぶクリエイティブの一種です。広告クリエイティブのいずれかがメディアバンドルである場合、Google Ads APIがクリエイティブを提供しないため、これらのクリエイティブの指標は表示されますが、クリエイティブ自体は表示されません。

クリエイティブ名のディメンションが常に利用できないのはなぜですか？

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