はじめに

Google Adwords APIは2020年を目処に廃止されるとの予定でしたが、
Google Ads APIの正式ローンチが大幅に遅れているらしく今年中に廃止されることはないらしいです。
https://developer.feedforce.jp/entry/2019/05/15/131054

Google Ads APIドキュメントもまだ未公開で閲覧できないため、
Google Adwords APIでコンバージョンデータをGoogleAdsにインポートする方法を試してみました。

全体の流れ

公式ドキュメント(広告のクリックを経由したコンバージョンのデータを Google 広告にインポートする)に記載されている内容をまとめると大きく3つ。

広告のURLに追加されるGCLID（Google クリック ID）付与の設定
コンバージョンアクションの設定
GoogleAdsへコンバージョンデータのインポート

広告のURLに追加されるGCLID（GoogleクリックID）付与の設定

コンバージョンデータとの関連が必要なのでgclidは独自システムなどで保持する必要があります。

gclidをDBに保存するための変更作業
フロントエンド側からgclidの取得およびDBへ保存

コンバージョンアクション設定(GoogleAdsUI)

オフラインコンバージョンのトラッキングを設定する

※コンバージョンアクションはAPIからも設定可能ですが、今回はコンバージョンデータの定期インポートを想定しているので管理画面から設定しています。

GoogleAdsへコンバージョンデータのインポート

インポート方法は大きく3種類

HTTPS/SFTP による定期取得
スプレッドシートを利用した定期取得
AdWords API による自動送信

今回はAdWordsAPIを使ったAPI実装を行います。

公式ドキュメントに記載されている内容を少々変更。


require 'adwords_api'

class UploadOfflineConversion
  def initialize
    @adwords = AdwordsApi::Api.new
  end

  def create_conversion_feed(conversion_name:, google_click_id:, conversion_time:, conversion_value:)
    upload_offline_conversions(conversion_name, google_click_id, conversion_time, conversion_value.to_f)

  rescue AdsCommon::Errors::OAuth2VerificationRequired => e
    puts "Authorization credentials are not valid. Edit adwords_api.yml for OAuth2 client ID and secret and run misc/setup_oauth2.rb example to retrieve and store OAuth2 tokens."
    puts "See this wiki page for more details:\n\n https://github.com/googleads/google-api-ads-ruby/wiki/OAuth2"

  rescue AdsCommon::Errors::HttpError => e
    puts "HTTP Error: %s" % e

  rescue AdwordsApi::Errors::ApiException => e
    puts "Message: %s" % e.message
    puts 'Errors:'
    e.errors.each_with_index do |error, index|
      puts "\tError [%d]:" % (index + 1)
      error.each do |field, value|
        puts "\t\t%s: %s" % [field, value]
      end
    end
  end

  def upload_offline_conversions(conversion_name, google_click_id, conversion_time, conversion_value.to_f)
    conversion_feed_srv = @adwords.service(:OfflineConversionFeedService, :v201809)

    feed = {
      conversion_name: conversion_name,
      google_click_id: google_click_id,
      conversion_time: conversion_time,
      conversion_value: conversion_value
    }

    return_feeds = conversion_feed_srv.mutate([ { operator: 'ADD', operand: feed } ])
    return_feeds[:value].each do |return_feed|
      puts ("Uploaded offline conversion value %.2f for Google Click ID '%s', " + 'to %s') % [return_feed[:conversion_value], return_feed[:google_click_id], return_feed[:conversion_name]]
    end
  end

最低限必要なのは以下4項目。

conversion_name: コンバージョンアクションで設定した名称
google_click_id: URLに付与されるgclid
conversion_time: コンバージョン時間
conversion_value: 独自の値(値段 or 数量 or etc)

Uploading offline conversions
OfflineConversionFeedServiceは以下のオブジェクトを保持しています。

operand: OfflineConversionFeed
operator: OfflineConversionFeedOperation
return_feeds: OfflineCallConversionFeedReturnValue

インポートされたデータの反映までは3時間かかるみたいです。

バリデーション

OfflineCallConversionFeedServiceのAPIエラー(一覧)は数多くありますが、実装中に実際に遭遇したエラーだけ記載しようと思います。

INVALID_STRING_DATE_TIME

The string date time’s format should be yyyymmdd hhmmss [tz].

conversion_timeは:の除外とタイムゾーンを含めた文字列にする。

EXPIRED_CLICK

This click is either too old to be imported or occurred before the conversion window for the specified combination of conversion date and conversion name (default is 90 days).

コンバージョンアクションで設定した有効期限日数より以前のコンバージョン(conversion_time)はインポートできない。

UNPARSEABLE_GCLID

This google click ID could not be decoded.

実際に発行されたgclid以外は無効。

TOO_RECENT_CONVERSION_TYPE

This conversion action was created too recently. Please wait for 4 hours and try uploading again.

管理画面で作成したコンバージョンアクションを作成してから4時間経ってからやり直す。

INVALID_CONVERSION_TYPE

This customer does not have an import conversion with a name that matches the label of this conversion.

指定したコンバージョンアクションが登録されてない。
Google広告 > ツール > コンバージョン > コンバージョンアクションの一覧で
ソース項目がクリックからのインポートが対象。(既存のコンバージョンアクション(ソースがウェブサイト)を指定してもうまく行かず詰まりました..)

CONVERSION_PRECEDES_CLICK

This conversion is reported to have happened before the click.

コンバージョン時間 > 広告クリック時間の場合に発生。
なんでこの状況が起こるかわからないが計測側の問題なのかもしれない..?

ATTRIBUTED_CREDIT_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION

This conversion action is using an external attribution model, but the attributed credit is not set.

コンバージョンアクションのアトリビューションモデルを外部のアトリビューションを使用を選択したため、external_attribution_creditに貢献値の指定が必要。

ATTRIBUTION_MODEL_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION

This conversion action is using an external attribution model, but the attribution model name is not set.

コンバージョンアクションのアトリビューションモデルを外部のアトリビューションを使用を選択したため、external_attribution_modelにモデル名の指定が必要。

広告のクリックを経由したコンバージョンデータをGoogle広告にインポートする