The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
แนวทางปฏิบัติที่ดี
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
โปรดคํานึงถึงแนวทางปฏิบัติแนะนําต่อไปนี้เมื่อใช้ Data Manager API
ส่งตัวระบุผู้ใช้ทั้งหมด
ไม่ว่าจะส่งสมาชิกกลุ่มเป้าหมายหรือเหตุการณ์ด้วย UserData
ให้ใส่user_identifiers
ให้ได้มากที่สุด รวมถึงส่งตัวระบุประเภทเดียวกันหลายรายการ
เช่น หากคุณมีอีเมลหลายรายการสำหรับผู้ใช้รายหนึ่ง ให้ใส่ UserIdentifier
แยกต่างหากสำหรับอีเมลแต่ละรายการ ในทํานองเดียวกัน หากคุณมีตัวระบุประเภทต่างๆ สําหรับผู้ใช้ เช่น อีเมล หมายเลขโทรศัพท์ และที่อยู่ ให้เพิ่ม UserIdentifier
แยกกันสําหรับตัวระบุแต่ละรายการ โดยไม่เกินจํานวนตัวระบุสูงสุด
เพิ่มประสิทธิภาพคำขอ
หากต้องการลดโอกาสที่คำขอจะเกินขีดจำกัดรายวัน ให้ส่งคำขอแต่ละรายการเป็นกลุ่มๆ โดยส่งรายการให้ได้มากที่สุดตามขีดจำกัดต่อคำขอ
เช่น หากต้องการเพิ่มสมาชิกกลุ่มเป้าหมาย 10,000 คนลงในกลุ่มเป้าหมาย ให้เพิ่มสมาชิกทั้งหมด 10,000 คนในรายการ audience_members
รายการเดียวใน IngestAudienceMembersRequest
การรวมสมาชิกทั้ง 10,000 คนไว้ในคําขอเดียวมีประสิทธิภาพมากกว่าการส่งคําขอแยกต่างหากเพื่อเพิ่มสมาชิกกลุ่มเป้าหมายแต่ละคน
ส่งคำขอหลายรายการพร้อมกัน
หากต้องการลดเวลาโดยรวมในการนำเข้าข้อมูล ให้ส่งคำขอพร้อมกันไปยัง IngestionService
เราขอแนะนำให้ส่งคำขอพร้อมกันไม่เกิน 10 รายการเพื่อลดโอกาสที่จะมีคำขอเกินขีดจำกัดต่อนาที
คุณส่งคำขอพร้อมกันได้แม้ว่าคำขอจะมีdestinations
เดียวกันก็ตาม
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 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`."]]