참고: 리드 확보용 향상된 전환 가져오기의 경우 Google Ads UI의 리드 확보용 향상된 전환 진단 보고서를 사용하여 가져오기 상태를 모니터링하세요.

Google Ads API를 사용하여 전환 가져오기 및 조정 프로세스의 전반적인 상태에 관한 정보가 포함된 오프라인 데이터 진단을 가져옵니다.

계정의 최신 오프라인 데이터 진단을 검색하려면 다음 리소스 중 하나를 사용하세요.

• offline_conversion_upload_client_summary 계정 수준에서 가져오기 진단을 집계합니다.
• offline_conversion_upload_conversion_action_summary(v17 이상에서만 사용 가능)는 전환 액션 수준에서 가져오기 진단을 집계합니다.

계정 수준 전환 업로드 진단을 검색하려면 다음 GAQL 쿼리를 사용하세요.

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROMoffline_conversion_upload_client_summary

이 쿼리는 최근 가져오기에 사용된 각 클라이언트 유형에 대해 별도의 OfflineConversionUploadClientSummary 행을 반환합니다. 예를 들어 최근에 Google Ads API와 Google Ads UI를 모두 사용하여 가져온 경우 결과에 GOOGLE_ADS_API 및 **GOOGLE_ADS_WEB_CLIENT**의 client 값에 관한 별도의 항목이 포함됩니다.

전환 액션 수준에서 전환 업로드 진단을 검색하려면 다음 GAQL 쿼리를 사용하세요.

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROMoffline_conversion_upload_conversion_action_summaryWHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

계정 수준 진단과 마찬가지로 이 쿼리는 최근 가져오기에 사용된 각 클라이언트 유형에 대해 별도의 OfflineConversionUploadConversionActionSummary 행을 반환합니다. 예를 들어 최근에 Google Ads API와 Google Ads UI를 모두 사용하여 가져온 경우 결과에 GOOGLE_ADS_API 및 **GOOGLE_ADS_WEB_CLIENT**의 client 값에 관한 별도의 항목이 포함됩니다.

각 OfflineConversionUploadClientSummary 또는 **OfflineConversionUploadConversionActionSummary**에는 **client**의 가져오기 전반적인 상태를 반영하는 status 필드가 있습니다. 또한 다음 정보가 포함됩니다.

• 수신된 총 이벤트 수입니다.
• 성공적으로 처리된 이벤트 수입니다.
• 대기 중인 이벤트 (아직 처리 중인 이벤트) 수입니다.
• OfflineConversionError로 그룹화된 오류 요약을 제공하는 alerts 필드입니다.

이러한 모든 필드에는 가장 최근에 전체 일일 데이터를 가져온 날짜의 정보가 포함됩니다. 이 정보를 사용하여 가져온 항목의 현재 상태를 평가합니다.

또한 각 OfflineConversionUploadClientSummary 또는 **OfflineConversionUploadConversionActionSummary**에는 다음과 같은 두 가지 보고서 유형이 포함됩니다.

**daily_summaries**지난 7일 동안의 가져오기 요청 successful_count, failed_count, **pending_count**으로, 가져오기 **date별로 그룹화됩니다.job_summaries**가장 최근의 7개 가져오기 요청의 successful_count, failed_count, **pending_count**이며 **job_id**로 그룹화됩니다. **job_id**는 UploadClickConversionsRequest 및 UploadConversionAdjustmentsRequest의 선택적 필드입니다. **job_id**를 **2^31**보다 작은 양수로 설정하거나 Google Ads API가 요청에 시스템 생성 작업 ID를 할당하도록 할 수 있습니다. 선택하는 옵션에 관계없이 UploadClickConversionsResponse 또는 UploadConversionAdjustmentsResponse는 **job_id**를 반환합니다. 자체 **job_id**를 할당하는 것이 유용한 시나리오는 여러 요청을 사용하여 대량의 전환을 가져오는 단일 작업 또는 프로세스가 있는 경우입니다. 이러한 각 요청에서 **job_id**를 동일한 값으로 설정하면 **job_summaries**에서 작업의 단일 항목을 검색할 수 있습니다. 대신 Google Ads API가 각 요청의 **job_id**에 시스템 생성 값을 할당하도록 허용하면 **job_summaries**에 각 요청에 관한 별도의 항목이 포함되므로 작업의 전반적인 상태를 분석하기가 더 어려워질 수 있습니다.

가져오기 프로세스가 예상대로 전환 및 개선사항을 기록하는지 확인하려면 각 계정의 요약을 주기적으로 검색하세요. 요약의 **status**이 **EXCELLENT**가 아닌 경우 alerts 아래의 오류 목록을 참고하여 가져오기 프로세스를 수정하여 이러한 오류를 줄이거나 제거하세요.

예를 들면 다음과 같습니다.

• 상태가 **NEEDS_ATTENTION**이면 가져오기 작업의 상당 부분이 실패한 것입니다. alerts 아래의 오류를 검토하고 가져오기 프로세스를 수정하여 이러한 오류를 줄이거나 제거합니다.

• 상태가 **NO_RECENT_UPLOADS**이면 Google Ads에서 **client**에 대한 최근 가져오기를 수신하지 않은 것입니다. 예기치 않은 경우 해당 클라이언트를 사용하여 가져오기를 실행하는 프로세스를 검토합니다.

  예를 들어 **GOOGLE_ADS_API**의 **status**가 **NO_RECENT_UPLOADS**인 경우 Google Ads API를 사용하는 가져오기 프로세스가 최근에 실행 중지되었음을 나타낼 수 있습니다.

• 처리되지 않은 이벤트를 대량으로 전송한 특정 가져오기 날짜 또는 작업이 있는지 확인하려면 daily_summaries 및 **job_summaries**의 successful_count, failed_count, **pending_count**를 확인합니다. 대기 중인 상태의 이벤트는 완료되기까지 최대 24시간이 걸릴 수 있습니다.

오프라인 데이터 진단을 개선하는 방법에 관한 자세한 내용은 고객센터를 참고하세요.

가져오기 요약을 검색할 때는 다음 사항에 유의하세요.

• Google Ads API는 searchStream 또는 search 요청의 customer_id가 최근에 전환을 가져올 때 사용한 고객과 동일한 경우에만 오프라인 데이터 진단을 반환합니다.

  예를 들어 교차 계정 전환 추적을 사용하는 고객 계정에는 진단이 포함되지 않을 수 있습니다. 하지만 **customer_id**가 가져오기에 사용하는 관리자 계정의 **customer_id**와 일치하는 요청을 전송하여 진단을 검색할 수 있습니다.

• Google Ads에서는 리드 확보용 향상된 전환 가져오기의 CLICK_NOT_FOUND 오류를 경고로 처리합니다. 따라서 **alerts**에 이 오류의 항목이 포함되어 있는 경우에도 해당 작업은 여전히 성공한 것으로 간주되어 **successful_event_count**에 포함됩니다.