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
を含めます。
たとえば、ユーザーに複数のメールアドレスがある場合は、メールアドレスごとに個別の UserIdentifier
を含めます。同様に、メールアドレス、電話番号、住所など、ユーザーの異なるタイプの識別子がある場合は、識別子の最大数まで、識別子ごとに個別の UserIdentifier
を追加します。
リクエストを最適化する
1 日あたりのリクエスト数の上限を超える可能性を減らすには、リクエストごとの上限まで、各リクエストにできるだけ多くのアイテムをバッチ処理します。
たとえば、オーディエンスに 10,000 人のオーディエンス メンバーを追加する場合は、audience_members
リスト内の 10,000 人のメンバーをすべて 1 つの IngestAudienceMembersRequest
に追加します。10,000 人すべてのメンバーを 1 つのリクエストでバッチ処理する方が、オーディエンス メンバーごとに個別のリクエストを送信するよりもはるかに効率的です。
同時リクエストを送信する
データの取り込みに必要な全体的な時間を短縮するには、IngestionService
に同時リクエストを送信します。1 分あたりのリクエスト数の上限を超える可能性を減らすため、最大 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`."]]