본가이드는 안드로이드,iOS앱의 페이스북SDK로 이벤트를 연동하기 위한 가이드입니다.

1**.표준 이벤트**

• 기본으로 페북에서 제공되는 표준이벤트가 있으니 이를 사용하면 됩니다.
• 페이스북의 아래 앱 이벤트API 페이지에 “표준 이벤트” 목록이 있으니 참고하여 사용하면 됨. https://developers.facebook.com/docs/marketing-api/app-event-api?locale=ko_KR

위 URL의 가이드에서, 아래처럼 “표준 이벤트 이름” 표를 참고하면 됩니다. Event Name, Event Parameters, valueToSum ⇒ 3가지 속성을 사용하여 연동하게됩니다.

2.이벤트 호출 JS코드 가이드

• 아래 js코드를 사용해 이벤트 연동을 호출합니다.

//아래 3개의 속성변수를 사용해 호출합니다.
//eventname : 이벤트명 string (필수)
//params : 속성파라미터 json object (옵션 : 필요없다면 제거)
//valueToSum : 합계값 Number (옵션 : 필요없다면 제거)
var param = {
	action:"fb_event",
	eventname:"fb_mobile_complete_registration",  //String
	params:{fb_registration_method: "email"}  //json Object
	valueToSum:25000,  //Number (옵션으로 필요없으면 제거)
	callback:"event_rslt"  //이벤트 실행결과를 전달받을 함수(옵션)
};
window.nativeinterface.sendMessage(JSON.stringify(param));

//이벤트 실행결과를 전달받을 함수
function event_rslt(val){
	//alert(val); //결과확인용
}

• 결제완료처리 이벤트는 반드시 아래 js코드를 사용해야합니다.
• 아래를 사용해야 매출집계등 정식 purchase로 집계됩니다.

//아래 3개의 속성변수를 사용해 호출합니다.
//value : 구매비용 Number (필수)
//currency : 통화코드 string (필수)
//params : 속성파라미터 json object (옵션: 필요없다면 제거)
//  {
//    content_type: "product",  // 구매한 항목의 유형
//    content_id: "SKU_12345",  // 개별 상품의 ID
//    num_items: 1,  // 구매한 개수
//    order_id: "O20251111001"  // 내부 주문번호 (커스텀 필드)
//  }
var param = {
	action:"fb_event_purchase",
	value:39800,  //Number
	currency:"KRW",  //String
	params:{
    fb_content_type: "product",
    fb_content_id: "SKU_12345",
    fb_num_items: 1
  },  //json Object
	callback:"event_rslt"  //이벤트 실행결과를 전달받을 함수(옵션)
};
window.nativeinterface.sendMessage(JSON.stringify(param));

//이벤트 실행결과를 전달받을 함수
function event_rslt(val){
	//alert(val); //결과확인용
}

3.이벤트 호출 사용 예시 코드