Anzeigenformat für Käufer-SDK

Für Käufer-SDK-Anzeigen werden Creatives verwendet, die von Ihrem eigenen SDK gerendert werden.

Mobiles App-Inventar von Publishern, die Ihre Bidding in ihre App integriert, kann Gebote mit dem vom Käufer SDK gerenderten Anzeigenformat. Wie sie gerendert werden, hängt davon ab, SDK-Implementierung und die SDKRenderedAd, die Sie im Gebotsantwort.

Sie können ein Gebot abgeben, das entweder eine vom Käufer SDK gerenderte Anzeige oder eine andere Anzeige beinhaltet. Format Google Mobile Ads SDK unterstützt, aber alle Gebote, die beides enthalten, werden herausgefiltert.

Voraussetzungen

SDK-Anzeigen für Käufer sind für genehmigte Käufer verfügbar. Bei diesem Format sind zusätzliche von Ihnen und dem Publisher. Wenden Sie sich an Ihren Technical Account Manager, müssen Sie Ihr Konto für SDK-Anzeigen für Käufer konfigurieren. Anschließend können Sie ein Bidding-Tool Adapter, der es Ihrem SDK ermöglicht, mit dem Google Mobile Ads SDK kommunizieren. Der Verlag oder Webpublisher muss Ihr SDK und den Adapter in ihre mobilen Apps integrieren.

Wir empfehlen Ihnen, Creatives für Rezension bevor sie in eine Gebotsantwort eingefügt werden. Wenden Sie sich an Ihren Technical Account Manager. wenn Sie den Creative-Typ zum Zeitpunkt der Gebotsabgabe nicht kennen.

Wenn eine Gebotsanfrage dieses Anzeigenformat unterstützt, können Sie eine Anzeige angeben, die mit Ihrem SDK, indem Sie das Feld sdk_rendered_ad in der Gebotsfunktion .

Gebotsanfrage

Gebotsanfragen für Inventar in mobilen Apps enthalten Details zu den SDKs und Adapter in der App des Publishers, die Sie für das Rendering verwenden können, Felder:

SDK-ID

Sie können die Gebotsanfrage verwenden, um die id zu finden, die Sie im Gebot angeben müssen Antwort für eine über ein SDK gerenderte Anzeige eines Käufers.

Siehe folgende Felder:

• OpenRTB: BidRequest.app.ext.installed_sdk
• RTB-Protokoll von Google (eingestellt): BidRequest.mobile.installed_sdk

Weitere Informationen zur InstalledSdk-Nachricht finden Sie in der OpenRTB und Google Protokollleitfäden.

Anzeigenblockzuordnung

Sie können die Gebotsanfrage verwenden, um die Anzeigenblockzuordnungen zu lesen, die mit der Anzeigenfläche übereinstimmen.

Siehe folgende Felder:

• OpenRTB: BidRequest.imp.ext.ad_unit_mapping
• RTB-Protokoll von Google (eingestellt): BidRequest.AdSlot.ad_unit_mapping

Weitere Informationen zum Objekt AdUnitMapping finden Sie in der OpenRTB und Google Protokollleitfäden.

Sichere Signale

Publisher können sichere Signale für Bieter freigeben. Sie finden sie auf BuyerGeneratedRequestData-Objekt von OpenRTB oder vom eingestellten Google- SecureSignal-Objekt des RTB-Protokolls

Siehe folgende Felder:

• OpenRTB: BidRequest.imp.ext.buyer_generated_request_data.data
• RTB-Protokoll von Google (eingestellt): BidRequest.AdSlot.SecureSignal.data

Weitere Informationen zur Darstellung sicherer Signale finden Sie in der OpenRTB und Google Protokollleitfäden.

Testanfragen

Im Feld "Testanfrage" sehen Sie, ob es sich bei der Gebotsanfrage testen.

Siehe folgende Felder:

• OpenRTB: BidRequest.test
• RTB-Protokoll von Google (eingestellt): BidRequest.is_test

Weitere Informationen zum Feld Test finden Sie in der OpenRTB und Google Protokollleitfäden.

Beispiel für eine Gebotsanfrage

id: "<bid_request_id>"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    ...
  }
...
  adx_ext {
   ...
    ad_unit_mapping {
      keyvals {
        key: "key_1"
        value: "value_1"
      }
      keyvals {
        key: "key_2"
        value: "value_2"
      }
      ...
      format: FORMAT_BANNER
    }
  }
}
app {
 ...
  adx_ext {
    installed_sdk {
      id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      sdk_version {
        major: 1
        minor: 2
        micro: 30
      }
      adapter_version {
        major: 1
        minor: 2
        micro: 3000
      }
    }
    installed_sdk {
    ...
    }
    ...
  }
}
device {
  ...
}
user {
  ...
  }
  adx_ext {
    eids {
      source: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      uids {
        id: "<partner_signal_string>"
      }
    }
  }
}
at: 1
tmax: 1000
cur: "USD"
test: 1
...
adx_ext {
  google_query_id: "<query_string>"
  ...
}

Gebotsantwort

Wichtig: Käufer sollten immer in diesem Dokument nachlesen, sind für SDK-Gebote erforderlich. Einige Felder, die für SDK-Gebote erforderlich sind, in der OpenRTB-Integration als optional gekennzeichnet

In der Gebotsantwort sind folgende Felder erforderlich:

• OpenRTB: <ph type="x-smartling-placeholder">
  </ph>
  • BidResponse.seatbid.bid.adomain
  • BidResponse.seatbid.bid.ext.billing_id
  • BidResponse.seatbid.bid.crid
  • BidResponse.seatbid.bid.w
  • BidResponse.seatbid.bid.h
