Ustalanie stawek w imieniu wielu kont

Licytujący może w ramach jednej stawki kupować zasoby reklamowe dla wielu podmiotów, jeśli te podmioty są klientami Authorized Buyers. Na przykład platforma DSP może używać swojego systemu licytującego do kupowania zasobów reklamowych dla kilku marketerów lub agencji, które są klientami Authorized Buyers. Z tego przewodnika dowiesz się, jak zaprogramować licytujący, aby przetwarzał 1 żądanie wysłane w imieniu wielu klientów Authorized Buyers.

Wprowadzenie

Authorized Buyers współpracuje z sieciami reklamowymi, agencjami zakupowymi i platformami DSP. W niektórych sytuacjach platforma reklamowa lub agencja zakupowa może zdecydować się na współpracę z jedną lub wieloma platformami DSP. Klienci korzystający z DSP mają do wyboru 2 opcje implementacji:

• Platforma DSP kupuje zasoby reklamowe dla marketerów lub agencji, które nie są klientami Authorized Buyers. W takim przypadku platforma DSP otrzymuje jedno pytanie o stawkę i w odpowiedzi przekazuje jedną stawkę. Google rozlicza się bezpośrednio z DSP.
• Platforma DSP kupuje zasoby reklamowe dla marketerów lub agencji, które są klientami Authorized Buyers. Klienci korzystający z Authorized Buyers muszą ustalać niezależne stawki, nawet jeśli korzystają z platformy DSP. Dzięki temu wydawcy mają wgląd w prawdziwego kupującego, umożliwiają wyłączne przydzielanie zasobów reklamowych i umożliwiają unikanie przekierowań z sieci do sieci. W tym modelu Google rozlicza klienta Authorized Buyers, a nie DSP. Ten scenariusz koncentruje się w pozostałej części tego przewodnika.

Authorized Buyers przekierowuje pytania o stawkę dotyczące kont podrzędnych nadrzędnego licytującego (DSP) za pomocą identyfikatora grupy reklam. Identyfikatory grup reklam na kontach podrzędnych są przekazywane podczas zakładania konta podrzędnego przez menedżera konta lub usługę Authorized Buyers i zespół pomocy Otwartego ustalania stawek. Platforma DSP wykorzystuje te informacje do przetwarzania odpowiedzi na stawkę. W przypadku platformy DSP, która używa klientów Authorized Buyers do kupowania w Authorized Buyers, otrzymuje skonsolidowane wywołanie dotyczące zestawu klientów RTB.

Konfiguracja i kierowanie wstępne

Wszystkie platformy DSP są skonfigurowane pod kątem skonsolidowanych żądań. Kryteria kierowania wstępnego odbywa się na poziomie nadrzędnego licytującego na wszystkich kontach podrzędnych. Jest to tzw. kierowanie wstępne na poziomie licytującego (BLP).

W przypadku BLP dopasowywanie zasobów reklamowych odbywa się tylko na poziomie nadrzędnego licytującego. Ułatwia to pracę oraz zarządzanie zasobami i ustawieniami na wielu kontach.

Zalety kierowania wstępnego na poziomie licytującego a standardowe kierowanie wstępne (wycofane)

Kierowanie wstępne na poziomie licytującego	Standardowe kierowanie wstępne (wycofane)
Stanowisko rodzica zarządza wszystkimi miejscami	Każde stanowisko zarządza własnymi zasobami reklamowymi
Wszystkie miejsca kwalifikujące się do przewidzianego w ruchu	Różne konfiguracje kierowania wstępnego na wielu kontach
Prostsza konfiguracja i łatwiejsze zarządzanie	Mniej kontroli na poziomie nadrzędnego licytującego, ale szczegółowa kontrola nad określonymi miejscami

Z kontami podrzędnymi powiązany jest 1 identyfikator grupy reklam, więc dopasowania kierowania wstępnego są uwzględniane jako 1 wpis w polu matching_ad_data na koncie BidRequest dla każdego dopasowanego konta podrzędnego.

Jeśli odpowiadasz na żądanie BidRequest, które zawiera dopasowania wstępnego kierowania z konta innego niż konto nadrzędne (np. dowolnego elementu BidRequest, dla którego ustawiono pole matching_network_data), pole billing_id w BidResponse jest wymagane, aby usługa Authorized Buyers wiedziała, które konto i kampania ma powiązać ze stawką. Każda odpowiedź, która nie ustawia wartości w polu, jest odrzucana. Pole pozostaje opcjonalne w przypadku każdego elementu BidRequest, który zawiera tylko dopasowania kierowania wstępnego z konta licytującego. Odpowiedź na żądanie BidRequest, która zawiera dopasowania kierowania wstępnego z wielu kont, może zwrócić wiele reklam.

Przykład kierowania wstępnego na poziomie licytującego

Konto podrzędne (identyfikator grupy reklam: 123)	Stanowisko nadrzędne (identyfikator grupy reklam: 124)
Kierowanie wstępne: USA + UE	Kierowanie wstępne: USA + Azja i Pacyfik

Kryteria objaśnienia	Wysłano identyfikator rozliczenia
Tylko USA	123 + 124
Tylko UE	123
Tylko Azja i Pacyfik	124

Przykładowe pytania o stawkę

Oto przykłady: BidRequest. Pamiętaj, że żądania te zawierają wiele identyfikatorów płatności, ponieważ dotyczą one wielu kont.

Google

przykład

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"

Plik JSON OpenRTB

przykład

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

protobuf OpenRTB,

przykład

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
}