> 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 이벤트 관리자 페이지를 통해 전환추적이 가능합니다.