Beachten Sie bei der Verwendung der Data Manager API die folgenden Best Practices.
Alle Nutzer-IDs senden
Unabhängig davon, ob Sie Zielgruppenmitglieder oder Ereignisse mit UserData senden, sollten Sie so viele user_identifiers wie möglich einbeziehen, einschließlich mehrerer Kennungen desselben Typs.
Wenn Sie beispielsweise mehrere E-Mail-Adressen für einen Nutzer haben, fügen Sie für jede E-Mail-Adresse ein separates UserIdentifier ein. Wenn Sie verschiedene Arten von Kennungen für einen Nutzer haben, z. B. E-Mail-Adressen, Telefonnummern und Adressen, fügen Sie für jede Kennung ein separates UserIdentifier-Element hinzu, bis die maximale Anzahl von Kennungen erreicht ist.
Anfragen optimieren
Um die Wahrscheinlichkeit zu verringern, dass die täglichen Limits für Anfragen überschritten werden, sollten Sie so viele Elemente wie möglich in jeder Anfrage zusammenfassen, bis die Limits pro Anfrage erreicht sind.
Wenn Sie beispielsweise 10.000 Zielgruppenmitglieder zu einer Zielgruppe hinzufügen möchten, fügen Sie alle 10.000 Mitglieder in der Liste audience_members in einem IngestAudienceMembersRequest hinzu. Es ist effizienter, alle 10.000 Mitglieder in einer einzigen Anfrage zusammenzufassen, als für jedes Zielgruppenmitglied eine separate Anfrage zu senden.
Gleichzeitige Anfragen senden
Wenn Sie die Gesamtzeit für die Datenaufnahme reduzieren möchten, senden Sie gleichzeitige Anfragen an die IngestionService. Wir empfehlen, bis zu 10 Anfragen gleichzeitig zu senden, um die Wahrscheinlichkeit zu verringern, dass das Limit für Anfragen pro Minute überschritten wird.
Sie können gleichzeitige Anfragen senden, auch wenn die Anfragen dieselbe destinations haben.
Mit validateOnly nach Fast-Fail-Fehlern suchen
Senden Sie Anfragen, bei denen validateOnly auf true gesetzt ist, um Fast-Fail-Fehler zu erfassen. Die Data Manager API führt dieselben Validierungsprüfungen wie eine reguläre Anfrage aus, nimmt aber keine Daten auf und entfernt auch keine.
Eine erfolgreiche Anfrage nur zur Validierung ist keine Garantie dafür, dass bei der Verarbeitung keine Fehler auftreten. Prüfen Sie daher die Diagnosedaten, nachdem Sie eine reguläre Anfrage gesendet haben.
Diagnoseinformationen ansehen
Erfassen Sie die request_id aus jeder IngestAudienceMembersResponse oder IngestEventsResponse und verwenden Sie die Anfrage-IDs, um die Diagnose zu prüfen.
Kontingente überwachen und Benachrichtigungen ausgeben
Um unerwartete Ablehnungen von Anfragen zu vermeiden, richten Sie in der Google Cloud Console Kontingentbenachrichtigungen und Monitoring ein. Wenn Sie die Kontingentnutzung im Blick behalten, können Sie Nutzungsmuster nachvollziehen und die Batchverarbeitung von Anfragen optimieren, bevor Ihre Anwendung die Tages- oder Minutenlimits erreicht.
Für die Produktion bereitstellen
Wenn Sie von lokalen Tests zu Produktionsarbeitslasten wechseln, verwenden Sie Standardanmeldedaten für Anwendungen mit einem angehängten Dienstkonto oder Workload Identity-Föderation, um sich nicht interaktiv und sicher zu authentifizieren.
Weitere Informationen zum Konfigurieren der Authentifizierung für verschiedene Produktionsumgebungen finden Sie unter In Produktion bereitstellen.