The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Sprawdzone metody
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 członków listy odbiorców, czy zdarzenia z UserData, uwzględnij jak najwięcej user_identifiers, w tym wysyłając wiele identyfikatorów tego samego typu.
Jeśli na przykład masz kilka adresów e-mail dla danego użytkownika, dodaj osobne UserIdentifier dla każdego z nich. Podobnie, jeśli masz identyfikatory różnych typów dla użytkownika, np. adresy e-mail, numery telefonów i adresy, dodaj osobne UserIdentifier dla każdego identyfikatora, aż do maksymalnej liczby identyfikatorów.
Prośby o zoptymalizowanie
Aby zmniejszyć prawdopodobieństwo przekroczenia dziennych limitów próśb, dodaj do każdej prośby jak najwięcej elementów, aż do limitu na prośbę.
Jeśli np. chcesz dodać do listy odbiorców 10 tys. użytkowników, dodaj wszystkich 10 tys. użytkowników z listy audience_members w jednym pliku IngestAudienceMembersRequest. Przesłanie wszystkich 10 tys. użytkowników w jednym żądaniu jest znacznie bardziej wydajne niż wysyłanie osobnego żądania dotyczącego każdego z nich.
Wysyłanie równoczesnych żądań
Aby skrócić całkowity czas przetwarzania danych, wysyłaj równoległe żądania do usługi IngestionService. Zalecamy wysyłanie do 10 żądań jednocześnie, aby zmniejszyć prawdopodobieństwo przekroczenia limitu żądań na minutę.
Możesz wysyłać równoległe żądania, nawet jeśli mają one ten sam parametr destinations.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["# Best practices\n\nKeep the following best practices in mind when using the Data Manager API.\n\nSend all user identifiers\n-------------------------\n\nWhether sending audience members or events with [`UserData`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#userdata), include as many\n`user_identifiers` as possible, including sending multiple identifiers of the\nsame type.\n\nFor example, if you have multiple email addresses for a user, include a separate\n[`UserIdentifier`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#useridentifier) for each email address. Similarly, if you have identifiers of\ndifferent types for a user, such as email addresses, phone numbers, and\naddresses, add a separate `UserIdentifier` for each identifier, up to the\n[maximum identifier count](/data-manager/api/limits#request_limits).\n\nOptimize requests\n-----------------\n\nTo reduce the likelihood of exceeding daily request limits, batch as many\nitems as possible in each request, up to the [per-request\nlimits](/data-manager/api/limits#request_limits).\n\nFor example, if you want to add 10,000 audience members to an audience, add all\n10,000 members in the `audience_members` list in one\n[`IngestAudienceMembersRequest`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestaudiencemembersrequest). Batching all 10,000 members\nin a single request is far more efficient than sending a separate request to add\neach audience member.\n\nSend concurrent requests\n------------------------\n\nTo reduce the overall time required to ingest data, send concurrent requests\nto the [`IngestionService`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice). We recommend sending up to 10\nrequests concurrently to reduce the likelihood of exceeding the [requests per\nminute limit](/data-manager/api/limits#project_limits).\n\nYou can send concurrent requests even if the requests have the same\n`destinations`."]]
