Im Auftrag mehrerer Konten bieten

Eine Gebotsfunktion kann Inventar für mehrere Elemente mit einem einzigen Gebot kaufen, wenn diese Entitäten Authorized Buyers-Kunden sind. Eine Demand-Side-Plattform (DSP) kann beispielsweise die Gebotsfunktion zum Kauf von Inventar für mehrere Werbetreibende oder Agenturen verwenden, die selbst Authorized Buyers-Clients sind. In diesem Leitfaden wird erläutert, wie Sie Ihre Gebotsfunktion so codieren, dass eine einzelne Anfrage verarbeitet wird, die im Namen mehrerer Authorized Buyers-Kunden gesendet wird.

Hintergrund

Authorized Buyers funktioniert mit Werbenetzwerken, Agenturhandelsplattformen und Demand-Side-Plattformen (DSPs). In einigen Szenarien kann ein Werbenetzwerk oder eine Agentur-Handelsplattform mit einer oder mehreren DSPs arbeiten. Für Clients, die eine DSP verwenden, stehen zwei Implementierungsoptionen zur Verfügung:

• Das DSP-Kaufinventar für Werbetreibende oder Agenturen, die keine Authorized Buyers-Clients sind. In diesem Fall erhält die DSP eine Gebotsanfrage und antwortet mit einem Gebot. Google stellt die DSP direkt in Rechnung.
• Das DSP-Kaufinventar für Werbetreibende oder Agenturen, die Authorized Buyers-Kunden sind. Authorized Buyers-Clients müssen auch dann unabhängige Gebote abgeben, wenn sie eine DSP verwenden. So soll sichergestellt werden, dass der tatsächliche Käufer für Publisher sichtbar ist, dass exklusive Inventarzuweisungen möglich sind und dass keine Weiterleitungen von Netzwerk zu Netzwerk erfolgen. Bei diesem Modell stellt Google die Kosten dem Authorized Buyers-Client und nicht der DSP in Rechnung. Im weiteren Verlauf dieses Leitfadens liegt der Schwerpunkt auf diesem Szenario.

In Authorized Buyers werden Gebotsanfragen für untergeordnete Konten eines übergeordneten Bieters (DSP) über eine Anzeigengruppen-ID weitergeleitet. Die Anzeigengruppen-IDs der untergeordneten Konten werden bei der Einrichtung des untergeordneten Kontos von einem Account Manager, Authorized Buyers und dem Open Bidding-Support zur Verfügung gestellt. Die DSP verwendet diese Informationen, um die Gebotsantwort zu verarbeiten. Bei einer DSP, bei der Authorized Buyers-Clients ihre Technologie zum Kauf von Authorized Buyers nutzen, erhält sie ein konsolidiertes Callout für eine Reihe von RTB-Clients.

Einrichtung und Pre-Targeting

Alle DSPs sind für konsolidierte Anfragen konfiguriert. Die Auswahl der Pre-Targeting-Kriterien erfolgt auf der Ebene der übergeordneten Bieter für alle untergeordneten Konten. Dies wird als Pre-Targeting auf Bieterebene (BLP) bezeichnet.

Bei BLP erfolgt der Inventarabgleich nur auf der Ebene des übergeordneten Bieters. Dies vereinfacht den Workflow sowie die Verwaltung des Inventars und der Einstellungen für viele Konten.

Vorteile des Pre-Targetings auf Bieterebene im Vergleich zum regulären Pre-Targeting (eingestellt)

Pre-Targeting auf Bieterebene	Normales Pre-Targeting (eingestellt)
Über das übergeordnete Konto werden die Voraussetzungen für alle Lizenzen verwaltet	Jede Lizenz verwaltet ihre eigene Inventareignung.
Alle Nutzerlizenzen für alle Zugriffe verfügbar	Unterschiedliche Pre-Targeting-Einstellungen für viele Konten
Einfachere Einrichtung und einfachere Verwaltung	Weniger Kontrolle auf übergeordneter Bieterebene, aber detaillierte Kontrolle für bestimmte Nutzerlizenzen

Untergeordneten Konten ist nur eine Anzeigengruppen-ID zugeordnet. Somit werden Pre-Targeting-Übereinstimmungen als ein Eintrag im Feld matching_ad_data von BidRequest für jedes übereinstimmende untergeordnete Konto eingefügt.

Wenn Sie auf eine BidRequest antworten, die Pre-Targeting-Übereinstimmungen von einem anderen Konto als dem übergeordneten Konto enthält (z. B. eine beliebige BidRequest, für die das Feld matching_network_data festgelegt ist), ist das Feld billing_id in BidResponse erforderlich, damit Authorized Buyers weiß, welches Konto und welche Kampagne dem Gebot zugeordnet werden sollen. Jede Antwort, mit der das Feld nicht festgelegt wird, wird verworfen. Das Feld ist für alle BidRequest, die nur Pre-Targeting-Übereinstimmungen des Bieterkontos enthalten, weiterhin optional. Eine Antwort auf eine BidRequest, die Pre-Targeting-Übereinstimmungen aus mehreren Konten enthält, kann mehrere Anzeigen zurückgeben.

Beispiel für ein Pre-Targeting auf Bieterebene

Untergeordnete Anzeige (Anzeigengruppen-ID: 123)	Übergeordnetes Konto (Anzeigengruppen-ID: 124)
Pre-Targeting: USA und EU	Pre-Targeting: USA und APAC

Kriterien für Zusatzinformationen	Billing_id gesendet
Nur USA	123 + 124
Nur EU	123
Nur APAC	124

Beispiele für BidRequests

Im Folgenden finden Sie Beispiele für BidRequest. Diese Anfragen enthalten mehrere Abrechnungs-IDs, da sie für mehrere Konten gelten.

Google

Beispiel

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

Beispiel

{
  "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-Protokollzwischenspeicher

Beispiel

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
}