Q1: 複数の Google 広告アカウントへコンバージョンをアップロードするにはどうすればよいですか？
以下の2つの方式が主に選択できます。
- URL パラメータ方式
広告のリンク先に?ga_acc=XXXXのような固有パラメータを付与し、サブスクラインからのポストバック通知時に{referer.ga_acc}を参照してアカウント ID を切り替えます。 - MCC 一括アップロード方式
マネージャーアカウント（MCC）の ID をlogin-customer-idヘッダーに設定し、子口座にまとめてアップロードします。Cross-Account Conversion Tracking を採用している場合に便利です。
POINTどちらの方式でも同一の Developer-Token と OAuth2 アクセストークン（scope: https://www.googleapis.com/auth/adwords）が利用できます。
Q2: 重複送信を防ぐにはどうすればよいですか？以下のポイントを守ることで、重複送信を回避できます。
- 固有パラメータを必ず付与
例：https://subscline.com/?ga_acc=1234567890
このように広告ごとにga_accを付与し、サブスクラインのポストバック時に{referer.ga_acc}の存在をトリガーに設定します。 - 存在判定でリクエストを制御
トリガー条件として「ga_accが存在する場合のみ送信」を設定し、不一致時にはリクエストを送らない設計にします。
POINT
partial_failure パラメータ（
partial_failure パラメータ（
?partial_failure=true）を付けてアップロードすれば、一部のコンバージョンが失敗しても残りは正常に処理されます。Q3: 同一 gclid を 2 回送った場合、どうなりますか？
すでにコンバージョンが登録済みの場合は
CLICK_ALREADY_EXISTS エラーが返され、2 回目の送信は無視されます。ただし partial_failure=true であれば他のコンバージョンには影響しませんのでご安心ください。
Q4: 1 つの Developer-Token で複数口座を運用できますか？
可能です。ヘッダーの
login-customer-id や Authorization: Bearer ... を切り替えるだけで、同一の Developer-Token を使って複数アカウントにアップロードできます。Q5: Service Account を使って認証はできますか？
はい、Google Ads API は OAuth2 の Service Account フローにも対応しているため、サーバー間でのトークン発行が可能です。
Q6: API バージョンの更新タイミングはいつですか？
Google Ads API は数か月ごとに新機能リリースが行われます。
最新（2025年5月時点）では v19 が公開中です。都度バージョンの更新アナウンスがありますので、公式ドキュメントや Google Ads API リリースノートを確認しましょう。
導入の流れを簡単におさらい
Tips
- Google広告側で インポート用コンバージョン アクション を用意
- Developer-Token が承認済みか確認
- サブスクラインの「ポストバック通知」にエンドポイントを登録し、トリガー条件に ga_acc の存在判定 を追加(後述の例を参考)
- テストクリックで登録の正否を検証
- MCC 利用時は子口座を クロスアカウント コンバージョントラッキング に切り替えて管理
例：
https://api.subscline.jp/api/v1/client/##CLIENT_ID##/postback/post
?header={
“developer-token”:”##DEV_TOKEN##”,
“Authorization”:”Bearer ##ACCESS_TOKEN##”,
“content-type”:”application/json”,
“login-customer-id”:”{referer.ga_mcc?}” <–※MCCを使わない場合は省略
}
&body={
“conversions”:[
{
“gclid”:”{referer.gclid}”,
“conversion_action”:”customers/{referer.ga_acc}/conversionActions/##ACTION_ID##”,
“conversion_date_time”:”{{format now \”yyyy-MM-dd HH:mm:ssXXX\”}}”,
“currency_code”:”JPY”,
“conversion_value”:”100″
}
],
“partial_failure”:true,
“validate_only”:false
}
&url=https://googleads.googleapis.com/v19/customers/{referer.ga_acc}:uploadClickConversions
?header={
“developer-token”:”##DEV_TOKEN##”,
“Authorization”:”Bearer ##ACCESS_TOKEN##”,
“content-type”:”application/json”,
“login-customer-id”:”{referer.ga_mcc?}” <–※MCCを使わない場合は省略
}
&body={
“conversions”:[
{
“gclid”:”{referer.gclid}”,
“conversion_action”:”customers/{referer.ga_acc}/conversionActions/##ACTION_ID##”,
“conversion_date_time”:”{{format now \”yyyy-MM-dd HH:mm:ssXXX\”}}”,
“currency_code”:”JPY”,
“conversion_value”:”100″
}
],
“partial_failure”:true,
“validate_only”:false
}
&url=https://googleads.googleapis.com/v19/customers/{referer.ga_acc}:uploadClickConversions
コメント