The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
En iyi uygulamalar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Veri Yöneticisi API'sini kullanırken aşağıdaki en iyi uygulamaları göz önünde bulundurun.
Tüm kullanıcı tanımlayıcılarını gönderme
UserData ile kitle üyeleri veya etkinlikler gönderirken aynı türden birden fazla tanımlayıcı göndermek de dahil olmak üzere mümkün olduğunca fazla user_identifiers ekleyin.
Örneğin, bir kullanıcı için birden fazla e-posta adresiniz varsa her e-posta adresi için ayrı bir UserIdentifier ekleyin. Benzer şekilde, bir kullanıcı için e-posta adresleri, telefon numaraları ve adresler gibi farklı türde tanımlayıcılarınız varsa maksimum tanımlayıcı sayısına kadar her tanımlayıcı için ayrı bir UserIdentifier ekleyin.
İstekleri optimize etme
Günlük istek sınırlarını aşma olasılığını azaltmak için her istekte istek başına sınırlara kadar mümkün olduğunca çok öğeyi gruplandırın.
Örneğin, bir kitleye 10.000 kitle üyesi eklemek istiyorsanız audience_members listesindeki 10.000 üyenin tamamını tek bir IngestAudienceMembersRequest içine ekleyin. 10.000 üyenin tümünü tek bir istekle gruplandırmak,her kitle üyesini eklemek için ayrı bir istek göndermekten çok daha verimlidir.
Eşzamanlı istekler gönderme
Verileri beslemek için gereken toplam süreyi azaltmak amacıyla IngestionService adresine eşzamanlı istekler gönderin. Dakika başına istek sınırını aşma olasılığını azaltmak için aynı anda en fazla 10 istek göndermenizi öneririz.
İstekler aynı destinations olsa bile eşzamanlı istek gönderebilirsiniz.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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`."]]
