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)
  }
  // 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)

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

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(広告 ID/IDFA)のリスト。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"