オーディエンスの作成と管理

Audience は、的を絞ったセグメント、年齢や性別によるターゲティング、除外設定の再利用可能なコレクションです。オーディエンス ターゲティングは、P-MAX、デマンド ジェネレーション、アプリ キャンペーンでサポートされています。ディスプレイ キャンペーン、検索キャンペーン、動画キャンペーン、ホテル キャンペーン、通常のショッピング キャンペーンでオーディエンス セグメントを直接ターゲットに設定する場合は、オーディエンス セグメントをご覧ください。

オーディエンスを作成

AudienceService を使用してオーディエンスを作成、更新します。各 Audience には一意の名前を付ける必要があります。この再利用可能なオーディエンスでは、複数のオーディエンス ディメンションを組み合わせることができます。

• オーディエンス セグメント
  • ユーザーリスト セグメント
  • アフィニティ セグメントまたは購買意向の強いセグメント
  • ライフイベント セグメント
  • 詳しいユーザー属性セグメント
  • カスタム オーディエンス セグメント (CustomAudienceSegment)
• 年齢: AgeDimension
• 性別: GenderDimension
• 世帯収入: HouseholdIncomeDimension
• 子供の有無: ParentalStatusDimension

audience_id の MutateAudienceResult を検査する

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

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

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

オーディエンスを取得する

他のリソースと同様に、GoogleAdsService.SearchStream を使用してオーディエンスの属性を取得できます。

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

対象者

オーディエンスは、キャンペーン タイプに応じてさまざまな方法でターゲティングできます。

アセット グループのシグナル

P-MAX キャンペーンでは、AssetGroupSignal を使用してオーディエンスをターゲットに設定します。アセット グループのシグナルを使用してオーディエンスをターゲットに設定する方法については、アセット グループのシグナルガイドをご覧ください。

広告グループの条件

デマンド ジェネレーション キャンペーンとアプリ キャンペーンでは、AdGroupCriterion を使用してオーディエンス広告グループ条件を追加し、オーディエンスをターゲットに設定したり、オーディエンス シグナルを提供したりできます。AudienceInfo.audience フィールド（ad_group_criterion.audience.audience）をオーディエンス リソース名に設定することで、AdGroupCriterion.audience の AudienceInfo 条件を使用して、広告グループ単位でオーディエンスをターゲットに設定できます。

オーディエンス ターゲティングを設定する手順は次のとおりです。

AdGroup でオーディエンス ターゲティングを有効にする

広告グループの作成時に use_audience_grouped を true に設定して、AdGroup でオーディエンス ターゲティングを有効にする必要があります。この設定は、広告グループの作成後に変更することはできません。

これにより、オーディエンスに AdGroupCriterion を追加できます。この値が true に設定されていない場合、オーディエンスをターゲットとする後続のリクエストは失敗します。

AdGroupCriterion を作成します。

AdGroupCriterion を作成し、AdGroupCriterion.audience の AudienceInfo.audience フィールドを、オーディエンスを作成するで作成したオーディエンスのリソース名に設定します。

省略可: Campaign でオーディエンス ターゲティングを有効にする

キャンペーンの作成時に、必要に応じて use_audience_grouped を true に設定できます。この設定では、キャンペーン単位でセグメントとユーザー属性を除外する条件を追加しようとすると、エラーが表示されます。

ベスト プラクティス

• オーディエンスを使用してペルソナを構築します。オーディエンスは、複数のセグメントと年齢や性別などの条件を組み合わせて特定のペルソナをターゲットに設定する場合に、P-MAX キャンペーン、デマンド ジェネレーション キャンペーン、アプリ キャンペーンで最も効果的に使用できます。
• オーディエンス セグメントを直接ターゲティングに使用します。ディスプレイ キャンペーン、検索キャンペーン、動画キャンペーン、ホテル キャンペーン、通常のショッピング キャンペーンの場合、または単一のセグメント（リマーケティング リストなど）のみをターゲットに設定する必要がある場合は、オーディエンスではなくオーディエンス セグメントを使用します。

一般的なエラー

Audience を作成または更新するときに、Google Ads API はリクエストを検証し、検証に失敗した場合は AudienceError 列挙型からエラーを返します。