> 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에 대해 알아봅니다.

메타의 전환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="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FnlxppXRN7x4KdZQhWtEp%2F1_%EB%8D%B0%EC%9D%B4%ED%84%B0%20%EC%86%8C%EC%8A%A4%20%EB%B2%84%ED%8A%BC.png?alt=media&amp;token=a7fe14ff-3b86-4293-9c55-500b087cdb0f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FA7TzwSOX1Z22riYO21bc%2F2_%EC%A0%84%ED%99%98%20API%20%EC%84%A4%EC%A0%95%20%EB%B2%84%ED%8A%BC.png?alt=media&amp;token=c4ba0556-ca48-4c35-a7e5-9483da8d7737" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FKsuIr6EEK8RzWgHd0Za9%2F3_%EC%A7%81%EC%A0%91%20%EC%84%A4%EC%A0%95.png?alt=media&amp;token=9428f925-1e8e-4f7b-a518-2f69042629f6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FlJja96nE4ZPjdUDOlE9y%2F4_%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%84%A0%ED%83%9D.png?alt=media&amp;token=3f974108-f335-4e78-84e6-b03c439c2979" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2F0U0A3iNeN27w2ZL0CVED%2F5_%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EB%A7%A4%EA%B0%9C%EB%B3%80%EC%88%98.png?alt=media&amp;token=0dbfa113-f256-43ef-83fd-00f8d06378a1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FfWCCq7bWjPPUkw2bZiVL%2F5-1_%EA%B3%A0%EA%B0%9D%EC%A0%95%EB%B3%B4%20%EB%A7%A4%EA%B0%9C%EB%B3%80%EC%88%98.png?alt=media&amp;token=db5353e7-784b-4a6e-a447-e85a2a5f9b2b" 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="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FLk1bpgb1kemMeVl2c2Me%2F6_%EC%84%A4%EC%A0%95%20%EC%99%84%EB%A3%8C.png?alt=media&amp;token=f27b1f3c-527d-4888-a55d-0200c6d2dbe7" alt=""><figcaption></figcaption></figure>

## 2. 전환API 설정하기

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

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2FtTHRCacxkf9StDAa6Itr%2F7_%ED%86%A0%ED%81%B0%20%EB%A7%8C%EB%93%A4%EA%B8%B0.png?alt=media&amp;token=26f7e355-9c1f-412d-a45d-4d876f7d1859" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2F5oWEJIOtNAlOE527Hpw1%2F8_%ED%86%A0%ED%81%B0%20%EB%B3%B5%EC%82%AC.png?alt=media&amp;token=7d954f03-1cae-4959-bfee-50f83ebb3ebe" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://641624378-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqwj5uwp8v68jk4VznncE%2Fuploads%2F9SaOoZBXTwgFJjA8jI7O%2F9_%ED%86%A0%ED%81%B0%20%EC%A0%81%EC%9A%A9_mk2.png?alt=media&amp;token=9c65853a-bf03-4b92-ac6d-7ae930555557" alt=""><figcaption></figcaption></figure>

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