条件

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

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

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

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

次の表に、すべての条件タイプの使用が許可されているかどうかを示します。

バージョンの違い

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

• v25 以降: AdGroupCriterion の EntityBid（entity_bid）条件をサポートし、条件タイプ VERTICAL_ADS_ITEM_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 を設定して、キャンペーン単位でのセグメントとユーザー属性の除外を防止することもできます。

audience_id の 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}")