この記事は Josh Radcliff による Google Ads Blog の記事 "Google Ads API support for importing and editing conversions from Google Analytics"を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。
変更点
2023 年 10 月 9 日以降、Google Ads API で、Google アナリティクス 4(GA4)プロパティからインポートした ConversionAction について、次の種類の変更操作が許可されるようになりました。
Google アナリティクスからインポートするコンバージョンは、多くの Google 広告ユーザーにとって、入札やレポートの重要な要素になっています。これまでも、Google Analytics Admin API を使って Google アナリティクスと広告アカウントをリンクすることはできました。しかし、次に示すリンクプロセスのその他の手順を、Google Ads API から完了することはできませんでした。
適切なコンバージョン目標を設定するために必要な属性に加えて、インポートした GA4 の
対応が必要になる点
Google Ads API の連携コードにおいて、インポートした GA4 コンバージョンを
また、UI を使って Google アナリティクスを Google 広告アカウントにリンクしている場合は、API ベースのソリューションに切り替えることが適切かどうかを検討してください。
サポートの利用方法
ご質問やサポートが必要なことがありましたら、Google Ads API サポートページでオプションをご確認ください。
Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team
変更点
2023 年 10 月 9 日以降、Google Ads API で、Google アナリティクス 4(GA4)プロパティからインポートした ConversionAction について、次の種類の変更操作が許可されるようになりました。
status
、primary_for_goal
、category
、name
、value_settings
を変更するupdate
- コンバージョン アクションを削除する
remove
Google アナリティクスからインポートするコンバージョンは、多くの Google 広告ユーザーにとって、入札やレポートの重要な要素になっています。これまでも、Google Analytics Admin API を使って Google アナリティクスと広告アカウントをリンクすることはできました。しかし、次に示すリンクプロセスのその他の手順を、Google Ads API から完了することはできませんでした。
status
フィールドをHIDDEN
からENABLED
に変更し、GA4 プロパティのコンバージョンを Google 広告アカウントにインポートする操作。- インポートしたコンバージョンの
primary_for_goal
フィールドとcategory
フィールドを設定し、Google 広告の入札とレポートに与える効果を指定する操作。
適切なコンバージョン目標を設定するために必要な属性に加えて、インポートした GA4 の
ConversionAction
の次の属性も変更できます。name
value_settings
ConversionAction
のその他の属性を変更するリクエストは、今後も失敗します。また、ユニバーサル アナリティクス(UA)プロパティからインポートした ConversionAction
を remove
または update
するリクエストも同様です。対応が必要になる点
Google Ads API の連携コードにおいて、インポートした GA4 コンバージョンを
update
または remove
しようとしたときに、ConversionActionOperation
が MUTATE_NOT_ALLOWED
エラーで拒否されることを前提としている場合は、変更してください。たとえば、コンバージョン アクションがインポートした GA4 コンバージョンであるかどうかを検出するためにこの動作を利用している場合は、ConversionAction
の type
が GOOGLE_ANALYTICS_4_CUSTOM
か GOOGLE_ANALYTICS_4_PURCHASE
であることを確認するように変更します。また、UI を使って Google アナリティクスを Google 広告アカウントにリンクしている場合は、API ベースのソリューションに切り替えることが適切かどうかを検討してください。
サポートの利用方法
ご質問やサポートが必要なことがありましたら、Google Ads API サポートページでオプションをご確認ください。
Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team