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

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

オーディエンスを作成

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

MutateAudienceResult で audience_id を確認する

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 を使用してオーディエンス広告グループ条件を追加し、ターゲット オーディエンスをターゲットに設定したり、オーディエンス シグナルを提供したりできます。AdGroupCriterion.audience で AudienceInfo 条件を使用し、AudienceInfo.audience フィールド(ad_group_criterion.audience.audience)をオーディエンスのリソース名に設定することで、広告グループ単位でターゲット オーディエンスをターゲットに設定できます。

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

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 列挙型からエラーを返します。

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
概要 リクエストされたオーディエンス セグメントが見つかりませんでした。
一般的な原因 存在しないか、アクセスできないセグメント ID を参照している。
対応方法 オーディエンスを作成または更新する前に、すべてのセグメント ID が存在し、アクセス可能であることを確認してください。
対策のヒント セグメント ID をオーディエンスに含める前に検証します。
DIMENSION_INVALID
概要 オーディエンス ディメンションが無効です。
一般的な原因 exclusion_dimension に detailed_demographic を含める。
対応方法 exclusion_dimension の除外には user_list のみを使用してください。
対策のヒント オーディエンスを作成または更新するときに、exclusion_dimension で user_list のみが使用されていることを確認してください。
DUPLICATE_AUDIENCE_SEGMENT
概要 オーディエンスに重複するセグメントが含まれています。
一般的な原因 同じセグメントを同じオーディエンスに複数回追加する。
対応方法 オーディエンスの定義から重複するセグメントを削除してください。
対策のヒント オーディエンス内のすべてのセグメントが一意であることを確認してください。
NAME_ALREADY_IN_USE
概要 このオーディエンス名はすでに使用されています。
一般的な原因 同じ名前のオーディエンスを複数作成しようとしている。
対応方法 オーディエンスを作成する際は、一意の名前を使用してください。
対策のヒント 新しいオーディエンスを作成する前に、既存のオーディエンス名を確認してください。
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
概要 オーディエンスに含まれる同じタイプのディメンションが多すぎます。
一般的な原因 1 つのオーディエンスに同じタイプの複数のディメンション(複数の年齢ディメンションなど)を含める。
対応方法 オーディエンスの定義に、各タイプのディメンションが 1 つだけ含まれていることを確認します。
対策のヒント オーディエンスの定義を確認して、重複するディメンション タイプが含まれていないことを確認してください。
TOO_MANY_SEGMENTS
概要 オーディエンスに含まれるセグメントが多すぎます。
一般的な原因 オーディエンス内のセグメント数が上限を超えている。
対応方法 オーディエンスの定義に含まれるセグメントの数を減らしてください。
対策のヒント オーディエンスあたりのセグメント数の上限については、ドキュメントをご覧ください。