REST Resource: firstPartyAndPartnerAudiences

リソース: FirstPartyAndPartnerAudience

ターゲティングに使用されるファーストパーティ オーディエンス リストまたはパートナー オーディエンス リスト。ファーストパーティ オーディエンスは、クライアント データを使用して作成されます。パートナー オーディエンスはサードパーティのデータ プロバイダから提供され、お客様にのみライセンスを付与できます。

JSON 表現 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
フィールド
name

string

出力専用。ファーストパーティ オーディエンスとパートナー オーディエンスのリソース名。
firstPartyAndPartnerAudienceId

string (int64 format)

ID。ファーストパーティ オーディエンスとパートナー オーディエンスの一意の ID。システムによって割り当てられます。
displayName

string

省略可。ファーストパーティ オーディエンスとパートナー オーディエンスの表示名。
description

string

省略可。ユーザーが指定したオーディエンスの説明。

ファースト パーティ オーディエンスにのみ適用されます。
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

出力専用。オーディエンスがファーストパーティ オーディエンスとパートナー オーディエンスかどうか。
audienceType

enum (AudienceType)

変更不可。オーディエンスのタイプ。
audienceSource

enum (AudienceSource)

出力専用。オーディエンスのソース。
membershipDurationDays

string (int64 format)

省略可。対象となるイベントが発生した後、エントリがオーディエンスに留まる日数。設定値は 0 より大きく、540 以下にする必要があります。

ファースト パーティ オーディエンスにのみ適用されます。

次のいずれかの audienceType が使用されている場合、このフィールドは必須です。

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

出力専用。ディスプレイ ネットワークの推定オーディエンス サイズ。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

GET リクエストでのみ返されます。
activeDisplayAudienceSize

string (int64 format)

出力専用。過去 1 か月間のディスプレイ ネットワークの推定オーディエンス サイズ。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

GET リクエストでのみ返されます。
youtubeAudienceSize

string (int64 format)

出力専用。YouTube ネットワークの推定ユーザーの規模。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

ファースト パーティ オーディエンスにのみ適用されます。

GET リクエストでのみ返されます。
gmailAudienceSize

string (int64 format)

出力専用。Gmail ネットワークの推定オーディエンス サイズ。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

ファースト パーティ オーディエンスにのみ適用されます。

GET リクエストでのみ返されます。
displayMobileAppAudienceSize

string (int64 format)

出力専用。ディスプレイ ネットワークにおけるモバイルアプリのユーザーの規模の推定値。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

ファースト パーティ オーディエンスにのみ適用されます。

GET リクエストでのみ返されます。
displayMobileWebAudienceSize

string (int64 format)

出力専用。ディスプレイ ネットワークにおけるモバイルウェブの推定ユーザーの規模。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

ファースト パーティ オーディエンスにのみ適用されます。

GET リクエストでのみ返されます。
displayDesktopAudienceSize

string (int64 format)

出力専用。ディスプレイ ネットワークにおけるパソコンの推定オーディエンス サイズ。

サイズが 1, 000 未満の場合、プライバシー上の理由から、数値は非表示になり、0 が返されます。それ以外の場合、数値は有効数字 2 桁に丸められます。

ファースト パーティ オーディエンスにのみ適用されます。

GET リクエストでのみ返されます。
appId

string

省略可。appId が、アップロードされる mobileDeviceIds のタイプと一致している。

audienceType CUSTOMER_MATCH_DEVICE_ID にのみ適用

FirstPartyAndPartnerAudienceType

ファーストパーティ オーディエンス リソースとパートナー オーディエンス リソースの指定可能なタイプ。

列挙型
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED タイプが指定されていないか不明な場合のデフォルト値。
TYPE_FIRST_PARTY クライアント データを使用して作成されたオーディエンス。
TYPE_PARTNER 第三者データ プロバイダから提供されるオーディエンス。

AudienceType

オーディエンスのタイプ。

列挙型
AUDIENCE_TYPE_UNSPECIFIED タイプが指定されていないか不明な場合のデフォルト値。
CUSTOMER_MATCH_CONTACT_INFO オーディエンスは、既知の連絡先情報と顧客を照合して生成されました。
CUSTOMER_MATCH_DEVICE_ID オーディエンスは、既知のモバイル デバイス ID と顧客を照合して生成されました。
CUSTOMER_MATCH_USER_ID オーディエンスは、既知のユーザー ID とお客様を照合して生成されました。
ACTIVITY_BASED

非推奨: オーディエンスはキャンペーン アクティビティに基づいて作成されました。
FREQUENCY_CAP

サポート終了: オーディエンスは、配信されたインプレッション数を除外して作成されました。
TAG_BASED オーディエンスは、ピクセルに関連付けられたカスタム変数に基づいて作成されました。
YOUTUBE_USERS 動画、YouTube 広告、YouTube チャンネルに対する過去の操作に基づいて作成されたオーディエンス。
THIRD_PARTY オーディエンスは、第三者から使用許可を得ています。
COMMERCE コマース パートナーが有料で提供するオーディエンス。
LINEAR 地上波 TV コンテンツの視聴者。
AGENCY 代理店が提供するオーディエンス。

AudienceSource

オーディエンス ソース。

列挙型
AUDIENCE_SOURCE_UNSPECIFIED オーディエンス ソースが指定されていないか不明な場合のデフォルト値。
DISPLAY_VIDEO_360 ディスプレイ＆ビデオ 360 から発生した。
CAMPAIGN_MANAGER キャンペーン マネージャー 360 から送信された。
AD_MANAGER Google アド マネージャーから送信された。
SEARCH_ADS_360 検索広告 360 から送信された。
YOUTUBE YouTube から発生。
ADS_DATA_HUB Ads Data Hub から取得。

メソッド

get

 自社オーディエンスまたはパートナー オーディエンスを取得します。

list

 ファーストパーティ オーディエンスとパートナー オーディエンスを一覧表示します。