Kontingent

Das Kontingent für die Display & Video 360 API begrenzt die Rate, mit der ein Projekt Anfragen an die API senden kann.

Mit diesen Best Practices können Sie Ihr Display & Video 360 API-Kontingent besser nutzen.

Gleichzeitig Anfragen für mehrere Werbetreibende stellen

Das Display & Video 360 API-Kontingent wird pro Projekt und pro Werbetreibenden festgelegt. Projektkontingentlimits beschränken die Anfragen, die von einem Projekt gestellt werden. Das Werbetreibendenkontingent beschränkt die Anfragen, die von einem Projekt an einen Werbetreibenden gesendet werden.

Wenn Sie Ihr gesamtes Projektkontingent nutzen möchten, müssen Sie Anfragen für mehrere Werbetreibende gleichzeitig senden.

list-Abfrageparameter verwenden

Verwenden Sie list-Methodenabfrageparameter, um nur die gewünschten Ressourcen einzuschließen. Weniger Ressourcen erfordern weniger Anfragen für die Auflistung.

list-Methoden bieten drei wichtige Parameter:

  • Mit pageSize wird die Anzahl der Ressourcen festgelegt, die vom Request zurückgegeben werden können. Die Standardseitengröße hängt von der Methode ab. Legen Sie hier den höchsten Wert fest, um mehr Ressourcen pro Anfrage aufzulisten.
  • Mit filter werden die aufgeführten Ressourcen anhand der angegebenen Kriterien eingeschränkt. Legen Sie diesen Wert fest, um nur eine Teilmenge von Ressourcen aufzulisten. Weitere Informationen finden Sie unter Anfragen für Filterlisten.
  • Mit orderBy werden die aufgeführten Ressourcen nach dem angegebenen Attribut sortiert. Legen Sie diesen Wert fest, um die Obergrenze oder Untergrenze der Ressourcenliste mit weniger Anfragen abzurufen.

Bulk- und ressourcenweite Funktionen verwenden

Bulk- und ressourcenweite Funktionen führen komplexe Aufgaben aus. Eine einzelne Anfrage an diese Methoden kann mehrere Anfragen an andere ersetzen.

Weitere Informationen zu diesen Methoden finden Sie unter Bulk-Anfragen.

Cache-IDs

Für viele Aktionen in der Display & Video 360 API sind IDs erforderlich, die über die API abgerufen werden. Beispiele sind IDs für Ausrichtungsoptionen und Google-Zielgruppen-IDs. Speichern Sie IDs lokal, damit Sie sie nicht immer wieder abrufen müssen.

Wenn Sie IDs für Ressourcen verwenden, die eingestellt oder gelöscht wurden, kann ein Fehler zurückgegeben werden. Sie sollten gecachte IDs wöchentlich abrufen, um ihren Status zu bestätigen.

Exponentiellen Backoff verwenden

Der exponentielle Backoff ist eine Strategie zur Fehlerbehandlung. Anfragen werden über einen immer längeren Zeitraum hinweg wiederholt.

Beim Polling eines lang andauernden Vorgangs, z. B. eines SDF-Downloadvorgangs, kann die Anzahl der gesendeten Anfragen durch eine exponentielle Backoff-Strategie reduziert werden.

In unseren SDF-Download-Codebeispielen wird exponentieller Backoff mit unseren Clientbibliotheken verwendet. Das folgende Beispiel zeigt den Ablauf des exponentiellen Backoffs:

  • Rufen Sie das Operation-Objekt mit der Anfrage get ab.
    • Wenn done nicht „true“ ist, wird die Aufgabe noch ausgeführt.
    • Warten Sie 5 Sekunden + eine zufällige Anzahl von Sekunden und wiederholen Sie die Anfrage.
  • Rufen Sie den Vorgang ab.
    • Wenn done nicht „true“ ist, wird der Task weiterhin ausgeführt.
    • Warten Sie 10 Sekunden + eine zufällige Anzahl von Sekunden und wiederholen Sie die Anfrage.
  • Rufen Sie den Vorgang ab.
    • Wenn done nicht „true“ ist, wird der Task weiterhin ausgeführt.
    • Warten Sie 20 Sekunden + eine zufällige Anzahl von Sekunden und wiederholen Sie die Anfrage.
  • Rufen Sie den Vorgang ab.
    • Wenn done nicht „true“ ist, wird der Task weiterhin ausgeführt.
    • Warten Sie 40 Sekunden + eine zufällige Anzahl von Sekunden und wiederholen Sie die Anfrage.
  • Rufen Sie den Vorgang ab.
    • Wenn done nicht „true“ ist, wird der Task weiterhin ausgeführt.
    • Warten Sie 80 Sekunden + eine zufällige Anzahl von Sekunden und wiederholen Sie die Anfrage.
  • Setzen Sie dieses Muster fort, bis done wahr ist oder eine maximale Zeit abgelaufen ist.