• RTB-Protokoll von Google (eingestellt): <ph type="x-smartling-placeholder">
  </ph>
  • BidResponse.Ad.click_through_url
  • BidResponse.Ad.AdSlot.billing_id
  • BidResponse.Ad.buyer_creative_id
  • BidResponse.Ad.width
  • BidResponse.Ad.height

Außerdem muss Ihre Gebotsantwort ein SdkRenderedAd mit dem Parameter Folgendes:

SDK-ID

Verwenden Sie das Feld id, um die ID für das SDK anzugeben, mit dem die Anzeige gerendert werden soll.

Sie finden die ID in der Gebotsanfrage in den folgenden Feldern:

• OpenRTB: BidRequest.app.ext.installed_sdk
• RTB-Protokoll von Google (eingestellt): BidRequest.mobile.installed_sdk

Weitere Informationen zur InstalledSdk-Nachricht finden Sie in der OpenRTB und Google Protokollleitfäden.

Deklarierte Anzeige

Verwenden Sie das Feld declared_ad, um ein Creative anzugeben, das den Werten der Gebotsanfrage entspricht CreativeEnforcementSettings-Anforderungen und ist repräsentativ für die das Rendern von Daten. Nur html_snippet, video_url, video_vast_xml oder native_response sollte ausgefüllt sein.

• OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad
• RTB-Protokoll von Google (eingestellt): BidResponse.ad.sdk_rendered_ad.declared_ad

Wenn Sie das Feld declared_ad nicht ausfüllen, können wir das Creative nicht überprüfen und werden alle Gebote für das Creative aus der Auktion herausgefiltert.

Daten rendern

Verwenden Sie das Feld rendering_data, um die Daten für das Käufer-SDK bereitzustellen, zum Rendern Ihrer Anzeige verwenden.

• OpenRTB: BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data
• RTB-Protokoll von Google (eingestellt): BidResponse.ad.sdk_rendered_ad.rendering_data

Gebote für die Platzierung einer SDK-Anzeige eines Käufers müssen in der declared_ad ein Creative angeben ein. Die deklarierte Anzeige muss das rendering_data genau darstellen.

Hier ist ein Beispiel für ein SdkRenderedAd-Objekt:

{
  "id": "1234567",
  "rendering_data": "\xd58...,\xd4\x89\xd\xf9",
  "declared_ad": {
    "html_snippet": "<iframe src=\"https://example.com/ads?id=123&
      curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
  }
}

Wir empfehlen die Verwendung der Real-time Bidding API zur Übermittlung von Creatives für Rezension bevor Sie sie in eine Gebotsantwort aufnehmen.

Weitere Informationen finden Sie in der Google und Anleitungen für das OpenRTB finden Sie weitere Informationen zu den SdkRenderedAd-Feldern.

Beispiel für eine Gebotsantwort

Beispiele für Gebotsantworten für die einzelnen Anzeigenformate:

Banner

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 99
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 320
    h: 50
    burl: "https://abc.com/billing?td=fn&win_price=${AUCTION_PRICE}"
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          html_snippet: "<!doctype html> <html> ... </html>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
      billing_id: 141763360450
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

Interstitial

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

Video mit Prämie

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

Nativ

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 1200
    h: 627
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          native_response {
            ...
            assets {
              id: 1
              title {
                text: ""
              }
            }
            assets {
              id: 2
              data {
                value: "<some_string>"
              }
            }
            assets {
              id: 3
              data {
                value: "View now"
              }
            }
            assets {
              id: 4
              img {
                url: "<valid_image_url>"
                w: 1200
                h: 627
                type: 3
              }
            }
            assets {
              id: 5
              img {
                url: "<valid_image_url>"
                w: 100
                h: 100
                type: 1
              }
            }
            assets {
              id: 6
              data {
                value: ""
              }
            }
            assets {
              id: 7
              data {
                value: "<some_string>"
              }
            }
            link {
              url: "<destination_link>"
            }
          }
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

Creative-Überprüfung

Creatives werden vor der Auslieferung überprüft, um sicherzustellen, dass sie unseren Richtlinien und Publisher Einstellungen.

Warnung :Nicht überprüfte Creatives werden aus der Auktion herausgefiltert.

Es gibt zwei Möglichkeiten, Creatives zur Überprüfung einzureichen:

Real-time Bidding API (empfohlen)

Sie können die buyers.creatives.create der Real-time Bidding API an, Sie können Creatives zur Überprüfung einreichen.

Die API erfordert nur eine Einreichung pro Creative und ermöglicht Ihnen die Überprüfung des Status der Creative-Überprüfung.

Gebotsantwort

Sie können neue Creatives direkt in der Gebotsantwort einreichen.

Zum Senden muss das Feld declared_ad des Objekts SdkRenderedAd verwendet werden. eine Gebotsantwort mit einem Käufer-SDK-Creative zur Überprüfung.

Creatives, die in der Gebotsantwort gesendet werden, werden erst nach vielen Geboten überprüft. Alle Gebote, die vor Abschluss der Überprüfung abgegeben wurden, werden aus der Auktion herausgefiltert. Sie können die Benutzeroberfläche für Echtzeitgebote verwenden. oder Echtzeitgebote API um den Status eines Creatives nach Beginn der Überprüfung zu überprüfen.

Im Creative-Leitfaden finden Sie weitere Informationen zu erhalten Sie weitere Informationen.