Schnellstartanleitung zur Ertragsoptimierung

In dieser Anleitung erfahren Sie, wie Sie Yield Optimization für eine Wiedergabekonfiguration aktivieren und überprüfen, ob sie funktioniert.

Ziel: Am Ende dieses Handbuchs verfügen Sie über eine Wiedergabekonfiguration, die das ungefüllte Anzeigeninventar automatisch mit programmatischen Anzeigen von APS füllt.

Voraussetzungen

• Eine bestehende MediaTailor Wiedergabekonfiguration mit einer Live-Inhaltsquelle.

• Eine APS-Herausgeber-ID. Sehen Sie nach, Integration mit APS ob Sie keine haben.

Schritt 1: Aktivieren Sie die Ertragsoptimierung in der Konsole

1. Öffnen Sie die MediaTailor-Konsole.

2. Wählen Sie im linken Navigationsbereich Konfigurationen aus.

3. Wählen Sie die Wiedergabekonfiguration, die Sie aktualisieren möchten.

4. Wählen Sie Bearbeiten aus.

5. Erweitern Sie den Abschnitt Einstellungen für die Ertragsoptimierung (beim Start mit einem Symbol „Neu“ gekennzeichnet). Die Beschreibung des Abschnitts lautet: „Konfiguriere die Einstellungen für die Ertragsoptimierung, einschließlich Publisher-ID, Beschränkungen für die Anzeigendauer und regionales Targeting.“

6. Stellen Sie das Aktivierungs-Dropdown-Menü auf Aktiviert ein.

7. Füllen Sie die folgenden Felder aus:

   • APS-Herausgeber-ID: Die APS-Herausgeber-ID, die Ihrem Publisher-Konto zugeordnet ist (z. B.). 8caf35b3-402b-4d75-bab2-f2aef63a66d3 Informationen dazuIntegration mit APS, wie Sie diese erhalten, finden Sie unter.

   • Unerfüllte Mindestdauer: Die Mindestdauer in Sekunden, die Yield Optimization zu erreichen versucht. Setze diesen Wert auf 15 oder höher. Bei Werten unter 15 Sekunden wird keine Werbung zurückgegeben, da APS-Werbeanzeigen in der Regel 15 Sekunden oder länger dauern.

   • Amazon Ads-Region: Die Amazon Ads-Region, an die Gebotsanfragen weitergeleitet werden. Wählen Sie eine von Americas oder Asia Pacific basierend auf Ihrer primären Zielgruppe aus. Europe Dies entspricht dem Region Feld im YieldOptimizationConfiguration API-Modell, und die Regionsnamen entsprechen den unter beschriebenen APS-RegionenIntegration mit APS.

   • OpenRTB-Vorlagenkonfiguration: Ihre JSON-Vorlage. Startpunkte finden Beispiel--Vorlagen Sie unter. Die Konsole validiert die JSON-Syntax und zeigt Fehler und Warnungen direkt an. Die Standardvorlage wird vorab mit der Startvorlage der Konsole gefüllt. Siehe Erstellung und Erstellung von Vorlagen für Angebote.

8. Wählen Sie Speichern.

Schritt 2: Konfigurieren Sie die OpenRTB-Vorlage

Die Konsole bietet einen JSON-Editor für die OpenRTB-Vorlage. Ihre Vorlage muss mindestens Folgendes enthalten:

{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}

Die Konsole warnt Sie, wenn Pflichtfelder fehlen.

Schritt 3: Starten Sie eine Sitzung und überprüfen Sie

1. Starten Sie eine Wiedergabesitzung, die Ihre Player-Parameter (Benutzeragent, IP-Adresse usw.) enthält.

2. Warten Sie auf eine Werbeunterbrechung mit ungefüllter Dauer.

3. Überprüfe die CloudWatch Kennzahlen für YieldOptimization.BidRequest undYieldOptimization.AdsInserted.

Wenn BidRequest zwar emittiert, aber 0 AdsInserted ist, überprüfen Sie das RAW_BID_REQUEST Ereignis in der, ads_interaction_log um sicherzustellen, dass Ihre Vorlage gültige Gebotsanfragen generiert.

Schritt 2 (Alternative): Konfiguration mithilfe der API

Verwenden Sie die PutPlaybackConfiguration API mit dem YieldOptimizationConfiguration Parameter:

aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'

Nächste Schritte

• Informationen zur Registrierung bei APS und zum Abrufen Ihrer Publisher-ID finden Sie unterIntegration mit APS.

• Informationen darüber, wie MediaTailor entschieden wird, wann Angebotsanfragen gestellt werden, finden Sie unterSo funktioniert die Ertragsoptimierung.

• Vollständige Beispiele für Vorlagen finden Sie unterBeispiel--Vorlagen.