Data Manager API를 사용할 때는 다음 권장사항에 유의하세요.
모든 사용자 식별자 전송
UserData를 사용하여 잠재고객 구성원 또는 이벤트를 전송하는 경우 동일한 유형의 여러 식별자를 전송하는 등 최대한 많은 user_identifiers를 포함하세요.
예를 들어 사용자의 이메일 주소가 여러 개인 경우 각 이메일 주소에 별도의 UserIdentifier를 포함합니다. 마찬가지로 이메일 주소, 전화번호, 주소와 같이 사용자에게 다양한 유형의 식별자가 있는 경우 각 식별자에 대해 별도의 UserIdentifier를 최대 식별자 수까지 추가합니다.
요청 최적화
일일 요청 한도를 초과할 가능성을 줄이려면 각 요청에서 가능한 한 많은 항목을 요청당 한도까지 일괄 처리하세요.
예를 들어 잠재고객에 잠재고객 구성원 10,000명을 추가하려면 하나의 IngestAudienceMembersRequest에서 audience_members 목록에 구성원 10,000명을 모두 추가합니다. 10,000명의 구성원을 모두 단일 요청으로 일괄 처리하는 것이 각 잠재고객 구성원을 추가하기 위해 별도의 요청을 전송하는 것보다 더 효율적입니다.
동시 요청 전송
데이터를 수집하는 데 필요한 전체 시간을 줄이려면 IngestionService에 동시 요청을 보냅니다. 분당 요청 한도를 초과할 가능성을 줄이려면 최대 10개의 요청을 동시에 전송하는 것이 좋습니다.
요청에 동일한 destinations가 있더라도 동시 요청을 보낼 수 있습니다.
validateOnly를 사용하여 빠른 실패 오류 확인
validateOnly를 true로 설정하여 요청을 전송하고 빠른 실패 오류를 포착합니다. Data Manager API는 일반 요청과 동일한 검증 확인을 실행하지만 데이터를 수집하거나 삭제하지 않습니다.
검증 전용 요청이 성공하더라도 처리 중에 오류가 발생하지 않는다고 보장할 수 없으므로 일반 요청을 보낸 후에도 계속 진단을 확인하세요.
진단 확인
각 IngestAudienceMembersResponse 또는 IngestEventsResponse에서 request_id를 캡처하고 수집하고 요청 ID를 사용하여 진단을 확인합니다.
할당량 모니터링 및 알림
예기치 않은 요청 거부를 방지하려면 Google Cloud 콘솔에서 할당량 알림 및 모니터링을 설정하세요. 할당량 사용량을 모니터링하면 애플리케이션이 일일 또는 분당 한도에 도달하기 전에 소비 패턴을 추적하고 요청 일괄 처리를 최적화할 수 있습니다.
프로덕션에 배포
로컬 테스트에서 프로덕션 워크로드로 이동할 때는 연결된 서비스 계정 또는 워크로드 아이덴티티 제휴와 함께 애플리케이션 기본 사용자 인증 정보를 사용하여 비대화형으로 안전하게 인증합니다.
다양한 프로덕션 환경의 인증 구성에 대한 자세한 내용은 프로덕션에 배포를 참조하세요.