실험의 지역 데이터 가져오기

지역 실험을 위해 자동화된 데이터 가져오기 또는 대규모 데이터 가져오기를 수행하려면 Google Ads API를 사용하여 비용 및 지출 데이터를 가져와야 합니다. 그런 다음 이 데이터를 내부 CRM, 판매 시점 (POS) 또는 내부 판매 데이터베이스의 필터링되지 않고 기여도가 부여되지 않은 원시 전환 또는 수익 데이터와 결합합니다.

지리적 세그먼트별로 캠페인 및 비용 데이터를 정확하게 가져오려면 다음 아키텍처를 따르세요.

  • 서비스: GoogleAdsService, 특히 Search 또는 SearchStream 메서드를 사용합니다.

  • 리소스: geographic_view를 쿼리하여 사용자의 실제 위치 또는 관심 위치를 확인합니다. 이는 일반적으로 지역 실험의 표준입니다. 또는 location_view를 쿼리하여 캠페인에서 타겟팅하는 특정 위치를 기반으로 실적을 확인합니다.

  • 포함할 필드:

  • GAQL 쿼리 샘플: 지역 실험의 경우 광고주는 기여도가 부여된 전환 (내부 CRM 또는 서드 파티 시스템에서 가져와야 함)이 아닌 Google Ads API를 사용하여 비용 측정항목을 가져옵니다. 다음 쿼리를 사용할 수 있습니다.

    SELECT
  campaign.id,
  segments.date,
  segments.geo_target_city,
  metrics.cost_micros
FROM geographic_view
WHERE segments.date DURING LAST_30_DAYS

후처리 및 데이터 추출

  • 지역 세그먼트 매핑: API는 보고서 보기에서 일반 텍스트 이름('New York' 등) 또는 짧은 코드('501' 또는 'ES' 등)를 반환하지 않습니다. segments.geo_target_city 또는 segments.geo_target_country와 같은 필드는 GeoTargetConstant (예: geoTargetConstants/1023191)를 가리키는 리소스 이름 문자열을 반환합니다. 숫자 ID (1023191)를 추출하고 geo_target_constant 리소스를 쿼리합니다.

    SELECT
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.id = 1023191

    또는 코드에서 로컬로 조인을 수행하려면 지역 타겟에서 정적 지역 타겟 CSV를 다운로드하세요.

  • 비용 변환: API는 비용 값을 마이크로 단위로 반환합니다. metrics.cost_micros를 1,000,000으로 나누어 업로드 파일에 필요한 표준 통화 값을 출력해야 합니다.

타겟팅 변형의 위치 ID

캠페인 또는 광고 그룹 위치 타겟팅 변형을 실행할 때 광고주는 선택한 지역의 정확한 GeoTargetConstant ID (geoTargetConstants/ID)를 조회하고 전달해야 합니다. 원시 ISO 또는 Nielsen 코드는 전달할 수 없습니다.

리전 유형 필수 API ID (GeoTargetConstant) 기존 형식 (사용하지 마세요)
DMA 지역 ID 200501 (뉴욕) Nielsen 코드 (예: 뉴욕의 경우 501)
국가 신분증 2724 (스페인) ISO 코드 (예: 스페인의 경우 "ES")

권장사항 및 일반적인 형식 오류

  • 날짜 형식 지정: segments.date 필드는 YYYY-MM-DD 형식의 ISO-8601 날짜 문자열을 반환합니다. ETL 파이프라인에서 날짜 필드를 YYYY-MM-DD 문자열로 명시적으로 직렬화하고 날짜 열의 형식을 자동으로 다시 지정하는 스프레드시트 애플리케이션에서 내보낸 CSV 파일을 열지 마세요.
  • 우편번호의 선행 0: 선행 0이 삭제되지 않도록 데이터 파이프라인 전체에서 우편번호 (예: 01234)를 정수가 아닌 문자열 유형 (VARCHAR 또는 STRING)으로 처리합니다.
  • 집계: 다중 셀 연구를 실행하는 경우 각 실험 부문에 대해 별도의 지출 측정항목을 제공해야 합니다.
  • 전환 데이터 조인: 내부 CRM 시스템 또는 내부 판매 데이터베이스의 전환 데이터와 조인할 때 전환 데이터에 다음 속성이 있는지 확인하여 Google Ads API 데이터 및 GeoX로 원활하게 데이터를 처리할 수 있도록 합니다.
    • 일일 시계열: 데이터는 일별로 집계되어야 합니다.
    • 지역 수준: 모든 전환은 테스트 중인 정확한 지역 단위에 매핑되어야 합니다 (예: 고객의 배송 우편번호를 설계에 사용된 DMA 또는 우편 클러스터와 일치시킴).
    • 총 가치: 데이터는 총수익 또는 총 전환수와 같이 음수가 아닌 절댓값이어야 합니다. CRM에서 환불에 음수 값을 사용하여 순수익을 추적하는 경우 실험에 총수익을 사용하고 나중에 환불 비율을 적용해야 합니다.
이전
보고
다음
비동기 오류