Google Ads 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Reporting API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ |
1. 통합 전 준비 작업
1.1 Developer token 신청
Google Ads Manager Account로 Google Ads 백엔드에 로그인하고 오른쪽 상단 메뉴에서 TOOLS & SETTINGS - SETUP - API Center를 선택한 후 Google Ads API Token Application을 작성하여 Developer token 신청을 완료합니다.
액세스 권한이 Basic Level인 Developer Token, 즉 신청이 승인된 Developer Token을 제공해야 하며, 권한이 Test Account인 Developer Token은 사용할 수 없습니다.
더 빠르게 신청을 마칠 수 있도록 신청서의 일부 질문에 대한 답변을 정리해 두었으니 이 문서를 참고하십시오. 또한 공식 문서에서 Developer token에 관한 더 많은 정보를 확인할 수 있습니다:
신청서를 작성한 후 Token Review Team이 Developer Token을 승인할 때까지 기다려야 합니다. 심사는 대부분 1영업일 이내에 완료되며, 일반적으로 3일을 넘지 않습니다.
1.2 Client ID와 Client Secret 생성
Developer Token을 가져오는 동시에 API 액세스 자격 증명, 즉 Client ID와 Client Secret도 생성해야 합니다. API 자격 증명을 생성하기 전에 Google Cloud Platform에 Google Ads API가 활성화된 프로젝트가 있어야 합니다. 이 절의 안내에 따라 Client ID와 Client Secret을 생성할 수 있습니다.
1.2.1 Google Cloud Platform에서 프로젝트 생성
Google Cloud Platform에서 아직 프로젝트를 생성하지 않았다면 Google Cloud Platform에 로그인하여 CREATE PROJECT를 클릭하고 프로젝트를 생성합니다. 이미 프로젝트를 생성했다면 이 단계를 건너뛸 수 있습니다.
그림 1. 새 프로젝트 예시
1.2.2 Google Ads API 권한 활성화
프로젝트를 생성한 후에는 Google Ads API 권한을 활성화해야 합니다. Google Cloud Platform 백엔드 상단의 검색창에서 Google Ads API를 검색하여 소개 페이지로 이동합니다. 페이지에서 아래 그림의 영역에 ENABLE이 표시되면 프로젝트에서 아직 Google Ads API 권한이 활성화되지 않은 것입니다. ENABLE을 클릭하여 권한을 활성화하면 됩니다.
그림 2. Google Ads API 소개 페이지
1.2.3 API 자격 증명을 생성하여 Client ID와 Client Secret 가져오기
Google Ads API 권한을 활성화한 후에는 Google Ads API 권한이 있는 API 자격 증명, 즉 데이터를 수집할 때 필요한 Client ID와 Client Secret을 생성해야 합니다.
- Google Ads API 권한을 활성화하면 다음 페이지로 이동합니다. 아래 그림의 빨간 상자에 있는 CREATE CREDENTIALS를 클릭하면 자격 증명 생성 절차로 들어갑니다.
- 위 페이지를 찾지 못한 경우 페이지 왼쪽 상단의 메뉴에서 APIs & Services - Enabled APIs & services로 이동할 수도 있습니다. 목록에서 Google Ads API를 찾아 클릭하면 아래 그림의 페이지로 이동합니다. 여기에서 CREDENTIALS 탭을 선택하고 + CREATE CREDENTIALS를 클릭한 후 Help me choose를 선택해도 자격 증명 생성 절차로 들어갈 수 있습니다.
자격 증명 생성 절차에 들어가면 다음 단계에 따라 설정을 완료하십시오
- Credential Type 페이지에서 Google Ads API, User Data를 차례로 선택하고 NEXT를 클릭합니다
- Scopes 페이지에서 ADD OR REMOVE SCOPES를 클릭하고 목록에서 Google Ads API를 찾아 체크하여 Scope 목록에 추가합니다. SAVE AND CONTINUE를 클릭합니다
- OAuth Client ID 페이지의 Application type에서 Web application을 선택합니다
- 같은 OAuth Client ID 페이지의 Authorized redirect URIs에서 콜백 주소를 설정합니다. 아직 AE 시스템에서 계획을 생성하지 않았으므로 인증 주소에는 우선 https://www.example.com을 입력하고, 계획을 생성한 후 정식 콜백 주소로 수정하십시오.
- 모든 설정을 마친 후 CREATE를 클릭하여 자격 증명을 생성합니다. 생성이 완료되면 페이지에 Client ID와 Client Secret이 표시되므로 이 두 정보를 안전하게 보관하십시오
- 마지막으로 OAuth consent screen으로 이동하여 Publishing status 항목에서 PUBLISH APP을 클릭하여 앱을 정식 버전으로 게시합니다
1.3 Customer ID와 Login Customer ID 가져오기
마지막으로 데이터를 수집할 광고 계정의 Customer ID와 해당 유저의 광고 관리자 계정의 Customer ID(이후 호출에서 사용하는 Login Customer ID)를 준비하십시오. 다음 절차에 따라 이 ID들을 확인할 수 있습니다.
- Google Ads 백엔드에서 데이터를 수집할 광고 계정으로 로그인합니다
- 오른쪽 상단의 도움말 아이콘을 클릭합니다
- 메뉴 하단에서 Customer ID를 찾습니다
- 광고 관리자 계정으로 전환하여 위 절차에 따라 Customer ID를 가져오면 이것이 Login Customer ID입니다(광고 관리자 계정의 관리자에게서 Customer ID를 직접 받을 수도 있습니다)
1.4 요약
이로써 Google 플랫폼에서의 연동 준비 작업을 마쳤습니다. 다음 정보를 가져왔는지 확인하십시오:
- Develop Token
- Client ID
- Client Secret
- Login Customer ID, 즉 광고 관리자의 Customer ID
- 데이터를 수집할 모든 광고 계정의 Customer ID
2. 계획 설정
Google 플랫폼에서 준비 작업을 마친 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 아래 그림은 Google Ads의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고 팝업 창에 이전 단계에서 얻은 정보를 입력합니다:
2.2 동기화
동기화 모듈에서 AE 시스템이 Google Ads Reporting API 데이터를 정기적으로 수집하는 정책을 설정할 수 있으며, 매일 특정 시각에 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기적으로 수집하지 않는 것을 권장합니다
2.3 저장 설정
데이터를 이벤트 형태로 기록할지 제어할 수 있습니다. 끄면 데이터가 이벤트 테이블에 기록되지 않으므로 이 설정을 끄지 마십시오.
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름, 커스텀 가능, JSON 타입. Key는 source.report_types에 대응하고, Value는 해당 resource 데이터의 이벤트 이름입니다. sink_event.event_name과 상호 배타적입니다 |
| event_name | 저장 후 이벤트 이름, 커스텀 가능, 문자열 타입. 수신한 데이터는 모두 이 이름을 이벤트 이름으로 사용합니다. sink_event.event_mapping과 상호 배타적입니다 | |
| source | report_types | 수집할 resource, 즉 수집할 리포트의 이름. 리스트 타입이며, 요소를 하나만 입력하여 한 번에 하나의 리포트 데이터만 수집할 것을 권장합니다 선택 가능한 값: ad_group_ad_asset_view, ad_group_ad, conversion_action, campaign, geographic_view 및 기타 resources. 자세한 내용은 이어지는 내용을 참고하십시오 |
| metrics | 데이터의 지표, 리스트 타입. 계층마다 지원하는 metrics가 다르므로 입력 시 주의 필요 | |
| group_by | 데이터의 그룹 차원, 리스트 타입. 계층마다 지원하는 group_by가 다르므로 입력 시 주의 필요 | |
| extra_params | date_key | 데이터의 시간 필드 |
| where | 추가 필터 조건, GAQL 문법을 사용해야 합니다 |
계층마다 데이터 설정이 크게 다르므로 각 계층의 설정 템플릿을 그대로 사용하거나 템플릿을 조금 수정하여 사용할 것을 권장합니다
2.4.1 Ad Group Ad Asset View 템플릿
Ad Group Ad Asset View는 ad group 계층과 asset 계층을 합친 리포트입니다. 다음은 이 인터페이스의 템플릿이며, 전체를 그대로 복사하여 통합 설정에 붙여 넣을 수 있습니다. 조정이 필요하면 공식 문서를 확인하여 metrics로 시작하는 지표는 source.metrics에, 그 밖의 차원 필드는 source.group_by에 추가하십시오:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"ad_group_ad_asset_view"
],
"metrics":
[
"metrics.all_conversions",
"metrics.all_conversions_value",
"metrics.all_conversions_value_per_cost",
"metrics.average_cpc",
"metrics.clicks",
"metrics.conversions",
"metrics.conversions_value",
"metrics.conversions_value_per_cost",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.ctr",
"metrics.impressions",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.biddable_app_install_conversions"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"ad_group_ad.ad.id",
"ad_group_ad.ad.name",
"asset.id",
"asset.name",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"ad_group_ad.action_items",
"asset.youtube_video_asset.youtube_video_title",
"asset.youtube_video_asset.youtube_video_id"
]
}
}
- 템플릿은 데이터의 segments.date 필드, 즉 데이터의 날짜를 데이터 시간으로 사용합니다
- 템플릿에서 사용하는 이벤트 이름 -- google_ads_ad_group_ad_asset_view
2.4.2 Ad Group Ad 템플릿
Ad Group Ad로 Ad 계층의 데이터를 확인할 수 있으며, ad group, campaign 계층의 차원도 사용할 수 있습니다. 다음은 이 인터페이스의 템플릿이며, 전체를 그대로 복사하여 통합 설정에 붙여 넣을 수 있습니다. 조정이 필요하면 공식 문서를 확인하여 metrics로 시작하는 지표는 source.metrics에, 그 밖의 차원 필드는 source.group_by에 추가하십시오:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"ad_group_ad"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks",
"metrics.conversions",
"metrics.ctr",
"metrics.average_cpm",
"metrics.average_cpe",
"metrics.average_cpc",
"metrics.trueview_average_cpv",
"metrics.average_cost",
"metrics.all_conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.active_view_cpm",
"metrics.active_view_ctr",
"metrics.video_trueview_views",
"metrics.video_trueview_view_rate",
"metrics.video_quartile_p25_rate",
"metrics.video_quartile_p50_rate",
"metrics.video_quartile_p75_rate",
"metrics.video_quartile_p100_rate"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"ad_group_ad.ad.id",
"ad_group_ad.ad.name",
"campaign.bidding_strategy",
"campaign.bidding_strategy_type",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"campaign.app_campaign_setting.bidding_strategy_goal_type",
"ad_group_ad.action_items"
]
}
}
- 템플릿은 데이터의 segments.date 필드, 즉 데이터의 날짜를 데이터 시간으로 사용합니다
- 템플릿에서 사용하는 이벤트 이름 -- google_ads_ad_group_ad
2.4.3 Conversion Action 템플릿
Conversion Action은 전환 행동 데이터 분석에 초점을 맞춘 리포트입니다. 다음은 이 인터페이스의 템플릿이며, 전체를 그대로 복사하여 통합 설정에 붙여 넣을 수 있습니다. 조정이 필요하면 공식 문서를 확인하여 metrics로 시작하는 지표는 source.metrics에, 그 밖의 차원 필드는 source.group_by에 추가하십시오:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"conversion_action"
],
"metrics":
[
"metrics.all_conversions",
"metrics.all_conversions_value"
],
"group_by":
[
"customer.id",
"segments.date",
"customer.manager",
"customer.time_zone",
"customer.tracking_url_template",
"customer.auto_tagging_enabled",
"customer.conversion_tracking_setting.conversion_tracking_id",
"customer.conversion_tracking_setting.cross_account_conversion_tracking_id",
"customer.currency_code",
"customer.descriptive_name",
"conversion_action.app_id",
"conversion_action.attribution_model_settings.attribution_model",
"conversion_action.attribution_model_settings.data_driven_model_status",
"conversion_action.category",
"conversion_action.click_through_lookback_window_days",
"conversion_action.counting_type",
"conversion_action.id",
"conversion_action.include_in_conversions_metric",
"conversion_action.mobile_app_vendor",
"conversion_action.name",
"conversion_action.owner_customer",
"conversion_action.phone_call_duration_seconds",
"conversion_action.resource_name",
"conversion_action.status"
]
}
}
- 템플릿은 데이터의 segments.date 필드, 즉 데이터의 날짜를 데이터 시간으로 사용합니다
- 템플릿에서 사용하는 이벤트 이름 -- google_ads_conversion_action
2.4.4 Campaign 템플릿
Campaign 리포트로 campaign 계층의 데이터를 확인할 수 있습니다. 다음은 이 인터페이스의 템플릿이며, 전체를 그대로 복사하여 통합 설정에 붙여 넣을 수 있습니다. 조정이 필요하면 공식 문서를 확인하여 metrics로 시작하는 지표는 source.metrics에, 그 밖의 차원 필드는 source.group_by에 추가하십시오:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"campaign"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks",
"metrics.conversions",
"metrics.ctr",
"metrics.average_cpm",
"metrics.average_cpe",
"metrics.average_cpc",
"metrics.trueview_average_cpv",
"metrics.average_cost",
"metrics.all_conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.active_view_cpm",
"metrics.active_view_ctr",
"metrics.current_model_attributed_conversions",
"metrics.current_model_attributed_conversions_value",
"metrics.engagement_rate",
"metrics.engagements",
"metrics.cost_per_current_model_attributed_conversion",
"metrics.cross_device_conversions",
"metrics.conversions_value_by_conversion_date",
"metrics.absolute_top_impression_percentage",
"metrics.active_view_impressions",
"metrics.active_view_measurability",
"metrics.active_view_measurable_impressions",
"metrics.active_view_measurable_cost_micros",
"metrics.active_view_viewability",
"metrics.all_conversions_by_conversion_date",
"metrics.all_conversions_from_interactions_rate",
"metrics.all_conversions_value",
"metrics.all_conversions_value_by_conversion_date",
"metrics.average_page_views",
"metrics.average_time_on_site",
"metrics.bounce_rate",
"metrics.conversions_by_conversion_date",
"metrics.conversions_from_interactions_rate",
"metrics.interactions",
"metrics.interaction_event_types",
"metrics.interaction_rate",
"metrics.percent_new_visitors",
"metrics.top_impression_percentage",
"metrics.value_per_all_conversions_by_conversion_date",
"metrics.value_per_conversions_by_conversion_date",
"metrics.value_per_current_model_attributed_conversion"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"campaign.bidding_strategy",
"campaign.bidding_strategy_type",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"campaign.app_campaign_setting.bidding_strategy_goal_type"
]
}
}
- 템플릿은 데이터의 segments.date 필드, 즉 데이터의 날짜를 데이터 시간으로 사용합니다
- 템플릿에서 사용하는 이벤트 이름 -- google_ads_campaign
2.4.5 Geographic View 템플릿
Geographic View 리포트로 지리적 위치 계층의 데이터를 확인할 수 있습니다. 다음은 이 인터페이스의 템플릿이며, 전체를 그대로 복사하여 통합 설정에 붙여 넣을 수 있습니다. 조정이 필요하면 공식 문서를 확인하여 metrics로 시작하는 지표는 source.metrics에, 그 밖의 차원 필드는 source.group_by에 추가하십시오:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"geographic_view"
],
"metrics":
[
"metrics.all_conversions",
"metrics.average_cpc",
"metrics.average_cpm",
"metrics.clicks",
"metrics.conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.ctr",
"metrics.impressions",
"metrics.interaction_event_types",
"metrics.interaction_rate",
"metrics.interactions",
"metrics.value_per_conversion",
"metrics.video_trueview_views"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"geographic_view.country_criterion_id",
"geographic_view.location_type",
"geographic_view.resource_name",
"segments.ad_network_type",
"segments.date",
"segments.device"
]
}
}
- 템플릿은 데이터의 segments.date 필드, 즉 데이터의 날짜를 데이터 시간으로 사용합니다
- 템플릿에서 사용하는 이벤트 이름 -- google_ads_geographic_view
2.4.6 커스텀 템플릿 작성 방법
위에서는 자주 사용하는 몇 가지 Resource의 템플릿을 소개했습니다. 다른 Resource의 데이터를 연동하려면 이 장의 내용에 따라 진행하십시오.
먼저 Google Ads API 공식 문서로 이동하여 Resource with metrics에서 해당 리소스를 찾을 것을 권장합니다. 리소스는 곧 리포트이며, 리소스마다 분석 차원과 지표가 다르고 오른쪽에서 해당 리소스의 소개를 확인할 수 있습니다. 이 리소스를 연동하기로 했다면 오른쪽의 리소스 이름(예: 아래 그림의 ad_group)을 기록하여 source.report_types에 추가하십시오
이어서 같은 페이지를 계속 보면 Resource fields, Segments, Metrics의 세 열의 필드가 있습니다. 이 세 열이 선택한 리소스가 지원하는 지표와 차원이며, 필요한 필드명을 클릭하면 필드의 전체 이름(예: ad_group.id)을 확인할 수 있습니다. 관심 있는 필드의 전체 이름을 기록하여 metrics.로 시작하는 필드는 source.metrics에, 그 밖의 필드는 source.group_by에 입력하십시오
그 밖에 Attributed resources에 나열된 리소스의 Resource fields도 사용할 수 있습니다.
아래 그림은 ad_group의 Attributed resources이며, campaign이라는 resource를 확인할 수 있습니다. campaign 하이퍼링크를 클릭하면 표시되는 페이지의 campaign Resource fields는 모두 ad group에서 사용할 수 있는 차원입니다. 예를 들어 campaign.id는 ad_group 리소스에서 사용할 수 있으며, 이러한 필드는 source.group_by에 입력하십시오
마지막으로 저장할 이벤트 이름과 데이터 저장 시간을 정해야 합니다.
먼저 저장 이름입니다. 기존의 sink_event.event_mapping을 삭제하고 sink_event.event_name을 추가한 후 저장할 이벤트 이름을 입력할 것을 권장합니다. 이벤트 이름을 입력하지 않으면 데이터를 저장할 수 없습니다.
다음은 데이터 저장 시간입니다. 일반적으로 segments.date를 데이터 시간으로 사용할 것을 권장하며, 이 경우 source.group_by에 segments.date를 추가하고 extra_params.date_key에도 segments.date를 추가해야 합니다. 다른 필드를 데이터 시간으로 사용하려면 두 곳 모두에 해당 필드의 원래 이름을 추가해야 합니다.
이로써 커스텀 템플릿 작성이 완료됩니다. 다음 설정을 참고하여 커스텀 템플릿을 생성할 수 있습니다:
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_name": "google_ads_ad_group"
},
"source":
{
"report_types":
[
"ad_group"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks"
],
"group_by":
[
"customer.id",
"segments.date",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name"
]
}
}
2.4.7 extra_params.where 사용 방법
통합 파라미터 extra_params.where는 고급 파라미터로, Reporting API의 필터 기능에 대응합니다. 이 기능은 GAQL 문(Reporting API의 쿼리 문으로 SQL과 유사)에 대응하므로 다음 방법으로 작성할 것을 권장합니다:
먼저 연동할 Resource 페이지로 이동하여 상단의 Help me build a query를 클릭하면 GAQL 작성 보조 페이지로 이동합니다
다음으로 아래 그림의 WHERE 탭을 클릭하여 해당 resource에서 사용할 수 있는 필터 필드를 확인합니다:
필요한 필드를 선택하고 화면 안내에 따라 필터 조건을 선택합니다
필터 조건을 모두 작성한 후 상단의 작성 영역에서 Where 뒤의 내용을 복사하여 extra_params.where에 입력합니다
{
"extra_params":
{
"date_key": "segments.date",
"where": "ad_group.name = 'abc' AND ad_group.type = 'TRAVEL_ADS'"
}
//...... other params
}
2.4.8 Google Ads 쿼리 타임아웃 설정
Google Ads 쿼리 총 타임아웃은 통합 계획 또는 데이터베이스에서 설정할 수 있으며, 단위는 밀리초입니다. 양의 정수만 유효하며, 설정하지 않았거나 설정이 유효하지 않으면 다음 우선순위의 값을 사용합니다.
통합 계획 설정
{
"extra_params": {
"ta_options": {
"search_total_timeout_ms": 300000
}
}
}
예시의 300000은 5분을 의미합니다.
데이터베이스 설정
INSERT INTO ta.ta_software_config (namespace, config_key, config_val)
VALUES ('ta-thirdparty', 'google_ads_search_total_timeout_ms', '300000');
설정 우선순위
- 통합 계획의
extra_params.ta_options.search_total_timeout_ms - 데이터베이스의
google_ads_search_total_timeout_ms - Google Ads SDK 기본값(현재 4시간)
2.5 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
-
Google Ads Reporting API는 집계 데이터를 반환하므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
-
extra_params의 date_key에 해당하는 필드(일반적으로 segments.date 필드)를 이벤트의 #event_time으로 사용합니다
-
sink_event.event_mapping의 설정을 사용하며, 데이터 이벤트 이름은 다음과 같습니다:
- ad_group_ad_asset_view：google_ads_ad_group_ad_asset_view
- ad_group_ad：google_ads_ad_group_ad
- conversion_action：google_ads_conversion_action
- campaign：google_ads_campaign
- geographic_view：google_ads_geographic_view
-
나머지 필드는 모두 저장됩니다
2.6 표준화 필드
데이터에 다음 이벤트 속성이 있으면 자동으로 표준화 처리합니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| customer_id | te_ads_object.ad_account_id | 광고 계정 ID |
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| ad_group_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| ad_group_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| ad_group_ad_ad_name | te_ads_object.ad_name | 광고 이름 |
| ad_group_ad_ad_id | te_ads_object.ad_id | 광고 ID |
| segment_slot | te_ads_object.placement | 광고 위치 |
| geographic_view_country_criterion_id | te_ads_object.country | 국가/지역 코드 |
| customer_currency_code | te_ads_object.currency | 비용 또는 수익의 통화 |
| metrics_impressions | te_ads_object.impressions | 노출 수 |
| metrics_clicks | te_ads_object.clicks | 클릭 수 |
| metrics_conversions | te_ads_object.conversions | 전환 수 |
| metrics_biddable_app_install_conversions | te_ads_object.installs | 전환 수(설치) |
| metrics_cost_micros(1000000으로 나눔) | te_ads_object.cost | UA 비용 |
2.7 인증 완료
설정을 마친 후 오른쪽 상단의 저장 및 인증을 클릭하여 계획 설정을 저장할 수 있습니다. 이어서 마지막 인증 작업을 완료해야 합니다:
먼저 팝업된 인증 정보 페이지에서 첫 번째 단계의 주소를 복사합니다
다음으로 Google Cloud Platform으로 돌아가 이전에 생성한 credentials를 편집합니다(사이드바의 APIs & Services - Credentials에서 이전에 생성한 Oauth 2.0 Client ID를 확인할 수 있으며, 뒤에 있는 편집 버튼을 클릭하면 편집 페이지로 이동합니다). Authorized redirect URIs에 방금 복사한 콜백 주소를 추가하고 Save를 클릭하여 수정을 완료합니다.
마지막으로 AE 화면으로 돌아와 권한 설정으로 이동을 클릭하면 Google Ads의 인증 페이지가 열립니다
광고 관리자 계정에 연결된 Google 계정으로 로그인하고 Google의 안내에 따라 인증 작업을 완료하십시오
인증을 완료한 후 인증 정보에서 왼쪽 하단의 위의 두 단계를 완료했습니다를 클릭한 다음 오른쪽 하단의 인증 완료를 클릭하여 설정을 마칩니다. 이로써 Google Ads 데이터 통합이 완료됩니다.
3. 버전 업데이트 기록
2026-01-29 버전 업데이트
변경 사항: Google Ads 인터페이스 버전이 V19에서 V22로 업데이트되어 일부 속성의 이름이 변경되었습니다
공식 링크: https://developers.google.com/google-ads/api/docs/upgrade
| V19 기존 필드 | V22 현재 필드 | 필드 설명 |
|---|---|---|
average_cpv | trueview_average_cpv | 누군가 광고를 볼 때마다 평균적으로 지불하는 비용입니다. 평균 조회당 비용(CPV)은 모든 광고 조회의 총비용을 TrueView 조회수로 나눈 값으로 정의됩니다. |
| video_view_rate | video_trueview_view_rate | TrueView 동영상 광고의 조회수를 노출수로 나눈 값으로, TrueView 디스플레이 광고의 썸네일 노출수를 포함합니다. |
| video_views | video_trueview_views | 동영상 광고가 얻은 TrueView 조회수입니다. |
TE Google Ads 서드파티 통합 계획 인터페이스 처리:
| 기존 계획 | 변경 필드가 관련된 경우 | 2026-01-29 버전 업데이트 후 신규 필드와 기존 필드에 데이터를 이중 기록하므로 필요에 따라 선택하여 사용할 수 있습니다 |
| 변경 필드가 관련되지 않은 경우 | 영향 없음 | |
| 신규 계획 | 변경 필드가 관련된 경우 | 업데이트된 V22 인터페이스 템플릿을 모두 사용합니다 |
| 변경 필드가 관련되지 않은 경우 |