Bidding with In-House Mediation

Integration für Server-zu-Server-Gebote

Die interne Mediation ist nicht öffentlich verfügbar

Interne Gebote mit Audience Network befinden sich aktuell in der Geschlossenen Beta-Phase und sind nicht öffentlich verfügbar. Sollte sich dies ändern, werden wir dies bekanntgeben.

Du kannst alternativ über eine der Mediationsplattformen, mit denen wir eine Partnerschaft unterhalten, auf Gebote im Audience Network zugreifen.

Der ORTB(Open Real-Time Bidding)-Bieter des Facebook Audience Network unterstützt sowohl direkte Clientintegrationen als auch Server-zu-Server-Integrationen. Dieser Leitfaden beschreibt die Integration von Geboten über einen Auktionsserver.

Bei der Server-zu-Server-Integration ruft ein Auktionsserver den Gebotsendpunkt des Facebook Audience Network und alle anderen Nachfragequellen auf, um Gebotsantworten zu erhalten. Der Auktionsserver führt anschließend die Auktion durch und wählt das Gewinnergebot aus. Beim Auktionsserver kann es sich um einen internen Server handeln, auf dem deine eigene Auktionslogik ausgeführt wird, oder es kann ein Server eines Drittanbieters sein, der in die App-Gebote des Audience Network integriert ist. Somit kannst du die Ressourcen des Servers und das verfügbare Netzwerk nutzen, um die Gebotsendpunkte der Nachfragequellen anzurufen. Außerdem kannst du so auch Änderungen an diesen Endpunktintegrationen vornehmen, ohne dass unbedingt Client-Updates erforderlich sind.

Voraussetzungen

Bevor du beginnst, solltest du die Übersicht über App-Gebote im Audience Network und Best Practices für die Gebotsintegration gelesen haben.

Android

iOS

Vorbereitung

Die folgenden Vorbereitungsschritte sind für interne Server-zu-Server-Gebote erforderlich:

Dein Unternehmen registrieren

Jeder Publisher muss eine Unternehmens-ID für das Audience Network erstellen, die wir der Positivliste für Gebote hinzufügen. Unter dieser Unternehmens-ID kannst du mehrere Eigenschaften erstellen, die den Gebotsendpunkt nutzen.

  • Rufe die Dokumentation des Facebook Audience Network auf und klicke auf den Button Los geht’s, um eine neue Unternehmens-ID zu erstellen, oder verwende deine vorhandene Unternehmens-ID.
  • Du kannst Assets unter derselben Unternehmens-ID erstellen, musst diese jedoch registrieren. Weitere Informationen findest du im Monetization Manager.
  • Teile uns die Unternehmens-ID mit (dies ist deine Publisher-ID).
  • Du kannst den Nutzer*innenzugriff auf dein Unternehmen/deine App verwalten.

Eine Facebook-Sicherheits-App erstellen

Alle serverseitigen internen Publisher sind verpflichtet, eine Facebook-Sicherheits-App unter https://developers.facebook.com zu erstellen. Sobald die App erstellt ist, musst du die App-ID und den App-Geheimcode für die Sicherheits-App abrufen. Der App-Geheimcode wird in jeder Anfrage verwendet, um ein Authentifizierungstoken zur Validierung des Absenders der Anfrage zu erstellen.

Stelle sicher, dass du den richtigen Hash (unten angegeben) verwendest und dass der Hash nicht verloren geht, wenn er mit einer 0 beginnt.

So erstellst du eine Sicherheits-App und verlinkst sie mit deinem Unternehmen:

  1. Melde dich bei https://developers.facebook.com an.
  2. Klicke im Menü Meine Apps auf „App erstellen“.
  3. Wähle Unternehmen aus und klicke dann auf Weiter.
  4. Gib für die App einen Namen mit dem Präfix „AN_SECURITY_APP“ an und klicke dann auf App-ID erstellen.
  5. Wähle im linken Menü Einstellungen → Allgemeines aus.
  6. Klicke im Feld App-Geheimcode auf Anzeigen. Notiere dir deine App-ID und den App-Geheimcode auf.
  7. Rufe https://business.facebook.com auf und wähle dein Unternehmen aus.
  8. Klicke im linken Menü auf Unternehmenseinstellungen.
  9. Wähle im linken Menü der Seite UnternehmenseinstellungenKonten → Apps aus.
  10. Klicke im Bereich Apps auf Hinzufügen → App hinzufügen.
  11. Gib die App-ID deiner Sicherheits-App ein und klicke dann auf App hinzufügen. Deine AN_SECURITY_APP sollte jetzt unter deinem Unternehmen aufgeführt sein.

Die anfragespezifische authentication_id wird mit dem HMAC-SHA256-Algorithmus generiert. Dieser Algorithmus nutzt folgende Eingaben:

  • Die Anfrage-ID als Nachricht
  • Den App-Geheimniscode als Schlüssel
      authentication_id = HMAC_SHA256(request_id, app_secret)

Die generierte ID wird dann zur Erweiterung der OpenRTB-Gebotsanfrage in der obersten Ebene im authentication_id-Feld hinzugefügt. Wenn die Anfrage-ID beispielsweise „9r90wurjqw“ und der App-Geheimcode „12345asdfg“ wird die authentication_id wie folgt generiert:

      authentication_id = HMAC_SHA256(9r90wurjqw, 12345asdfg) = 39bbe40bc68899a9356085ca8c81

Dieses Token wird in jeder Anfrage zusammen mit der App-ID der Sicherheits-App aufgenommen.

      {
      "id": "9r90wurjqw",
      ...
      "ext": {
      "authentication_id": "39bbe40bc68899a9356085ca8c81d3021cfa124f2a2b3c68c88f95fb4cde40a4",
      "security_app_id": "AN_SECURITY_APP_MY_SECURITY_APP_ID" 
      ...
      }
      }

Dein Identitäts-Token an den Bieter übergeben

Unser Bieter erwartet ein Identitäts-Token im Feld user.buyeruid der ORTB-Anfrage. Dieses Token wird für verschiedene Plattformen auf unterschiedliche Arten generiert.

Android

Rufe com.facebook.ads.BidderTokenProvider.getBidderToken() aus dem Android Audience Network SDK in einem Hintergrundthread auf. Das Token muss für jede Gebotsanfrage angefragt werden. Übergib außerdem die IDFA im Feld device.ifa an AdvertisingIdClient.getAdvertisingIdInfo(context).getId().

iOS

Rufe [FBAdSettings bidderToken] aus dem iOS Audience Network SDK auf. Das Token muss für jede Gebotsanfrage angefragt werden. Übergib außerdem die IDFA im Feld device.ifa mit [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString].

Nächste Schritte