Quantcast
Channel: Google Developers Japan
Viewing all articles
Browse latest Browse all 2207

Google Ads API が Google Analytics からのコンバージョンのインポートと編集に対応

$
0
0
この記事は 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 について、次の種類の変更操作が許可されるようになりました。
  1. statusprimary_for_goalcategorynamevalue_settings を変更する update
  2. コンバージョン アクションを削除する remove
これが重要な理由
Google アナリティクスからインポートするコンバージョンは、多くの Google 広告ユーザーにとって、入札やレポートの重要な要素になっています。これまでも、Google Analytics Admin API を使って Google アナリティクスと広告アカウントをリンクすることはできました。しかし、次に示すリンクプロセスのその他の手順を、Google Ads API から完了することはできませんでした。
  • status フィールドを HIDDEN から ENABLED に変更し、GA4 プロパティのコンバージョンを Google 広告アカウントにインポートする操作。
  • インポートしたコンバージョンの primary_for_goal フィールドと category フィールドを設定し、Google 広告の入札とレポートに与える効果を指定する操作
今回の変更により、両方の操作が Google Ads API でサポートされ、API ベースのソリューションだけで Google アナリティクス 4 プロパティを Google 広告アカウントにリンクできるようになります。

適切なコンバージョン目標を設定するために必要な属性に加えて、インポートした GA4 の ConversionAction の次の属性も変更できます。
  • name
  • value_settings
インポートした GA4 の 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

Viewing all articles
Browse latest Browse all 2207

Trending Articles