条件

ターゲティング条件は、次の 3 つのレベルで設定できます。

• キャンペーン単位
• 広告グループ単位
• お客様レベル。

すべての条件タイプをすべてのレベルで設定できるわけではありません。たとえば、キャンペーン レベルでのみ設定できる条件タイプもあります。また、一部の条件はターゲット除外にのみ使用でき、一部の条件は追加ターゲティングにのみ使用できます。

レベル別にサポートされている条件

次の表に、すべての条件タイプで使用できる演算子を示します。

バージョンの違い

サポートされている Google Ads API のバージョンによって、条件タイプと検証動作が異なります。

• v26 以降:
  • CampaignCriterion と AdGroupCriterion で require_eu_political_advertising_declaration をサポートし、条件にキャンペーン単位の EU の政治広告の申告が必要かどうかを判断します。
  • AdGroupBidModifier で業種に依存しない旅行ディメンションを使用し、CriterionError で業種に依存しないエラー理由を使用します（v25 以前のホテル固有の条件とエラーコードを置き換えます）。
• v25 以降: AdGroupCriterion で VERTICAL_ADS_ITEM_BID 条件タイプを使用して EntityBid（entity_bid）条件をサポートし、バーティカル広告の旅行エンティティに商品アイテム単位の入札単価を設定します。
• v24 以降:
  • タグベースの商品フィルタリング（許可リストに登録されたアカウントのみ）で RetailFilterBundle（AdGroupCriterion.retail_filter_bundle と AssetGroupListingGroupFilter.Dimension.retail_filter_bundle）と RetailFilter（SharedCriterion.retail_filter）をサポートします。
  • SharedCriterion の VerticalAdsItemGroupRuleInfo で user_rating、venue、event_participant_display_name のルール ディメンションをサポートします。
  • P-MAX のアセット グループ シグナルで AssetGroupSignal.local_services_id と AssetGroupSignal.vertical_ads_item_group_rule_list（許可リストに登録済み）をサポートします。
  • ユーザー属性ディメンション（AgeRangeInfo、GenderInfo、IncomeRangeInfo、ParentalStatusInfo）内のすべてのターゲットを除外しようとすると、CriterionError.CANNOT_EXCLUDE_ALL_TARGETS が返されます。
  • 許可されていない言語をターゲットに設定しようとすると、CriterionError.CANNOT_TARGET_LANGUAGE を返します。
  • ローカル サービス P-MAX キャンペーンからすべての地域を削除しようとすると、CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN が返されます。

オーディエンス情報のターゲティング条件

AdGroupCriterion.audience の AudienceInfo 条件を使用して、広告グループ単位でターゲット オーディエンスをターゲットに設定できます。ad_group_criterion.audience.audience を、ターゲットとする Audience のリソース名に設定します。AdGroupCriterion で AudienceInfo 条件を使用するには、広告グループの作成時に ad_group.audience_setting.use_audience_grouped = true を設定する必要があります（この設定は作成後に変更できません）。必要に応じて、キャンペーンの作成時に campaign.audience_setting.use_audience_grouped = true を設定して、キャンペーン単位でセグメントと年齢や性別の除外を防止することもできます。

MutateAudienceResult を検査する

AudienceService.MutateAudiences を使用してオーディエンスを作成すると、各オペレーションは MutateAudienceResult を返します。MutateAudienceResult を検査して、返された resource_name を解析することで audience_id を取得できます。また、response_content_type が MUTABLE_RESOURCE に設定されている場合は、返された audience オブジェクトの可変フィールド（name など）を検査できます。

# Inspect MutateAudienceResult to get audience_id.
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

ターゲット言語のターゲティング条件

キャンペーン単位（CampaignCriterion.language）または広告グループ単位（AdGroupCriterion.language）で LanguageInfo 条件を使用してターゲット言語をポジティブ ターゲティングするには、language_constant をターゲット設定可能な LanguageConstant リソース名（languageConstants/{criterion_id} の形式。サポートされている言語コードを参照）に設定します。v24 以降では、許可されていない言語またはターゲットに設定できない言語をターゲットに設定しようとすると、CriterionError.CANNOT_TARGET_LANGUAGE が返されます。

LanguageInfo のサポートは、キャンペーン タイプによって異なります。

• サポートされているキャンペーン タイプ: ディスプレイ、動画、P-MAX（キャンペーン単位、検索チャネル以外のチャネルに適用）、アプリ キャンペーン（キャンペーン単位）、デマンド ジェネレーション キャンペーン（デフォルトでは広告グループ単位、DemandGenCampaignSettings.upgraded_targeting によってはキャンペーン単位）など、対象となるキャンペーン タイプでターゲット言語をターゲットに設定できます。
• 検索キャンペーン（AdvertisingChannelType.SEARCH）、検索キャンペーン向け AI 最大化設定、Google 検索の P-MAX 広告: 手動の言語ターゲティングはサポートされていません。代わりに、Google 検索に表示される広告は、広告クリエイティブとランディング ページの言語、およびユーザーの言語設定に基づいて、ユーザーに自動的にマッチングされます。
  • 条件の作成または更新: 検索キャンペーンで LanguageInfo 条件を作成または更新しようとすると、ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT エラーが発生します。
  • 以前の条件のクエリと削除: 検索キャンペーンの既存の CampaignCriterion.language 条件は、広告配信に使用されていなくても、クエリ レスポンスで返されます。Google 広告の管理画面には、検索キャンペーンのターゲット言語フィールドはありませんが、CampaignCriterionService を使用して以前の CampaignCriterion.language 条件を削除できます。