代表多個帳戶出價

出價方可以在單次出價中為多個實體購買廣告空間，前提是這些實體是 Authorized Buyers 客戶。舉例來說，需求端平台 (DSP) 可能會透過出價工具，為多位本身是 Authorized Buyers 客戶的行銷人或代理商購買廣告空間。本指南說明如何編寫程式碼，藉此處理代表多個 Authorized Buyers 客戶傳送的單一要求。

背景

Authorized Buyers 支援廣告聯播網、代理交易中心和需求端平台 (DSP)。在某些情況下，廣告聯播網或代理商交易中心可能會選擇與一或多個需求端平台合作。以下兩種實作選項適用於使用 DSP 的客戶：

• 需求端平台為非 Authorized Buyers 客戶的行銷商或代理商購買廣告空間。在這種情況下，需求端平台會收到一個出價要求，並以一個出價回應。Google 會直接向 DSP 請款。
• DSP 為具備 Authorized Buyers 客戶身分的行銷人或代理商購買廣告空間。Authorized Buyers 客戶必須自行出價，即使他們使用 DSP 也一樣。這是為了確保發布商能夠清楚掌握實際買方，確保廣告空間不會重複分配，並避免在不同的聯播網之間重新導向。在這個模式下，Google 會向 Authorized Buyers 客戶收費，而非 DSP。本指南的其餘部分會著重於這個情境。

Authorized Buyers 透過廣告群組 ID，轉送上層出價方 (DSP) 子帳戶的出價要求。子帳戶廣告群組 ID 是由客戶經理、Authorized Buyers 和公開出價支援團隊在子帳戶設定時提供。DSP 會使用這項資訊來處理出價回應。如果 DSP 使用其技術向 Authorized Buyers 購買廣告空間，DSP 會收到一組 RTB 用戶端的合併呼叫。

設定和預先指定

所有需求端平台都會針對整合式請求進行設定。所有子帳戶的預先指定條件都會在上層出價工具層級完成。這稱為「出價工具層級預先指定」(BLP)。

使用 BLP 時，廣告空間比對作業只會在上層出價方層級完成。這樣可以簡化工作流程，並且更輕鬆地管理多個帳戶的庫存和設定。

出價工具層級預先指定與一般預先指定的好處 (已淘汰)

出價工具層級預先指定	一般預先指定 (已淘汰)
家長席管理所有帳戶名額的資格	每個帳戶名額可管理自己的廣告空間資格
所有流量都符合資格	因應多個帳戶進行預先指定設定
設定簡單，管理容易	上層出價方層級較無控制項，但可進一步控管特定帳戶名額

子帳戶只會有相關聯的單一廣告群組 ID，因此會針對每個相符的子帳戶，在 BidRequest 的 matching_ad_data 欄位中，將預先指定比對納為一個項目。

當您回應的 BidRequest 包含來自上層帳戶以外的帳戶 (例如已設定 matching_network_data 欄位的任何 BidRequest) 時，就必須在 BidResponse 中的 billing_id 欄位，讓 Authorized Buyers 知道要與出價建立關聯的帳戶和廣告活動。未設定此欄位的回應都會遭到捨棄。如果 BidRequest 只包含來自出價工具帳戶的預先指定相符項目，則這個欄位仍為選用欄位。如果 BidRequest 包含來自多個帳戶的預先指定相符項目，則回應可能會傳回多則廣告。

出價方層級預先指定範例

兒童座位 (廣告群組 ID：123)	上層座位 (廣告群組 ID：124)
預先指定：美國 + 歐盟	預先指定：美國 + 亞太地區

呼叫條件	billing_id 已送出
US only	123 + 124 人
僅限歐盟地區	123
僅限亞太地區	124

BidRequest 範例

以下是 BidRequest 的範例。請注意，這些要求中有多個帳單 ID，因為這些要求適用於多個帳戶。

Google

範例

