앱 이벤트용 전환 API

전환 API는 광고주가 여러 소스를 거치지 않고 하나의 엔드포인트를 통해 웹, 앱, 실물 매장 및 비즈니스 메시지 이벤트를 Meta로 보낼 수 있도록 지원합니다. 이 통합은 데이터 세트를 사용하여 광고주의 기술 스택을 단순화하고 Meta 이벤트 관리자 내에서 더욱 포괄적인 보기를 만듭니다.

이 문서는 전환 API에 앱 이벤트를 통합하기 위한 가이드를 제공합니다.

필수 조건

1. 데이터 세트

전환 API를 통해 전송된 앱 이벤트를 데이터 세트와 연결해야 합니다.

https://graph.facebook.com/v16.0/{ads-pixel-id}/is_consolidated_container로 GET 호출을 보내서 광고주 데이터 세트가 통합되어 있고, 따라서 전환 API를 사용하여 앱 이벤트를 전달할 수 있는지 확인할 수 있습니다.

2. 권한

• 광고주로서 직접 통합을 구현하려면 필수 조건과 권한에 대한 지침(여기)을 따르세요.

• 파트너 플랫폼 통합을 구현하려면 필수 조건과 권한에 대한 지침(여기)을 따르세요.

구성

전환 API로 앱 이벤트 보내기

a. 데이터 세트 ID 및 앱 ID 연결

이벤트 관리자에는 앱과 데이터 세트를 연결하는 방법이 두 가지 있습니다.

• '데이터 소스' 탭을 선택하고 앱의 '설정' 탭을 찾아서 연결을 수행합니다.
• '데이터 소스' 탭을 선택하고 앱의 '개요' 탭에서 '모든 활동' 섹션의 '데이터 세트로 연결' 버튼을 사용합니다.

연결을 완료하고 나면 데이터 세트에 연결된 앱이 포함됩니다.

b. 필수 필드

전환 API를 통해 전송할 수 있는 현재 매개변수 세트는 여기를 참조하세요. 앱 이벤트를 전송하는 경우, 다음 server_event 필드를 페이로드에서 공유할 수 있습니다.

• action_source 매개변수에는 앱 이벤트에 대한 app 값이 포함되어야 합니다.
• 중복 제거 설정 사례에는 event_id가 필수입니다.
• app_data 필드
• user_data 필드
• custom_data 필드

앱 데이터 필드

고객 정보 매개변수

맞춤 데이터

요컨대, 전환 API를 사용하여 공유된 앱 이벤트에는 다음과 같은 데이터 매개변수가 필요합니다.

• action_source: 'app'으로 설정해야 합니다. (전환 API를 사용하면 자신이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하는 것으로 간주됩니다.)
• event_id: 중복 제거 설정에 필수 항목입니다. 자세한 내용은 '여러 채널에 대한 중복 제거 설정' 섹션을 참조하세요.
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

extinfo의 예시는 다음과 같습니다. 아래의 모든 하위 매개변수가 입력되어 있고 순차적인지 확인하세요. 누락된 것이 있는 경우, 빈 문자열을 자리 표시자로 사용하세요.

c. 여러 채널에 대한 중복 제거 설정

전환 API 통합과 앱 이벤트에 사용하는 그 외의 모든 기존 통합(예: SDK, MMP, 앱 이벤트 API) 사이에서 중복된 이벤트 트래픽을 삭제하려면 중복 제거 메커니즘이 필요합니다.

앱 이벤트의 경우, Meta에서는 웹 이벤트의 경우와 동일한 중복 제거 기능을 적용합니다. 이 로직은 event_id 및 event_name 필드 기반 중복 제거를 사용합니다(동일한 event_id가 있는 전환 API 및 SDK/앱 이벤트 API 이벤트). event_id 매개변수는 유사한 이벤트를 고유하게 구분할 수 있는 식별자입니다. 이벤트 ID가 부정확할 경우, 전환에 대한 중복 제거가 잘못 실행되어 전환 보고 및 캠페인 성과에 추가 영향을 미칠 수 있습니다.

중복 제거 설정을 구현하려면 다음 개발자 문서를 참조할 수 있습니다.

• 앱 이벤트를 설정하는 방법
• 중복 제거 설정의 예

맞춤 이벤트를 로깅하는 방법의 예시는 다음과 같습니다. 이를 위해서는 iOS SDK에서 이벤트 이름을 AppEvents.Name으로 전달하세요.

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

앱 설치 이벤트의 경우, 최근 90일 동안 하나의 설치만 기여 분석되도록 하는 중복 제거 메커니즘이 이미 존재합니다. 이벤트가 발생한 행동 출처와 관계없이 첫 번째 이벤트는 수신하고 나중 이벤트는 거부합니다. 설치 이벤트와 관련된 앱 이벤트의 경우, 중복 제거를 필수로 구현하지 않아도 됩니다.

d. 이벤트 보내기

새로운 이벤트를 전송하려면 https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN} 경로에서 전환 API로 POST 요청을 보내세요. 이 에지에 POST 요청을 보내면 Meta가 새 앱 서버 이벤트를 생성합니다. 자세한 내용은 다음 개발자 문서를 참조하세요.

페이로드의 전체 스키마에 매개변수가 어떻게 통합되는지 보여주는 개요는 다음과 같습니다.

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

문제 해결

페이로드 도우미 도구를 사용하여 페이로드 데이터를 생성할 수 있습니다.

• 해당할 경우 app 행동 출처를 선택합니다.
• Meta로 전송할 이벤트에 대한 정보를 입력합니다.
• 그러면 이벤트 페이로드가 생성되며, 이를 전환 API 통합의 템플릿으로 사용할 수 있습니다.

이벤트 관리자에서 이벤트 테스트 도구를 사용하여 테스트합니다.

기타 참고 자료

• 전환 API 개요
• 전환 API 사용
• 전환 API 매개변수
• 모범 사례