전환 API를 사용하여 오프라인 이벤트 보내기

전환 API는 광고 측정, 기여 분석 및 타게팅에 사용하기 위해 오프라인 이벤트 및 오프라인 매장 이벤트를 Meta로 보내는 데 제공하는 Meta의 권장 통합 방법입니다. 이 페이지에서는 전환 API 직접 또는 파트너 통합을 통해 오프라인 이벤트를 전송하는 방법을 자세히 설명합니다.

필수 조건

데이터 세트

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

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

권한

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

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

구성

1. 오프라인 이벤트 매개변수 설정

광고주는 여기에 언급된 설정을 사용하고 전환 API를 통해 전송될 수 있는 현재 매개변수 세트를 참조할 수 있습니다. 오프라인 및 매장 이벤트를 보내기 위해, 페이로드에서 다음과 같은 필드를 공유할 수 있습니다.

• 광고주는 모든 오프라인 및 매장 이벤트에 대해 action_source를 physical_store로서 전송해야 합니다. 이 매개변수는 모든 서버 이벤트 유형에 필수입니다. 전환 API를 사용하면 여러분이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하게 됩니다.
• 전환 API에 필요한 모든 서버 이벤트 필드를 준수해야 합니다.
• 고객 정보 매개변수(오프라인 및 매장 이벤트에 적절한 매개변수의 리스트는 아래 참조).
• 맞춤 데이터 매개변수(오프라인 및 매장 이벤트에 적절한 매개변수의 리스트는 아래 참조).
• 선택적 매개변수: 오프라인 이벤트에 기존 API를 사용하는 광고주의 오프라인 업로드에는 upload_tag 매개변수가 계속 지원됩니다.

고객 정보 매개변수

다음 리스트는 오프라인 및 매장 이벤트에 일반적으로 사용되는 고객 정보 매개변수를 포함합니다.

맞춤 데이터 매개변수

다음 섹션에는 오프라인 및 매장 이벤트에서 사용하는 일반적인 맞춤 매개변수가 포함되어 있습니다. 추가적인 맞춤 데이터 필드를 더 보려면, 전환 API에 허용되는 전체 리스트를 다음 링크에서 확인하세요.

2. 이벤트 보내기

새로운 이벤트를 전송하려면 https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN} 경로에서 전환 API로 POST 요청을 보내세요.

이 에지로 POST 요청을 보내면 Meta가 새로운 오프라인 및 매장 이벤트를 생성합니다. 자세한 내용은 다음 개발자 문서를 참조하세요.

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

curl -X POST \
  -F 'data=[
       {
  "event_name": "Purchase",
  "event_time": 1674000041,
  "user_data": {
    "em": [
      "309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd"
    ],
    "ph": [
      "254aa248acb47dd654ca3ea53f48c2c26d641d23d7e2e93a1ec56258df7674c4",
      "6f4fcb9deaeadc8f9746ae76d97ce1239e98b404efe5da3ee0b7149740f89ad6"
    ]
  },
  "custom_data": {
    "currency": "usd",
    "value": 123.45,
    "contents": [{
      "id": "product123",
      "quantity": 1
    }]
  },
  "action_source": "physical_store"
}
]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v15.0/<DATASET_ID>/events

최적의 최적화 결과를 얻을 수 있도록 실시간으로 또는 매일 업로드하여, 오프라인 데이터가 게재 중인 광고의 성과와 효과적으로 매칭될 수 있도록 하는 것이 좋습니다.

event_time은 Meta에 이벤트를 전송하기 전 최대 7일까지 가능합니다. data에 최근 7일보다 이전인 event_time이 있을 경우 전체 요청에 대해 오류가 반환되고 이벤트가 처리되지 않습니다. physical_store가 action_source로 포함된 오프라인 및 실물 매장 이벤트의 경우 전환 시점으로부터 62일 이내에 거래를 업로드해야 합니다.

업로드한 데이터는 실시간으로 처리되므로 대개 데이터를 추가하면 바로 결과를 확인할 수 있습니다. 오프라인 이벤트 데이터 모범 사례에 대한 고객 센터 문서를 참조하세요.

3. 중복 제거 설정

전환 API 및 Meta 픽셀 이벤트의 중복 제거 설정과 달리 오프라인 이벤트는 다른 오프라인 이벤트에 대해서만 중복을 제거할 수 있습니다. Meta에서는 두 가지 방법(order_id 기반 또는 user 기반)으로 중복 제거를 지원합니다. 중복 제거는 dataset_id, event_time, event_name, item_number 필드 및 주어진 이벤트 페이로드 내 방법에 기반한 주요 필드의 조합을 사용합니다.

기본 중복 제거는 위의 필드를 조합하여 order_id를 사용합니다. order_id가 페이로드에 없을 경우, 사용자 기반 중복 제거 로직이 사용됩니다.

예를 들어 event_time,event_name이 동일하고 order_id가 동일하거나, order_id 없이 고객 정보 매개변수 세트가 동일한 주문이 2개인 경우, Meta에서는 이를 중복 이벤트로 간주하고 첫 이벤트만 받습니다. 사용자 기반 중복 제거 방법은 두 개의 페이로드에 동일한 고객 정보 매개변수 필드가 있어야 효과가 있습니다.

최대 중복 제거 기간은 7일입니다.

4. 이벤트 문제 해결

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

• 해당할 경우 physical_store 행동 출처를 선택합니다. 전환 API를 사용하면 여러분이 아는 한도 내에서 action_source 매개변수가 정확하다는 데 동의하게 됩니다.
• Meta로 전송할 이벤트에 대한 정보를 입력합니다.
• 그러면 이벤트 페이로드가 생성되며, 이를 전환 API 통합의 템플릿으로 사용할 수 있습니다.

이벤트 관리자에서 이벤트 테스트 도구를 사용하여 테스트합니다. 테스트 이벤트 도구는 웹 및 앱 이벤트만 지원합니다.

기타 참고 자료

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

비즈니스 지원 센터 문서

• 오프라인 이벤트 세트 생성 중에 데이터 세트 만들기
• 오프라인 이벤트 데이터 모범 사례
• 광고주가 오프라인 전환을 사용할 수 있는 방법
• 특정 데이터 세트에 할당된 캠페인의 결과를 확인하는 방법
• 이벤트 중복 제거가 오프라인 이벤트에서 작동하는 방법