id: "S\212\364\302\036\030\211TJ\365\212\340l6\245=u;\317x\333\252 "
ip: "\300\250"
user_agent: "Mozilla/5.0 (Linux; Android 13; SM-S906U Build/TP1A.220624.014; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/108.0.5359.128 Mobile Safari/537.36 (Mobile; afma-sdk-a-v225014044.225014044.0)"
url: "https://www.google.com"
detected_language: "en"
adslot {
  id: 1
  width: 320
  width: 300
  height: 50
  height: 50
  excluded_attribute: 14
  excluded_attribute: 30
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  matching_ad_data {
    billing_id: 14066780015
    billing_id: 25678885930
    minimum_cpm_micros: 4900000
  }
  slot_visibility: ABOVE_THE_FOLD
  ad_block_key: 3514974457
  publisher_settings_list_id: 3949401098794797722
  publisher_settings_list_id: 4224560246640894720
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  viewability: 98
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  allowed_ad_types: ALLOWED_AD_TYPE_BANNER
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_NOT_ALLOWED
  session_depth: 2
  api: OMID_1
  api: MRAID_1
  flexible_adslot_settings {
    max_width: 412
    max_height: 64
    min_width: 300
    min_height: 50
  }
  omidpn: "Google"
  omidpv: "afma-sdk-a-v224400999.221310000.1"
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
}
is_test: false
cookie_version: 1
google_user_id: "2vy4H5TgSY2XD4I22zb394gB6Vu"
mobile {
  app_id: "com.google.testapp"
  is_app: true
  encrypted_advertising_id: "\322H\300\221\312\024ylU\211\022\024\020x*\2340\021\255O\360\0036b\205R\371\275 fWa\223K\221)"
  app_name: "Test App"
  app_rating: 4.7201877
  advertising_id: "\346\324\370053\310g\347\224;S\204\'%\370"
}
cookie_age_seconds: 25920000
postal_code: "10011"
geo_criteria_id: 9010919
encrypted_hyperlocal_set: "pJ\275\207\352\024nHX\236VvP\313v\206x\006\252\234\256^\254\323-\213\274Gf\264\013\032{\376\233\243\000\320\307\321\330\254\351\007o\244\323\236U\220F\254b@\265 Qm5\206\374\212\237\242{8Yf\317\367j-\221\310\305\350\311/\355U\004\327\361\331Y3\311fV\273\355"
seller_network_id: 7664
publisher_type: PUBLISHER_OWNED_AND_OPERATED
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "samsung"
  model: "sm-s906u"
  os_version {
    major: 13
  }
  carrier_id: 0
  screen_width: 412
  screen_height: 816
  screen_pixel_ratio_millis: 2625
  screen_orientation: PORTRAIT
  limit_ad_tracking: false
}
publisher_country: "TR"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 1000
google_query_id: "ANy-zk0vw2-E3557O1HQ6Lyj920O22231f54B9leUCUR3oP61TN5cq16sj62j3TJ7W3y1862"
auction_type: FIRST_PRICE
geo {
  lat: 33.63
  lon: -84.26
  country: "USA"
  region: "GA"
  metro: "524"
  city: "Ellenwood"
  zip: "30294"
  accuracy: 6306
}
user_agent_data {
  platform {
    brand: "Android"
    version: "13"
  }
  mobile: true
  model: "SM-S906U"
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "AppleWebKit"
    version: "537"
    version: "36"
  }
  bitness: "64"
}
supply_chain {
  complete: false
  nodes {
    advertising_system_identifier: "google.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

OpenRTB JSON

範例

{
  "id": "7O93Fz6ValZ0J1OU917TBd",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "pos": 1,
        "battr": [
          5,
          6
        ],
        "api": [
          3,
          5
        ],
        "wmax": 300,
        "hmax": 250,
        "wmin": 201,
        "hmin": 167,
        "format": [
          {
            "w": 300,
            "h": 250
          }
        ]
      },
      "displaymanager": "GOOGLE",
      "tagid": "1763160040",
      "bidfloor": 1.13,
      "bidfloorcur": "USD",
      "pmp": {
        "deals": [
          {
            "id": "74575310",
            "bidfloor": 4.97,
            "bidfloorcur": "USD",
            "at": 3,
            "ext": {
              "deal_type": 3,
              "must_bid": 0,
              "publisher_blocks_overridden": 1,
              "creative_source": 1
            }
          }
        ]
      },
      "secure": 1,
      "metric": [
        {
          "type": "viewability",
          "value": 0.85,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 111,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          95125716848,
          68063619966
        ],
        "publisher_settings_list_id": [
          7531260801312350752,
          8928022352247371517
        ],
        "ampad": 2,
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1,
          "is_default": 1
        },
        "auction_environment": 0
      }
    }
  ],
  "app": {
    "name": "Test App",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-2640954686638618",
      "ext": {
        "country": "US"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "userrating": "4.5",
      "livestream": 0,
      "language": "pt"
    },
    "storeurl": "https://www.google.com",
    "ext": {
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 11; M2004J19C Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/102.0.5005.78 Mobile Safari/537.36 (Mobile; afma-sdk-a-v221820037.221820037.0)",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "BRA",
      "region": "BR-RJ",
      "city": "Mangaratiba",
      "zip": "23860-000"
    },
    "make": "xiaomi",
    "model": "m2004j19c",
    "os": "android",
    "osv": "11",
    "devicetype": 4,
    "lmt": 0,
    "w": 393,
    "h": 808,
    "pxratio": 2.75,
    "ext": {
      "user_agent_data": {
        "browser": {
          "brand": "Chrome",
          "version": [
            "102",
            "0"
          ]
        },
        "platform": {
          "brand": "Android",
          "version": [
            "11"
          ]
        },
        "mobile": 1,
        "model": "M2004J19C",
        "browsers": [
          {
            "brand": "Mozilla",
            "version": [
              "5",
              "0"
            ]
          },
          {
            "brand": "AppleWebKit",
            "version": [
              "537",
              "36"
            ]
          }
        ]
      }
    }
  },
  "user": {
    "id": "a876d0gb190X6N49C6144T039Rv",
    "buyeruid": "79pVs5m3XhYE538N5nf6j6Z6qf023z0B",
    "customdata": "JQ171Jwzh0T12N0Gjl73z40Z07527w2280666212Jjk7S5lN",
    "ext": {}
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB7-39"
  ],
  "regs": {
    "ext": {
      "lgpd": 1
    }
  },
  "source": {
    "ext": {
      "omidpn": "Google",
      "omidpv": "afma-sdk-a-v221310999.214106000.1",
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "google.com",
            "sid": "pub-7203890273681265",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zi592K-32715HsNgUv4F7y10GR773cb8V5dp99TSILtoKC1Zz83y0G42c9qm0uVspi99",
    "fcap_scope": 3,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

OpenRTB Protobuf

範例

id: "378836oi92t144hpA8Nv3X"
imp {
  id: "1"
  banner {
    w: 360
    h: 640
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 360
      h: 640
    }
    format {
      w: 360
      h: 604
    }
  }
  instl: true
  tagid: "7237784749"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  metric {
    type: "click_through_rate"
    value: 0.017687013372778893
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.96
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 88839033718
    billing_id: 42465810344
    publisher_settings_list_id: 6385730468696724206
    publisher_settings_list_id: 7602756188937910294
    allowed_vendor_type: 4374
    allowed_vendor_type: 780
    ampad: AMP_AD_NOT_ALLOWED
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
      is_default: true
    }
    auction_environment: SERVER_SIDE_AUCTION
  }
}
app {
  bundle: "com.google.testapp"
  publisher {
    id: "pub-8927593002710190"
    [com.google.doubleclick.publisher] {
      country: "CN"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "id"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
  }
}
device {
  ua: "Mozilla/5.0 (Linux; Android 6.0; Redmi Note 4 Build/MRA58K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/100.0.4896.127 Mobile Safari/537.36 (Mobile; afma-sdk-a-v221613021.221613021.0)"
  geo {
    lat: 0.0
    lon: 0.0
    country: "IDN"
    region: "ID-JB"
    zip: "46184"
  }
  ipv6: "2001:448a:3066::"
  make: "xiaomi"
  model: "redmi note 4"
  os: "android"
  osv: "6.0"
  devicetype: HIGHEND_PHONE
  ifa: "b\'\\x08\\xc9\\xfa\\x8d\\xe0\\x16OZ\\x97\\xffH9%\\xd8\\xebi\'"
  lmt: false
  w: 360
  h: 640
  pxratio: 3.0
  sua {
    browsers {
      brand: "Chrome"
      version: "100"
      version: "0"
    }
    platform {
      brand: "Android"
      version: "6"
      version: "0"
    }
    mobile: true
    model: "redmi note 4"
  }
}
user {
  id: "H4X9h8D5bFg8tWnh3S065N96C6y"
  [com.google.doubleclick.user] {
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB18-5"
bcat: "IAB7-39"
source {
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-a-v221310999.211512000.1"
    schain {
      complete: 1
      nodes {
        asi: "google.com"
        sid: "pub-4062377952200160"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zp09u8-d20rQ521040dqz39K771Lr9102b031Z15C45Q9q7AB414SnDWG5Rj96Z77W66"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_DEVICE
}