AudienceMember

操作対象のオーディエンス メンバー。

JSON 表現
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of list of possible types for union field data.
}
フィールド
destinationReferences[]

string

省略可。オーディエンス メンバーを送信する Destination を定義します。

consent

object (Consent)

省略可。ユーザーの同意設定。

共用体フィールド data。操作する識別データの種類。data は次のいずれかになります。
userData

object (UserData)

ユーザーを識別するユーザー提供データ。

pairData

object (PairData)

Publisher Advertiser Identity Reconciliation(PAIR)ID

この機能はデータ パートナーのみが利用できます。

mobileData

object (MobileData)

ユーザーのモバイル デバイスを特定するデータ。

userIdData

object (UserIdData)

広告主が定義したユーザーの固有識別子に関連するデータ。

ppidData

object (PpidData)

パブリッシャー指定の識別子に関連するデータ。

この機能はデータ パートナーのみが利用できます。

compositeData

object (CompositeData)

複数の識別子タイプのグループ。

googleUserIdData

object (GoogleUserIdData)

暗号化された Google ユーザー ID。

partnerProvidedIdData

object (PartnerProvidedIdData)

パートナー提供の識別子。

PairData

オーディエンスの PAIR ID。少なくとも 1 つのペア ID が必要です。

この機能はデータ パートナーのみが利用できます。

JSON 表現
{
  "pairIds": [
    string
  ]
}
フィールド
pairIds[]

string

必須。Cleanroom から提供された PII データ。SHA256 でハッシュ化され、PAIR ユーザーリストのパブリッシャー キーを使用して EC 可換暗号で暗号化されています。1 つの AudienceMember で指定できる pairIds は最大 10 個です。

MobileData

オーディエンスのモバイル ID。モバイル ID が少なくとも 1 つ必要です。

JSON 表現
{
  "mobileIds": [
    string
  ]
}
フィールド
mobileIds[]

string

必須。モバイル デバイス ID のリスト(カスタマー マッチのユーザーリストの場合は Android 広告 ID、iOS IDFA。基本的なユーザーリストの場合は Android 広告 ID、iOS IDFA、Xbox または Microsoft ID、Amazon Fire TV ID、Roku ID、汎用デバイス ID)。1 つの AudienceMember で指定できる mobileIds は最大 10 個です。

UserIdData

ユーザー ID を保持するユーザー ID データ。

JSON 表現
{
  "userId": string
}
フィールド
userId

string

必須。広告主が定義したユーザーの固有識別子。

PpidData

パブリッシャー指定の識別子(PPID)を保持するデータ。少なくとも 1 つの ppid が必要です。

この機能はデータ パートナーのみが利用できます。

JSON 表現
{
  "ppids": [
    string
  ]
}
フィールド
ppids[]

string

必須。ユーザーのパブリッシャー提供の識別子のリスト。

CompositeData

ユーザーの識別子と関連データを保持する複合データ。userData または ipData の少なくとも 1 つは必須です。

JSON 表現
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
フィールド
userData

object (UserData)

省略可。ユーザーを識別するユーザー提供データ。

ipData[]

object (IpData)

省略可。オーディエンスの作成に使用された顧客とのやり取りを表す IP アドレス データ。

IpData

ユーザーの IP アドレス情報。カスタマー マッチのマッチ率を改善するには、observeStartTime と observeEndTime を含めることをおすすめします。

JSON 表現
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
フィールド
ipAddress

string

必須。お客様とのやり取りの際に取得された IP アドレス。IPv4 と IPv6 の両方の標準文字列形式を受け入れます。

observeStartTime

string (Timestamp format)

省略可。セッションでこの IP アドレスから最初に記録されたインタラクションの時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

observeEndTime

string (Timestamp format)

省略可。セッションにおけるこの IP アドレスからの最後の記録されたインタラクション時間。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

GoogleUserIdData

暗号化された Google ユーザー ID を保持する Google ユーザー ID データ。少なくとも 1 つの Google ユーザー ID が必要です。

JSON 表現
{
  "googleUserIds": [
    string
  ]
}
フィールド
googleUserIds[]

string

必須。暗号化された Google ユーザー ID のリスト。

PartnerProvidedIdData

パートナー提供の識別子を含むパートナー提供のデータ。パートナーが提供する識別子を少なくとも 1 つ指定する必要があります。

JSON 表現
{
  "partnerProvidedIds": [
    string
  ]
}
フィールド
partnerProvidedIds[]

string

必須。パートナー提供の識別子のリスト。