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

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

オーディエンスを作成する

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

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

audience_id の MutateAudienceResult を確認する

AudienceService.MutateAudiences でオーディエンスを作成すると、各オペレーションから MutateAudienceResult が返されます。返された resource_name を解析して audience_id を取得するには、 MutateAudienceResult を確認します。また、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 AdGroupCriterion.audience AudienceInfo.audience フィールド (ad_group_criterion.audience.audience) をオーディエンス リソース名に設定します。

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

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

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

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

AdGroupCriterion を作成する

AdGroupCriterion を作成し、 AudienceInfo.audience フィールドを AdGroupCriterion.audience のリソース名 に設定します。

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

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

ベスト プラクティス

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

一般的なエラー

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