Podczas korzystania z interfejsu Data Manager API pamiętaj o tych sprawdzonych metodach.
Wysyłanie wszystkich identyfikatorów użytkowników
Niezależnie od tego, czy wysyłasz odbiorców czy zdarzenia za pomocą UserData, uwzględnij jak najwięcej parametrów user_identifiers, w tym wiele identyfikatorów tego samego typu.
Jeśli na przykład masz kilka adresów e-mail użytkownika, dodaj osobny element UserIdentifier dla każdego z nich. Podobnie, jeśli masz identyfikatory różnych typów dla użytkownika, takie jak adresy e-mail, numery telefonów i adresy, dodaj osobny element UserIdentifier dla każdego identyfikatora, aż do maksymalnej liczby identyfikatorów.
Optymalizacja żądań
Aby zmniejszyć prawdopodobieństwo przekroczenia dziennych limitów żądań, w każdym żądaniu umieść jak najwięcej elementów, nie przekraczając limitów na żądanie.
Jeśli na przykład chcesz dodać do grupy odbiorców 10 000 użytkowników, dodaj ich wszystkich do listy audience_members w jednym pliku IngestAudienceMembersRequest. Przesłanie wszystkich 10 000 odbiorców w jednym żądaniu jest bardziej efektywne niż wysyłanie osobnego żądania dla każdego odbiorcy.
Wysyłanie żądań równoczesnych
Aby skrócić łączny czas potrzebny na pozyskanie danych, wysyłaj żądania równoczesne do IngestionService. Zalecamy wysyłanie maksymalnie 10 żądań jednocześnie, aby zmniejszyć prawdopodobieństwo przekroczenia limitu żądań na minutę.
Możesz wysyłać żądania równoczesne, nawet jeśli mają tę samą wartość destinations.
Używanie validateOnly do sprawdzania błędów powodujących szybkie niepowodzenie
Wysyłaj żądania z parametrem validateOnly ustawionym na true, aby wychwytywać błędy typu fast-fail. Interfejs Data Manager API przeprowadza te same testy poprawności co zwykłe żądanie, ale nie pozyskuje ani nie usuwa żadnych danych.
Żądanie tylko do walidacji, które zakończyło się powodzeniem, nie gwarantuje, że podczas przetwarzania nie wystąpią błędy, dlatego po wysłaniu zwykłego żądania nadal sprawdzaj diagnostykę.
Sprawdź diagnostykę
Zarejestruj i zbierz request_id z każdego elementu IngestAudienceMembersResponse lub IngestEventsResponse i użyj identyfikatorów żądań, aby sprawdzić informacje diagnostyczne.
Monitorowanie limitów i alerty o nich
Aby uniknąć nieoczekiwanych odrzuceń żądań, skonfiguruj alerty dotyczące limitów i monitorowanie w konsoli Google Cloud. Monitorowanie wykorzystania limitów pomaga śledzić wzorce wykorzystania i optymalizować grupowanie żądań, zanim aplikacja osiągnie limity dzienne lub minutowe.
Wdrażanie w środowisku produkcyjnym
Przechodząc z testowania lokalnego do zadań produkcyjnych, używaj domyślnego uwierzytelniania aplikacji z dołączonym kontem usługi lub federacją tożsamości zadań, aby uwierzytelniać się w sposób nieinteraktywny i bezpieczny.
Szczegółowe informacje o konfigurowaniu uwierzytelniania w różnych środowiskach produkcyjnych znajdziesz w artykule na temat wdrażania w środowisku produkcyjnym.