複数のクライアントに代わって入札する

入札者は、1 つの入札レスポンスで複数の購入者の広告枠を購入できます。たとえば、デマンドサイド プラットフォーム（DSP）は、入札アプリケーションを使用して、購入者である複数のマーケティング担当者や代理店の広告枠を購入できます。このガイドでは、複数の購入者を代表して送信された単一のリクエストを処理するようにビッダーをコーディングする方法について説明します。

背景

広告ネットワークや代理店のトレーディング デスクが、1 つ以上の DSP と連携する場合もあります。DSP を通じて購入する場合は、次の 2 つのオプションがあります。

• DSP は、購入者ではないマーケティング担当者や代理店の広告枠を購入します。この場合、DSP は 1 件の入札リクエストを受信し、1 件の入札で応答します。Google から DSP に直接請求されます。
• DSP は、購入者であるマーケティング担当者や代理店の広告枠を購入します。DSP は、対象となる購入者に関連付けられた複数の請求 ID を含む 1 つの入札リクエストを受信し、代理で入札する購入者ごとに個別の入札を行うことができます。このモデルでは、Google は DSP ではなく購入者に請求します。このガイドの残りの部分では、このシナリオに焦点を当てます。

設定とプレターゲティング

Google は、購入者とインプレッションをターゲットとするプリターゲティング設定に関連付けられた 1 つ以上の請求 ID を含む入札リクエストを送信します。これらは BidRequest.imp.ext.billing_id フィールドで確認できます。

複数の購入者の請求 ID を含む BidRequest にレスポンスを返す場合は、入札に関連付けるアカウントを Google が認識できるように BidResponse.seatbid.bid.ext.billing_id が必要です。フィールドが設定されていないレスポンスはすべてフィルタされます。1 つの請求 ID のみを含む BidRequest では、このフィールドは引き続き省略可能です。

プレターゲティングの例

入札者が 2 人の購入者（請求 ID が 123 の購入者と請求 ID が 124 の購入者）に代わって入札します。ビッダーは、請求 ID 213 を使用して英語をターゲットとするプリターゲティング構成と、請求 ID 231 を使用してパソコンをターゲットとするプリターゲティング構成を 1 つずつ設定します。以下に、さまざまな種類のインプレッションの入札リクエストに表示される課金 ID を示します。

インプレッションの説明	入札リクエストの請求 ID
パソコンで日本語のコンテンツを視聴している。	123、124、231
スマートフォンに表示された英語のコンテンツ。	123、124、213
パソコンで英語のコンテンツを視聴している。	123、124、213、231

重要: これらの設定のみが有効なプリターゲティング設定である場合、パソコンから発生し、英語以外のコンテンツを含むインプレッションに対しては入札リクエストは送信されません。

BidRequest の例

BidRequest の例を次に示します。これらのリクエストは複数のアカウントに適用されるため、請求 ID が複数あります。

OpenRTB Protobuf

sample

id: "n9YFp0D9qE02Q5A49bo68a"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 320
      h: 50
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.2.0"
  tagid: "2913643481"
  bidfloor: 0.04
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0003642654628492892
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.98
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 41048190734
    billing_id: 87998475627
    publisher_settings_list_id: 5889715199959683550
    publisher_settings_list_id: 3379823455061055318
    allowed_vendor_type: 566
    allowed_vendor_type: 113
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "6ZVs3vs4"
      versions: "2.0"
      versions: "2.1"
      fidelities: VIEW_THROUGH_ADS
      fidelities: STOREKIT_RENDERED_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-6227762759521589"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "TX"
    metro: "623"
    city: "Lewisville"
    type: IP
    utcoffset: -300
    accuracy: 6225
  }
  make: "Apple"
  model: "iPhone13,2"
  os: "iOS"
  osv: "17.4.1"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  lmt: true
  hwv: "iPhone13,2"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "17"
      version: "4"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB18-5"
bcat: "IAB23-4"
bapp: "359917414"
bapp: "1446254576"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.2.0"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z17251-40u3eXfXPL5j3MDPa7n6Ree92uf7354o71FP67Rk5i3G30Ez7p39Ze1722D8H"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}