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 콘솔에서 할당량 알림 및 모니터링을 설정하세요. 할당량 사용량을 모니터링하면 애플리케이션이 일별 또는 분당 한도에 도달하기 전에 소비 패턴을 추적하고 요청 일괄 처리를 최적화할 수 있습니다.
프로덕션에 배포
로컬 테스트에서 프로덕션 워크로드로 이동할 때는 연결된 서비스 계정 또는 워크로드 아이덴티티 제휴와 함께 애플리케이션 기본 사용자 인증 정보를 사용하여 비대화형으로 안전하게 인증하세요.
다양한 프로덕션 환경의 인증 구성에 관한 자세한 내용은 프로덕션에 배포를 참고하세요.