P-MAX キャンペーンの最近発表された検索テーマ（ベータ版）機能を使うと、Google AI に顧客やビジネスに関する貴重な情報を提供して、P-MAX キャンペーンの配信とプレースメントをさらに最適化できます。 Google Ads API v15 以降では、API で P-MAX キャンペーンの検索テーマを作成できます。
BRAND
CustomerNegativeCriterionService
NegativeKeywordList
url_expansion_opt_out
campaign_search_term_insight
customer_search_term_insight
Google Ads API の検索テーマは AssetGroupSignal の一種で、アセット グループのレベルで P-MAX キャンペーンにアタッチできます。アセット グループに検索テーマを追加するには、 AssetGroupSignal を作成し、AssetGroupSignal.search_theme に検索テーマを表すテキスト文字列（「子ども向けアクティビティ」など）を含めた SearchThemeInfo 条件を設定します。さらに、AssetGroupSignal.asset_group にターゲットとする既存のアセット グループのリソース名を設定する必要があります。
AssetGroupSignal
AssetGroupSignal.search_theme
SearchThemeInfo
AssetGroupSignal.asset_group
次に、検索テーマ アセット グループ シグナルを作成する Java の例を示します。
// Creates a search theme asset group signal. AssetGroupSignal assetGroupSignal = AssetGroupSignal.newBuilder() .setAssetGroup(assetGroupResourceName) .setSearchTheme( SearchThemeInfo.newBuilder().setText("activities for children").build()) .build();
同じアセット グループをターゲットにして複数の AssetGroupSignal オブジェクトを作成すると、複数のアセット グループ シグナルを 1 つのアセット グループに追加することができます。ただし、1 つの AssetGroupSignal オブジェクトで表すことができるのは、1 つの検索テーマまたはオーディエンス シグナルのみです。
asset_group_signal リソースを使うと、Google 広告アカウントに存在する検索テーマを取得できます。現在のところ、パフォーマンスの指標はアセット グループ レベルで利用できますが、アセット グループ シグナル レベルでは利用できません。
asset_group_signal
次に、特定のアセット グループの検索テーマのテキストを取得する GAQL の例を示します。
SELECT asset_group_signal.search_theme.text FROM asset_group_signal WHERE asset_group.id = <Asset Group ID>
Google Ads API の v15 には、search_theme の承認に関する追加情報を含む 2 つの新しいフィールドである asset_group_signal.approval_status と asset_group_signal.disapproval_reasons も導入しています。検索テーマのテキストは、Google による承認を受ける必要があります。 asset_group_signal.approval_status フィールドには、承認ステータスに関する情報が含まれます。検索テーマのテキストが承認されない場合は、asset_group_signal.disapproval_reasons フィールドにその理由が含まれます。
search_theme
asset_group_signal.approval_status
asset_group_signal.disapproval_reasons
次に、特定のアセット グループの検索テーマのテキストとポリシー審査情報を取得する GAQL の例を示します。
SELECT asset_group_signal.search_theme.text, asset_group_signal.approval_status, asset_group_signal.disapproval_reasons FROM asset_group_signal WHERE asset_group.id = <Asset Group ID>
検索テーマのテキストが Google のポリシーに準拠していると思われるにもかかわらず承認されない場合は、ポリシー違反となった検索テーマのポリシー適用除外リクエストを送信できます。
たとえば、検索テーマに医学用語が含まれており、その用語を Google 広告のポリシーに準拠して使用していて、さらに審査を受ける正当な理由があると思われる場合は、AssetGroupSignalOperation.exempt_policy_violation_keys[] フィールドを使ってポリシーの適用除外をリクエストできます。
AssetGroupSignalOperation.exempt_policy_violation_keys[]
この記事は、皆さんから要望があった新機能や今後予定されている機能についてお伝えするシリーズの一部です。今後のアップデートや改善についてお伝えするデベロッパー ブログにご注目ください。 Google Ads API と P-MAX の連携についてのフィードバックも、引き続きお寄せください。サポートが必要な場合は、いつものようにチームにお問い合わせください。
P-MAX キャンペーンを初めて使う方は、スタートガイドで詳細をご確認ください。詳細については、アセット グループとアセット グループ シグナルのガイドをご覧ください。
