The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
最佳做法
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用 Data Manager API 時,請務必遵循下列最佳做法。
傳送所有使用者 ID
無論您是使用 UserData
傳送目標對象成員或事件,請盡可能加入 user_identifiers
,包括傳送多個相同類型的 ID。
舉例來說,如果您有使用者的多個電子郵件地址,請為每個電子郵件地址加入個別的 UserIdentifier
。同樣地,如果您為使用者提供不同類型的 ID (例如電子郵件地址、電話號碼和地址),請為每個 ID 新增個別的 UserIdentifier
,最多可達最大 ID 數量。
最佳化要求
為降低超過每日要求限制的可能性,請在每項要求中盡可能將項目批次處理,最多可達每項要求的限制。
舉例來說,如果您想將 10,000 位目標對象成員加入目標對象,請在一個 IngestAudienceMembersRequest
中加入 audience_members
清單中的所有 10,000 位成員。在單一要求中批次新增所有 10,000 位成員,比起傳送個別要求來新增每位目標對象,效率高出許多。
傳送並行要求
如要縮短擷取資料所需的整體時間,請將並行要求傳送至 IngestionService
。建議您同時傳送最多 10 個要求,以降低超出每分鐘要求數量限制的可能性。
即使要求具有相同的 destinations
,您仍可傳送並行要求。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],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`."]]