グーグル広告(アドワーズ)データコネクター

ドキュメント

クイック詳細

データコネクタテクノロジー 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はターゲット国の設定に基づいて国を提供できる場合があります。
  • 年齢や 性別の 内訳は、個別のデモグラフィックブレイクダウン(女性/男性、20~29歳など)としてご利用いただけます。

用語に関するヒント

  • SingularのクリエイティブはGoogle広告の広告に対応しています。
  • Singularの新しいアセットディメンションはGoogle Adsのアセットに対応します。Googleでは、UAC(モバイルアプリ)広告のように、複数のアセットを含むタイプの広告があるため、この新しいレベルの粒度を追加しました。
  • Singularレポートのすべてのフィールドに関する説明は、Singular Metrics and Dimensions Glossaryをご覧ください。
  • Googleでクリエイティブレポートを実行する方法については、MetaとGoogle Adsでクリエイティブレポートを実行する方法をご覧ください。
メトロ(DMA) 都市 キーワード キーワード+品質スコア パブリッシャー ショッピング ビデオ

Singular UIのフィールド Singular APIのフィールド Google Country Breakdownのフィールド
ディメンション
アカウントID アカウントID 顧客ID
アカウント名 アカウント名 顧客名
アプリサイトID app_site_id キャンペーン.appCampaignSetting.appId
アセットID アセットID アセットID
アセット名 アセット名 asset.name(Videoタイプのアセットには、"asset.youtubeVideoAsset.youtubeVideoTitle "を使用します。)
キャンペーンURL adn_campaign_url 広告の最終URL
利用できない場合はad.trackingUrlTemplate
国名 カントリーフィールド geographicView.countryCriterionId。
クリエイティブフォーマット クリエイティブフォーマット 広告タイプ
クリエイティブID クリエイティブID 広告グループID
クリエイティブ名 クリエイティブ名 adGroupAd.ad.name(アドグループ広告名
クリエイティブ報告URL クリエイティブ報告URL adGroupAd.ad.finalUrls.0。
日付 日付フィールド セグメント.日付
最終URL 最終URL キャンペーン.finalUrls OR
adGroupCriterion.finalUrlsまたは
広告グループ.ad.finalUrls
ネットワークキャンペーンID キャンペーンID キャンペーンID
ネットワークキャンペーン名 キャンペーン名 キャンペーン名
ネットワーククリエイティブID adn_creative_id adGroupAd.ad.id。
ネットワーククリエイティブ名 広告クリエイティブ名 adGroupAd.ad.name(アドグループ広告名
ネットワークサブキャンペーンID adn_sub_campaign_id 広告グループID
ネットワークサブキャンペーン名 広告サブキャンペーン名 広告グループ名
OS OS キャンペーン.appCampaignSetting.appStore
プラットフォーム プラットフォーム campaign.appCampaignSetting.appStoreとsegments.deviceの組み合わせ。
パブリックID site_public_id campaign.appCampaignSetting.appIdの組み合わせ
リターゲティング リテンション campaign.advertisingChannelSubType == 'APP_CAMPAIGN_FOR_ENGAGEMENT_'
サブアドネットワーク アドネットワーク セグメント.adNetworkType
ターゲット国 ターゲット国名 国を参照
テキスト クリエイティブテキスト このフィールドを作成するには、広告で利用可能なテキストフィールドを使用します。例:UACの場合、Google Adsのフィールドはasset.textAsset.textです。複数のテキスト(見出し+説明文など)がある場合は、それらを連結して1つの文字列にします。
タイムゾーン adn_timezone カスタマー.タイムゾーン
(SingularはAdwordsからクライアントのタイムゾーンで時間データを受け取り、UTCに変換します)
トラッキングURL トラッキングURL adGroupAd.ad.trackingUrlTemplate
アセットパフォーマンス
アセットパフォーマンス パフォーマンス・ラベル
指標
コスト コスト メトリクス.costMicro
ネットワークのクリック数 クリック数 クリック数
ネットワークインプレッション インプレッション インプレッション
ネットワークのインストール数 adn_installs メトリクス.コンバージョン / メトリクス.allConversions
オリジナルコスト オリジナルコスト メトリクス.costMicro
元の通貨 オリジナルの通貨 顧客.currencyCode
ビデオ再生回数 ビデオビュー メトリクス.videoViews
完了した動画視聴数 完了した動画視聴数 メトリクスvideo_quartile_p100_rate
動画視聴 - 25 動画視聴回数 - 25 指標 video_quartile_p25_rate
動画視聴 - 50% 動画ビュー数 メトリクスvideo_quartile_p50_rate
動画再生回数 - 75 動画視聴率 メトリクス.video_quartile_p75_rate

Singularはこのパートナーのキャンペーンプロパティのプルもサポートしています

特別なセットアップ方法

認証

データコネクターのセットアップに関する一般的な情報については、データコネクター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のみを提供します。