- JSON 表現
- AudienceStatus
- AudienceDimension
- AgeDimension
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment
- AudienceScope
オーディエンスは効果的なターゲティング オプションです。詳しいユーザー属性やアフィニティなどのセグメント属性を組み合わせて、ターゲット セグメントの各セクションを表すオーディエンスを作成できます。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
変更不可。オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。
|
id |
出力のみ。オーディエンスの ID。 |
status |
出力のみ。このオーディエンスのステータス。オーディエンスが有効か削除されているかを示します。 |
description |
このオーディエンスの説明。 |
dimensions[] |
オーディエンスの構成を指定する正のディメンション。 |
exclusionDimension |
オーディエンスの構成を指定する除外ディメンション。 |
scope |
このオーディエンスを使用できるスコープを定義します。デフォルトのスコープは「お客様」です。ASSET_GROUP のスコープを指定してオーディエンスを作成し、1 つの assetGroup のみで使用できます。スコープは ASSET_GROUP から CUSTOMER に変更できますが、CUSTOMER から ASSET_GROUP に変更することはできません。 |
assetGroup |
変更不可。このオーディエンスの対象となるアセット グループです。スコープが ASSET_GROUP の場合にのみ設定する必要があります。作成後は変更できません。ASSET_GROUP のスコープが設定されたオーディエンスを CUSTOMER スコープにアップグレードすると、このフィールドは自動的に消去されます。 |
name |
オーディエンスの名前。アカウント内のすべてのオーディエンスに対して一意である必要があります。長さは 1 ~ 255 文字にする必要があります。スコープが設定されていないか、CUSTOMER に設定されている場合は必須です。スコープが ASSET_GROUP の場合、設定または更新できません。 |
AudienceStatus
オーディエンスのステータス タイプを含む列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
有効ステータス - オーディエンスが有効になっており、ターゲットに設定できます。 |
REMOVED |
削除済みステータス - オーディエンスは削除されており、ターゲティングに使用できません。 |
AudienceDimension
ユーザーのオーディエンスを指定する正のディメンション。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド dimension 。オーディエンスに属するユーザーを指定するディメンション。dimension は次のいずれかになります。 |
|
age |
年齢でユーザーを指定するディメンション。 |
gender |
性別でユーザーを指定するディメンション。 |
householdIncome |
世帯収入でユーザーを指定するディメンション。 |
parentalStatus |
子供の有無によってユーザーを指定するディメンション。 |
audienceSegments |
他のオーディエンス セグメントのメンバーによってユーザーを指定するディメンション。 |
AgeDimension
年齢でユーザーを指定するディメンション。
JSON 表現 |
---|
{
"ageRanges": [
{
object ( |
フィールド | |
---|---|
ageRanges[] |
ディメンションに含められる連続する年齢層。 |
includeUndetermined |
年齢が不明なユーザーを含めます。 |
AgeSegment
連続する年齢層。
JSON 表現 |
---|
{ "minAge": integer, "maxAge": integer } |
フィールド | |
---|---|
minAge |
含める必要がある年齢の下限。年齢の下限は 18 歳以上で指定してください。指定できる値は 18、25、35、45、55、65 です。 |
maxAge |
含める必要がある年齢の上限。最長年齢を指定する必要はありません。指定する場合、maxAge は minAge より大きくする必要があります。指定できる値は 24、34、44、54、64 です。 |
GenderDimension
性別でユーザーを指定するディメンション。
JSON 表現 |
---|
{
"genders": [
enum ( |
フィールド | |
---|---|
genders[] |
性別のユーザー属性セグメントを含めました。 |
includeUndetermined |
性別が特定されていないユーザーを含めます。 |
HouseholdIncomeDimension
世帯収入でユーザーを指定するディメンション。
JSON 表現 |
---|
{
"incomeRanges": [
enum ( |
フィールド | |
---|---|
incomeRanges[] |
世帯収入によるユーザー属性セグメントを含めました。 |
includeUndetermined |
世帯収入が不明なユーザーを含めます。 |
ParentalStatusDimension
子供の有無によってユーザーを指定するディメンション。
JSON 表現 |
---|
{
"parentalStatuses": [
enum ( |
フィールド | |
---|---|
parentalStatuses[] |
子供の有無のユーザー属性セグメントが追加されました。 |
includeUndetermined |
子供の有無が不明なユーザーを含めます。 |
AudienceSegmentDimension
他のオーディエンス セグメントのメンバーによってユーザーを指定するディメンション。
JSON 表現 |
---|
{
"segments": [
{
object ( |
フィールド | |
---|---|
segments[] |
オーディエンス セグメントが含まれています。1 つ以上のセグメントに属しているユーザーは含まれます。 |
AudienceSegment
有望なオーディエンス セグメントです。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド segment 。陽性セグメント。segment は次のいずれかになります。 |
|
userList |
ユーザーリスト セグメント。 |
userInterest |
アフィニティ セグメントまたは購買意向の強いセグメント。 |
lifeEvent |
ライブイベントのオーディエンス セグメント。 |
detailedDemographic |
詳しいユーザー属性セグメント。 |
customAudience |
カスタム オーディエンス セグメントです。 |
UserListSegment
ユーザーリスト セグメント。類似ユーザー機能は 2023 年 5 月に廃止されます。その他のオプションについては、https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html をご覧ください。
JSON 表現 |
---|
{ "userList": string } |
フィールド | |
---|---|
userList |
ユーザーリストのリソース。 |
UserInterestSegment
ユーザーの興味 / 関心セグメント。
JSON 表現 |
---|
{ "userInterestCategory": string } |
フィールド | |
---|---|
userInterestCategory |
ユーザーの興味 / 関心のリソース。 |
LifeEventSegment
ライブイベントのセグメント。
JSON 表現 |
---|
{ "lifeEvent": string } |
フィールド | |
---|---|
lifeEvent |
ライフイベント リソース。 |
DetailedDemographicSegment
詳しいユーザー属性セグメント。
JSON 表現 |
---|
{ "detailedDemographic": string } |
フィールド | |
---|---|
detailedDemographic |
詳しいユーザー属性リソース。 |
CustomAudienceSegment
カスタム オーディエンス セグメントです。
JSON 表現 |
---|
{ "customAudience": string } |
フィールド | |
---|---|
customAudience |
カスタム オーディエンス リソース。 |
AudienceExclusionDimension
オーディエンスから除外するユーザーを指定する除外ディメンション。
JSON 表現 |
---|
{
"exclusions": [
{
object ( |
フィールド | |
---|---|
exclusions[] |
除外するオーディエンス セグメント。 |
ExclusionSegment
オーディエンスから除外するオーディエンス セグメント。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド segment 。除外するセグメント。segment は次のいずれかになります。 |
|
userList |
除外するユーザーリスト セグメント。 |
AudienceScope
オーディエンス スコープの有効な値を含む列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
範囲が指定されていません。 |
UNKNOWN |
受け取った値はこのバージョンでは不明です。 |
CUSTOMER |
オーディエンスはお客様レベルを対象とします。 |
ASSET_GROUP |
オーディエンスは、特定の AssetGroup を対象とします。 |