> For the complete documentation index, see [llms.txt](https://help.qshop.ai/customer_support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qshop.ai/customer_support/guide/partner/meta_api.md).

# 메타 전환 API

메타의 전환API서비스는 마케팅 데이터와 메타의 시스템을 보다 안정적으로 직접 연결하여 광고 타게팅 최적화 및 비용 절감의 효과가 있습니다. 또한 보다 정확한 데이터를 통해 더 나은 마케팅 및 광고 개선에 도움을 줍니다.

{% hint style="info" %}
전환API설정을 위해서는 메타 픽셀이 선행 되어야합니다. \
자세한 설정 방법은 [\[메타 픽셀\]](/customer_support/guide/partner/meta.md) 가이드를 참고 부탁드립니다.
{% endhint %}

## 지원하는 전환 이벤트

<table data-header-hidden><thead><tr><th width="178">버리는 항목</th><th></th></tr></thead><tbody><tr><td>항목</td><td>설명</td></tr><tr><td><strong>InitiateCheckout</strong></td><td>주문서 작성 페이지 진입 시 금액, 상품 수, 상품 목록의 정보를 전송합니다.</td></tr><tr><td><strong>viewContent</strong></td><td>상세페이지 진입 및 상품정보의 고유값을 전송합니다.</td></tr><tr><td><strong>addToCart</strong></td><td>장바구니 추가 버튼 클릭 시 해당 정보를 전송합니다.</td></tr><tr><td><strong>purchase</strong></td><td>결제 완료 시 구매 상품의 수량, 총 구매 가격을 전송합니다.</td></tr><tr><td><strong>search</strong></td><td>검색 정보를 전송합니다.</td></tr></tbody></table>

## 1. 전환API 생성하기

1-1. [Meta이벤트 관리자](https://www.facebook.com/events_manager2) 페이지에 들어가 가입 및 로그인을 합니다.

1-2. 왼쪽 메뉴바의 **\[데이터 소스]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/CehlpciTPi3MIoTOdpRa" alt=""><figcaption></figcaption></figure>

1-3. 생성한 픽셀을 선택한 후 **\[개요]** 탭 아래 **\[전환 API 설정하기]** 버튼을 클릭합니다.

<figure><img src="/files/BLZQ2t5AONqicTZe5Sht" alt=""><figcaption></figcaption></figure>

1-4. 설정 방법 선택 항목의 **\[직접 설정]**&#xC744; 선택한 후 **\[다음]** 버튼을 클릭합니다.

<figure><img src="/files/BwzvRkuIm5OhxMVR2iUX" alt=""><figcaption></figcaption></figure>

1-5. 개요 내용을 확인 후 **\[계속]** 버튼을 클릭합니다.

1-6. 이벤트 선택 목 중 아래 이미지와 같이 **구매, 결제 시작, 장바구니에 담기, 콘텐츠 조회, 등록완료** 를 선택합니다.

<figure><img src="/files/mIDiFDsNIx73APrWYRyR" alt=""><figcaption></figcaption></figure>

1-7. 아래 표를 참고하여, 각 이벤트의 매개변수를 선택합니다.

<figure><img src="/files/nYaleNJSw0RzNKARypiI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IF98fhyzG9JSetNX27Hq" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="166"></th><th></th></tr></thead><tbody><tr><td>항목</td><td>설명</td></tr><tr><td><strong>장바구니에 담기</strong></td><td><ul><li>이벤트 상세 정보 매개변수<br><strong>‘값’</strong> 정보 선택</li><li>고객 정보 매개 변수<br><strong>이름, 전화</strong> 정보 선택</li></ul></td></tr><tr><td><strong>등록완료</strong></td><td><ul><li>이벤트 상세 정보 매개변수<br><strong>‘값’</strong> 정보 선택</li><li>고객 정보 매개 변수<br><strong>시,군</strong> 정보 선택</li></ul></td></tr><tr><td><strong>결제시작</strong></td><td><ul><li>이벤트 상세 정보 매개변수<br><strong>‘값’</strong> 정보 선택</li><li>고객 정보 매개 변수<br><strong>생년월일</strong> 정보 선택</li></ul></td></tr><tr><td><strong>구매</strong></td><td><ul><li>이벤트 상세 정보 매개변수<br>선택 사항 없음</li><li>고객 정보 매개 변수<br><strong>생년월일</strong> 정보 선택</li></ul></td></tr><tr><td><strong>콘텐츠 조회</strong></td><td><ul><li>이벤트 상세 정보 매개변수<br>선택 사항 없음</li><li>고객 정보 매개 변수<br><strong>이름</strong> 정보 선택</li></ul></td></tr></tbody></table>

1-8. 선택한 매개변수의 값을 확인 한 후 **\[설정 확인]** 버튼을 클릭합니다.&#x20;

1-9. **(선택사항)** 메타를 통해 맞춤 안내 정보를 받길 원하신다면 안내 단계 보내기를 클릭하여, 메일 주소를 입력합니다.

{% hint style="info" %}
이 과정이 필요없다면 **\[마침]** 버튼을 눌러 전환 이벤트 설정을 완료합니다.
{% endhint %}

<figure><img src="/files/6sySO3Z3AfvQR9EwiwuR" alt=""><figcaption></figcaption></figure>

## 2. 전환API 설정하기

2-1. 데이터 소스 페이지로 돌아와 설정한 픽셀의 **\[개요]**&#xD0ED;을 클릭합니다.

2-2. 탭 가장 위 **\[엑세스 토큰 만들기]** 버튼을 클릭합니다. <br>

<figure><img src="/files/C0ILw8IsH6nN1zw4uKPS" alt=""><figcaption></figcaption></figure>

2-3. 생성된 토큰을 복사합니다. <br>

<figure><img src="/files/Uy7QJMgAwqiWJJrRgkmq" alt=""><figcaption></figcaption></figure>

2-4. **\[관리자페이지 > 성장센터 > 메타]**&#xD398;이지에 들어갑니다.

2-5. **\[2-2과정]**&#xC5D0;서 복사한 엑세스 토큰을 전환API 항목에 붙여넣습니다.

<figure><img src="/files/4R7jM9HlDINXjuQrp3p5" alt=""><figcaption></figcaption></figure>

2-5. 모든 설정이 완료되었습니다.\
Meta 이벤트 관리자 페이지를 통해 전환추적이 가능합니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.qshop.ai/customer_support/guide/partner/meta_api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.