オーディエンス ターゲティング

デマンド ジェネレーション キャンペーンには、他のキャンペーン タイプではサポートされていない独自のオーディエンス ターゲティング機能があります。

たとえば、類似オーディエンス セグメントを使用して、既存の顧客と特徴が似ているユーザーをターゲットに設定できます。類似セグメントについて詳しくは、ヘルプセンター記事の類似セグメントを使用してオーディエンスを増やすをご覧ください。

また、AdGroupCriterion を使用して、広告グループレベルでオーディエンス ターゲティングを構成することもできます。

AudienceInfo 個のターゲティング条件

デマンド ジェネレーション広告グループでオーディエンスをターゲットに設定する手順は次のとおりです。

  1. ターゲット AdGroup を作成するときに、audience_setting.use_audience_grouped を true に設定します(この設定は、広告グループの作成後に変更できません)。キャンペーンの作成時に campaign.audience_setting.use_audience_grouped を true に設定して、キャンペーン単位でのセグメントとユーザー属性の除外を防止することもできます。
  2. AudienceService を使用して Audience リソースを作成または取得し、そのリソース名または ID を取得します。
  3. audience フィールドがオーディエンスのリソース名に設定されている AudienceInfo 条件を含む AdGroupCriterion を作成します。

MutateAudienceResult を確認して AudienceInfo を添付する

AudienceService.MutateAudiences を使用してオーディエンスを作成すると、各オペレーションは MutateAudienceResult を返します。返された resource_name を解析して audience_id を取得できます。また、response_content_type が MUTABLE_RESOURCE に設定されている場合は、返された audience オブジェクトの可変フィールド(name など)を検査できます。次に、audience_setting.use_audience_grouped を true に設定して作成した AdGroup の AdGroupCriterion に resource_name を割り当て、AdGroupCriterionService.MutateAdGroupCriteria に渡される AdGroupCriterionOperation で AdGroupCriterion をラップします。

# Step 1: Inspect MutateAudienceResult to get resource_name and 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 with resource_name '{resource_name}' "
        f"and audience_id '{audience_id}'."
    )

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

    # Step 2: Target the audience at the ad group level with AdGroupCriterion.
    # The target AdGroup must have audience_setting.use_audience_grouped = True
    # set when the ad group is created.
    ad_group_criterion_operation = client.get_type("AdGroupCriterionOperation")
    ad_group_criterion = ad_group_criterion_operation.create
    ad_group_criterion.ad_group = ad_group_resource_name
    ad_group_criterion.audience.audience = resource_name

    ad_group_criterion_service = client.get_service("AdGroupCriterionService")
    ad_group_criterion_service.mutate_ad_group_criteria(
        customer_id=customer_id,
        operations=[ad_group_criterion_operation],
    )