- リソース: FirstPartyAndPartnerAudience
- FirstPartyAndPartnerAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- 同意
- ConsentStatus
- MobileDeviceIdList
- メソッド
リソース: FirstPartyAndPartnerAudience
ターゲティングに使用されるファーストパーティまたはパートナーのオーディエンス リストを記述します。ファーストパーティ オーディエンスは、クライアント データを使用して作成されます。パートナー オーディエンスは第三者データ提供元から提供され、お客様にのみライセンスを提供できます。
JSON 表現 |
---|
{ "name": string, "firstPartyAndPartnerAudienceId": string, "displayName": string, "description": string, "firstPartyAndPartnerAudienceType": enum ( |
フィールド | |
---|---|
name |
出力専用。ファースト パーティ オーディエンスとパートナー オーディエンスのリソース名。 |
firstPartyAndPartnerAudienceId |
ID。ファーストパーティ オーディエンスとパートナー オーディエンスの一意の ID。システムによって割り当てられます。 |
displayName |
出力専用。ファーストパーティ オーディエンスとパートナー オーディエンスの表示名。 |
description |
出力専用。ユーザーが指定したオーディエンスの説明。 自社オーディエンスにのみ適用されます。 |
firstPartyAndPartnerAudienceType |
出力専用。オーディエンスがファーストパーティ オーディエンスかパートナー オーディエンスか。 |
audienceType |
出力専用。オーディエンスのタイプ。 |
audienceSource |
出力専用。オーディエンスのソース。 |
membershipDurationDays |
出力専用。エントリが有効なイベントの後にオーディエンスに残る日数。オーディエンスに有効期限がない場合は、このフィールドの値を 10000 に設定します。それ以外の場合は、設定値は 0 より大きく、540 以下でなければなりません。 自社オーディエンスにのみ適用されます。 次のいずれかの
|
displayAudienceSize |
出力専用。ディスプレイ ネットワークの推定オーディエンス数。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 GET リクエストでのみ返されます。 |
activeDisplayAudienceSize |
出力専用。過去 1 か月間のディスプレイ ネットワークのオーディエンスの推定規模。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 GET リクエストでのみ返されます。 |
youtubeAudienceSize |
出力専用。YouTube ネットワークの推定オーディエンス数。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 自社オーディエンスにのみ適用されます。 GET リクエストでのみ返されます。 |
gmailAudienceSize |
出力専用。Gmail ネットワークのオーディエンスの推定規模。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 自社オーディエンスにのみ適用されます。 GET リクエストでのみ返されます。 |
displayMobileAppAudienceSize |
出力専用。ディスプレイ ネットワークにおけるモバイルアプリのオーディエンスの推定規模。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 自社オーディエンスにのみ適用されます。 GET リクエストでのみ返されます。 |
displayMobileWebAudienceSize |
出力専用。ディスプレイ ネットワークにおけるモバイルウェブのオーディエンスの推定規模。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 自社オーディエンスにのみ適用されます。 GET リクエストでのみ返されます。 |
displayDesktopAudienceSize |
出力専用。ディスプレイ ネットワークにおけるパソコンのオーディエンスの推定規模。 サイズが 1, 000 未満の場合、プライバシー上の理由から数値は非表示になり、0 が返されます。それ以外の場合、数値は小数点以下 2 桁に丸められます。 自社オーディエンスにのみ適用されます。 GET リクエストでのみ返されます。 |
appId |
省略可。appId が、アップロードされる mobileDeviceIds のタイプと一致している。
|
共用体フィールド members 。カスタマー マッチ オーディエンスの初期メンバー。members は次のいずれかになります。 |
|
contactInfoList |
入力のみの初期オーディエンス メンバーを定義する連絡先情報のリスト。
|
mobileDeviceIdList |
入力のみの初期オーディエンス メンバーを定義するモバイル デバイス 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 |
リニアテレビ コンテンツのオーディエンス。 |
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 から取得されたデータ。 |
ContactInfoList
カスタマー マッチのオーディエンス メンバーを定義する連絡先情報のリスト用のラッパー メッセージ。
JSON 表現 |
---|
{ "contactInfos": [ { object ( |
フィールド | |
---|---|
contactInfos[] |
カスタマー マッチのオーディエンス メンバーを定義する ContactInfo オブジェクトのリスト。contactInfos を分割した後のメンバーのサイズは 500,000 以下にする必要があります。 |
consent |
入力のみの このフィールドを未設定のままにすると、同意が指定されていないことを示します。
|
ContactInfo
カスタマー マッチ オーディエンス メンバーを定義する連絡先情報。
JSON 表現 |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
フィールド | |
---|---|
hashedEmails[] |
メンバーの SHA256 ハッシュ化されたメールアドレスのリスト。ハッシュ化する前に、すべての空白文字を削除し、文字列がすべて小文字であることを確認します。 |
hashedPhoneNumbers[] |
メンバーの SHA256 ハッシュ化された電話番号のリスト。ハッシュ化の前に、すべての電話番号を E.164 形式でフォーマットし、国コードを含める必要があります。 |
zipCodes[] |
メンバーの郵便番号のリスト。 次のフィールドも設定する必要があります。 |
hashedFirstName |
メンバーの名(ファースト ネーム)を SHA256 でハッシュ化したもの。ハッシュ化する前に、すべての空白文字を削除し、文字列がすべて小文字であることを確認します。 次のフィールドも設定する必要があります。 |
hashedLastName |
メンバーの姓を SHA256 でハッシュ化したもの。ハッシュ化する前に、すべての空白文字を削除し、文字列がすべて小文字であることを確認します。 次のフィールドも設定する必要があります。 |
countryCode |
メンバーの国コード。 次のフィールドも設定する必要があります。 |
同意
ユーザーの同意ステータス。
JSON 表現 |
---|
{ "adUserData": enum ( |
フィールド | |
---|---|
adUserData |
広告ユーザーデータに関する同意を表します。 |
adPersonalization |
広告のパーソナライズに対する同意を表します。 |
ConsentStatus
同意ステータス。
列挙型 | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
このバージョンでタイプ値が指定されていないか、不明です。 |
CONSENT_STATUS_GRANTED |
同意が付与されます。 |
CONSENT_STATUS_DENIED |
同意が拒否されました。 |
MobileDeviceIdList
カスタマー マッチ オーディエンス メンバーを定義するモバイル デバイス ID のリスト用のラッパー メッセージ。
JSON 表現 |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
フィールド | |
---|---|
mobileDeviceIds[] |
カスタマー マッチ オーディエンス メンバーを定義するモバイル デバイス ID のリスト。mobileDeviceIds のサイズは 500,000 以下にする必要があります。 |
consent |
入力のみの このフィールドを未設定のままにすると、同意が指定されていないことを示します。
|
メソッド |
|
---|---|
|
FirstPartyAndPartnerAudience を作成します。 |
|
カスタマー マッチ オーディエンスのメンバーリストを更新します。 |
|
ファーストパーティまたはパートナーのオーディエンスを取得します。 |
|
ファーストパーティ オーディエンスとパートナー オーディエンスを一覧表示します。 |
|
既存の FirstPartyAndPartnerAudience を更新します。 |