Meta Ads 연동
adstage에서는 Meta Ads(Facebook·Instagram)에서 운영 중인 광고 캠페인의 비용 데이터를 수집하고, adstage에서 수집한 전환 이벤트를 Meta로 다시 전송하는 전환 API(CAPI)를 연동할 수 있습니다. Meta Ads 연동은 채널 연동, 비용 연동, 전환 API 세 개의 탭으로 구성됩니다.
1. 연동 개요
adstage 대시보드 연동 > 광고 채널 연동 > Meta Ads에서 아래 항목을 설정합니다.
| 탭 | 역할 |
|---|---|
채널 연동 | Android Install Referrer 복호화에 필요한 Facebook App ID와 복호화 키를 등록합니다. |
비용 연동 | OAuth로 Meta 광고 계정을 연결하여 캠페인 비용 데이터를 수집합니다. |
전환 API | adstage가 수집한 이벤트를 Meta Conversions API(CAPI)로 서버 측에서 전송합니다. |
2. 비용 연동하기
비용 연동 탭에서 Meta 광고 계정을 연결하면 Meta Ads에서 운영 중인 캠페인의 비용 데이터를 adstage 대시보드에서 확인할 수 있습니다.
Meta 계정으로 연동하기
Meta Business 로그인(OAuth) 방식을 사용하여 안전하게 인증합니다.
-
비용 연동탭에서비용 데이터 수집스위치를 활성화합니다. -
연동 계정 추가버튼을 클릭합니다. Facebook 비즈니스 로그인 창이 새 창으로 열립니다. -
Meta 계정으로 로그인하고 adstage가 광고 데이터에 접근할 수 있도록 권한을 승인합니다.
연동 사전 준비
비용 연동을 진행하려면 Meta 비즈니스 관리자(Business Manager) 접근 권한과 해당 광고 계정의 관리자 권한이 필요합니다.
광고 계정 선택하기
인증이 완료되면 해당 Meta 계정으로 접근 가능한 광고 계정 목록이 표시됩니다.
-
연동할 광고 계정을 하나 이상 선택합니다. 계정 이름, 광고 계정 ID(Ad Account ID), 비즈니스 관리자(Business Manager) 정보가 표시되므로 올바른 계정인지 확인합니다.
-
계정 이름이나 ID로 목록을 검색할 수 있으며,
전체 선택으로 한 번에 모두 선택할 수도 있습니다. -
선택한 계정 수를 확인한 후 연동을 확정하면 해당 광고 계정이 adstage와 연동됩니다.
주의하세요
이미 등록된 광고 계정은 연동에서 제외됩니다. 선택한 계정이 모두 이미 등록되어 있으면 연동이 진행되지 않습니다.
연동 계정 관리하기
연동된 광고 계정은 비용 연동 탭의 계정 목록에서 다음 정보로 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
광고 계정 | Meta 광고 계정 이름과 광고 계정 ID(Ad Account ID) |
상태 | 비용 연동 상태 (준비 중, 성공, 실패) |
마지막 데이터 업데이트 | 최근 데이터 수집 시각 |
Facebook 계정 | 연동에 사용한 Meta 계정 이메일 또는 이름 |
관리 | 계정 연동 해제(삭제) |
연동을 해제하려면 계정 목록에서 해당 계정의 삭제 버튼을 클릭한 후, 확인 메시지에서 삭제를 선택합니다.
주의하세요
계정을 삭제하면 해당 계정의 데이터 수집이 중단됩니다. 이미 수집된 과거 데이터는 adstage에 보관되지만 새로운 데이터는 수집되지 않습니다.
수집되는 데이터
비용 데이터는 다음과 같이 수집됩니다.
| 항목 | 설명 |
|---|---|
| 수집 주기 | 4시간마다 자동 수집 |
| 데이터 계층 | 캠페인, 광고 그룹(Ad Set), 광고(Ad) 레벨의 세부 데이터 |
| 수집 지표 | 비용 등 캠페인별 성과 데이터 |
3. 전환 API(CAPI) 연동하기
전환 API 탭에서 Meta Conversions API(CAPI)를 연동하면 Facebook SDK를 앱에 설치하지 않고도 adstage가 수집한 이벤트를 Meta로 서버 측에서 전송할 수 있습니다. iOS ATT 환경에서도 서버 측 전송을 통해 어트리뷰션 정확도를 높일 수 있습니다.
Pixel ID 입력하기
Meta 이벤트 관리자(Events Manager)에서 Pixel ID를 확인한 후 입력합니다.
- 확인 경로: 이벤트 관리자 → 데이터 소스 → Pixel 선택 → 설정 → Pixel ID
액세스 토큰 입력하기
이벤트 관리자에서 전환 API용 액세스 토큰을 생성한 후 입력합니다.
- 생성 경로: 이벤트 관리자 → 데이터 소스 → Pixel 선택 → 설정 → Conversions API → 액세스 토큰 생성
액세스 토큰은 암호화되어 저장됩니다
저장한 액세스 토큰은 암호화되어 안전하게 보관되며, 저장 후에는 다시 표시되지 않습니다. 변경하려면 새 토큰을 다시 입력합니다.
테스트 이벤트 코드 (선택)
운영 리포트에 영향을 주지 않고 이벤트를 검증하려면 테스트 이벤트 코드를 설정합니다. 운영 모드로 전환할 때는 코드를 비우고 다시 저장합니다.
- 확인 경로: 이벤트 관리자 → 테스트 이벤트(Test Events) 탭 → 테스트 코드 확인
연결 테스트 및 이벤트 포워딩 설정
Pixel ID와 액세스 토큰을 저장하면 다음 기능을 사용할 수 있습니다.
| 항목 | 설명 |
|---|---|
연결 테스트 | 테스트 이벤트를 전송하여 CAPI 설정이 정상 동작하는지 확인합니다. |
이벤트 포워딩 설정 | 수집된 이벤트별로 Meta 전송 여부를 켜고 끌 수 있으며, 각 adstage 이벤트를 어떤 Meta 이벤트로 보낼지 매핑합니다. |
이벤트 포워딩 설정에는 실제로 수집된 이벤트만 표시됩니다. 아직 수집된 이벤트가 없으면 앱에서 데이터가 들어온 이후 목록에 나타납니다.
CAPI 동작 방식
- 사용자 이메일과 전화번호는 Meta로 전송되기 전에 SHA256으로 해시 처리됩니다.
- event_id 기반 중복 제거가 자동 적용되어 브라우저 픽셀과의 이중 집계를 방지합니다.
- 서버 측 이벤트 전송으로 iOS ATT 제한을 우회하여 어트리뷰션 정확도가 향상됩니다.
4. 채널 연동하기
채널 연동 탭에서는 Android Facebook Install Referrer 복호화에 필요한 정보를 등록합니다.
Facebook App ID 확인하기
Meta for Developers에서 앱을 등록한 후 App ID를 확인하여 입력합니다.
- 확인 경로: Dashboard → 앱 선택 → 설정(Settings) → 기본(Basic) → App ID
복호화 키 입력하기
Meta에서 발급한 32바이트 복호화 키(HEX 64자)를 입력합니다.
- 확인 경로: Dashboard → 앱 선택 → 설정(Settings) → 고급(Advanced) → Install Referrer Decryption Key
복호화 키는 암호화되어 저장됩니다
저장한 복호화 키는 암호화되어 안전하게 보관되며, 저장 후에는 다시 표시되지 않습니다. 변경하려면 새 키를 다시 입력합니다.
5. 주의사항
아래 사항을 주의해 주세요.
- Meta Ads와 adstage 간에 수치 차이가 발생할 수 있습니다. 이는 집계 시점, 타임존, 필터링 기준의 차이 때문입니다.
- Meta 계정의 권한을 취소하거나 토큰이 만료되면 데이터 수집이 중단될 수 있습니다.
- 광고 채널에서 캠페인 이름을 수정하면 adstage에 반영되는 데 시간이 걸릴 수 있습니다.
- 전환 API를 활성화하려면 Pixel ID와 액세스 토큰이 모두 저장되어 있어야 합니다.