전환 API 게이트웨이: 비웹 서버 이벤트 API 지원
v1.6.0 이상부터는 전환 API 게이트웨이에서 API 엔드포인트를 지원하기 시작했습니다. 광고주는 서버에서 전환 API 게이트웨이로 비웹 이벤트를 전송할 수 있습니다. 이는 전환 API Direct 방식과 유사합니다. 주요 차이점은 이벤트를 Meta 그래프 API로 직접 보내는 대신 전환 API 게이트웨이를 통해 이벤트가 이동한다는 것입니다.
요청 보내기
새 이벤트를 전송하려면 https://<capig.instance.url>/capi/{PIXEL_ID}/events 경로에서 이 API의 /events 에지로 POST 요청을 보내세요.
이 에지로 POST 요청을 보내면 Meta가 새 서버 이벤트를 생성합니다.
curl -i -X POST \
-d '{
"accessKey": "<ACCESS_KEY_VIA_CAPIG_UI>",
"data": [
{
"event_name": "Purchase",
"event_time": <Unix timestamp in seconds, must be within the last seven days>,
"user_data": {
"em": [
"973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b"
],
"ph": [
"ce3a598687c8d2e5aa6bedad20e059b4a78cca0adad7e563b07998d5cd226b8c"
],
"client_ip_address": "123.123.123.123",
"client_user_agent": "CLIENT_USER_AGENT",
"fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
"fbp": "fb.1.1558571054389.1098115397"
},
"contents": [
{
"id": "product123",
"quantity": 1,
"delivery_category": "home_delivery"
}
],
"custom_data": {
"currency": "usd",
"value": 123.45
},
"event_source_url": "http://test.com/product/123",
"action_source": "website"
}
]
}' \
https://<capig.instance.url>/capi/<PIXEL_ID>/events액세스 키 생성
API 요청을 전환 API 게이트웨이로 보내기 위한 액세스 키는 전환 API 게이트웨이의 관리자 콘솔에서 생성할 수 있습니다.
- 전환 API 게이트웨이 관리자 UI에 로그인합니다.
- 개요 섹션으로 이동합니다.
- 액세스 키를 생성하고자 하는 Connected Meta 픽셀 행에서 '...'를 클릭합니다.
- 액세스 키 생성을 클릭합니다.
전환 API Direct의 액세스 토큰은 전환 API 게이트웨이 엔드포인트로 서버 요청을 보내는 데 사용할 수 없습니다.