The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Best Practices
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Beachten Sie bei der Verwendung der Data Manager API die folgenden Best Practices.
Alle Nutzerkennungen senden
Geben Sie unabhängig davon, ob Sie Zielgruppenmitglieder oder Ereignisse mit UserData senden, so viele user_identifiers wie möglich an. Sie können auch mehrere Kennungen desselben Typs senden.
Wenn Sie beispielsweise mehrere E-Mail-Adressen für einen Nutzer haben, geben Sie für jede E-Mail-Adresse eine separate UserIdentifier an. Wenn Sie für einen Nutzer verschiedene Arten von IDs haben, z. B. E-Mail-Adressen, Telefonnummern und Adressen, fügen Sie für jede ID ein separates UserIdentifier hinzu, bis die maximale Anzahl von IDs erreicht ist.
Anfragen optimieren
Um die Wahrscheinlichkeit zu verringern, dass die Limits für die täglichen Anfragen überschritten werden, sollten Sie in jeder Anfrage so viele Elemente wie möglich einreichen, bis das Limit pro Anfrage erreicht ist.
Wenn Sie einer Zielgruppe beispielsweise 10.000 Zielgruppenmitglieder hinzufügen möchten, fügen Sie alle 10.000 Mitglieder in der Liste audience_members in einer einzigen IngestAudienceMembersRequest hinzu. Es ist wesentlich effizienter, alle 10.000 Mitglieder in einer einzigen Anfrage zu gruppieren, als für jedes Mitglied eine separate Anfrage zu senden.
Gleichzeitige Anfragen senden
Um die Gesamtzeit für die Datenaufnahme zu verkürzen, senden Sie gleichzeitige Anfragen an die IngestionService. Wir empfehlen, bis zu 10 Anfragen gleichzeitig zu senden, um die Wahrscheinlichkeit zu verringern, dass das Limit von Anfragen pro Minute überschritten wird.
Sie können gleichzeitige Anfragen senden, auch wenn die Anfragen dieselbe destinations haben.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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`."]]
