이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오프라인 데이터 진단 모니터링

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
FROM offline_conversion_upload_client_summary

이 쿼리는 OfflineConversionUploadClientSummary 최근 업로드에 사용된 각 클라이언트 유형에 대한 행입니다. 예를 들어 Google Ads API와 Google Ads UI를 모두 사용하여 최근에 업로드한 경우 client 값에 대한 별도의 항목을 포함하고 GOOGLE_ADS_API 및 GOOGLE_ADS_WEB_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
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >

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

요약 해석 방법

각 OfflineConversionUploadClientSummary 또는 OfflineConversionUploadConversionActionSummary에는 status 필드가 있습니다. 인코더-디코더는 전반적인 상태 client에 대한 업로드 수 또한 다음 정보도 포함되어 있습니다.

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

이 모든 입력란에는 가장 최근 하루 전체의 정보가 포함됩니다. 총 업로드 수 이 정보를 사용하여 업로드 동영상의 현재 상태를 평가하세요.

또한 각 OfflineConversionUploadClientSummary 또는 OfflineConversionUploadConversionActionSummary에 서로 다른 두 개의 보고서 유형:

daily_summaries

업로드 요청의 successful_count, failed_count, pending_count 지난 7일간 업로드 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를 사용하는 업로드 프로세스의 실행이 중지되었음을 의미할 수 있습니다. 최근
특정 업로드 날짜 또는 대량의 successful_count, failed_count, 그리고 daily_summaries 및 job_summaries 중 pending_count입니다. 대기 중 상태인 이벤트는 최대 24시간이 걸릴 수 있습니다. 완료합니다.

제한사항

업로드 요약을 가져올 때는 다음 사항에 유의하세요.

Google Ads API는 다음과 같은 경우에만 오프라인 데이터 진단을 반환합니다. customer_id searchStream 또는 search 요청은 최근에 사용한 것과 동일한 고객입니다. 전환 업로드

예를 들어 교차 계정 전환 추적을 사용하는 고객 계정은 진단을 포함하지 않습니다. 하지만 customer_id가 관리자의 customer_id와 일치하는 요청 계정을 만들 수 있습니다.
Google Ads에서는 향상된 전환의 CLICK_NOT_FOUND 오류를 리드가 주의로 업로드됨 따라서 alerts에 이 오류의 항목이 포함된 경우 상응하는 연산도 성공한 것으로 간주되어 successful_event_count입니다.

전환 가치 규칙

보고