Google Ads API를 사용하여 전환 업로드 및 조정 프로세스의 전반적인 상태에 대한 정보가 포함된 오프라인 데이터 진단을 검색합니다.
계정의 최신 오프라인 데이터 진단을 가져오려면 GoogleAdsService
를 사용하여 offline_conversion_upload_client_summary
리소스에 대한 다음 쿼리를 전송합니다.
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.resource_name,
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를 모두 사용하여 업로드한 경우 결과에
GOOGLE_ADS_API
및 GOOGLE_ADS_WEB_CLIENT
의 client
값에 대한 별도의 항목이 포함됩니다.
각 OfflineConversionUploadClientSummary
에는 client
업로드 전반적인 상태를 반영하는 status
필드가 있습니다. 또한 수신된 총 이벤트 수, 성공적으로 처리된 이벤트 수, OfflineConversionError
별로 그룹화된 오류 요약을 제공하는 alerts
필드도 포함됩니다.
이러한 모든 필드에는 가장 최근 전체 업로드 날짜의 정보가 포함됩니다. 이 정보를 사용하여 업로드 동영상의 현재 상태를 평가하세요.
또한 각 OfflineConversionUploadClientSummary
에는 다음과 같은 두 가지 유형의 보고서가 포함됩니다.
daily_summaries
- 지난 7일 동안의 업로드 요청의
successful_count
및failed_count
로, 업로드date
별로 그룹화됩니다. job_summaries
job_id
별로 그룹화된 최근 업로드 요청 7개의successful_count
및failed_count
입니다.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
를 확인하여 성공적으로 처리되지 않은 많은 이벤트를 전송한 특정 업로드 날짜 또는 작업이 있는지 확인합니다.
제한사항
업로드 요약을 가져올 때는 다음 사항에 유의하세요.
Google Ads API는
searchStream
또는search
요청의customer_id
가 최근에 전환을 업로드하는 데 사용한 고객과 동일한 경우에만 오프라인 데이터 진단을 반환합니다.예를 들어 교차 계정 전환 추적을 사용하는 고객 계정에는 진단이 포함되지 않을 수 있습니다. 그러나
customer_id
가 업로드에 사용하는 관리자 계정의customer_id
와 일치하는 요청을 전송하여 진단을 검색할 수 있습니다.Google Ads에서는 리드 확보용 향상된 전환 업로드의
CLICK_NOT_FOUND
오류를 경고로 처리합니다. 따라서alerts
에 이 오류의 항목이 포함되어 있으면 상응하는 작업은 여전히 성공한 것으로 간주되어successful_event_count
에 포함됩니다.