(전환 API) 메타 전환 API - 모바일

팔로우
Avatar
Travis Simpson
Updated
문서

Singular와 메타 전환 API의 연동을 통해 광고주는 Singular 어트리뷰션 메타 클릭 전환을 메타로 직접 전송할 수 있습니다. 이 연동은 웹투앱 측정을 지원하여 인앱 이벤트를 웹 이벤트로 Meta의 전환 API로 전송하여 앱 설치와 사용자 참여에 초점을 맞춘 웹 캠페인을 최적화할 수 있습니다.

Singular와 메타의 모바일 측정 연동에 대한 자세한 내용은 해당 주제에 대한 전용[도움말 센터 문서]를 참조하세요.

메타 전환 API(모바일) 연동을 구성하는 방법

  1. 웹사이트-앱 어트리뷰션 포워딩과연동된 웹 SDK가 있는지 확인합니다.
  2. Singular > 어트리뷰션 > 파트너 구성으로이동합니다.
  3. "파트너 추가"를 클릭하고파트너를입력한 후 선택합니다: "메타 전환 API(모바일)"를 입력합니다.
  4. 대화 상자에서 구성할 앱과 앱 사이트(플랫폼)를 선택합니다.
    이 연동은 iOS 및 Android 앱만 지원됩니다.

  5. 메타 이벤트 관리자 대시보드에서 앱의"액세스 토큰"과"데이터 세트 ID"를 붙여넣습니다.

  6. 선택 사항: 메타로 전송할 추가 이벤트를 구성하고 "메타 이벤트 이름"에 매핑합니다.

  7. "저장"을 클릭하여 완료합니다.

FAQ

메타 데이터 세트 ID는 어디에서 찾을 수 있나요?
  1. 메타 이벤트 관리자로 이동합니다.

  2. "데이터 소스"에서 웹/PC/콘솔 데이터 소스를 선택합니다.

    새 데이터 소스인 경우"데이터 소스 연결"을 통해 새 데이터 소스를 생성하고 메타의 단계별 가이드에 따라"웹" 데이터 소스를 생성합니다. 여기에서 메타 데이터 소스에 대해 자세히 알아보세요.

  3. "설정"에서"데이터 세트 ID"를 복사합니다.

액세스 토큰은 어디에서 찾을 수 있나요?
  1. 메타 이벤트 관리자로 이동합니다.

  2. "데이터 소스"에서 웹/PC/콘솔 데이터 소스를 선택합니다.


    새 데이터 소스인 경우,"데이터 소스 연결"을 통해 새 데이터 소스를 생성하고 Meta의 단계별 가이드에 따라"웹" 데이터 소스를 생성합니다. 여기에서 메타 데이터 소스에 대해 자세히 알아보세요.

  3. '설정'에서 아래로 스크롤하여'전환 API'로 이동하고'직접 연동 설정'에서 액세스 토큰을 생성한 다음 복사합니다.

Singular는 API를 통해 어떤 데이터를 전송하나요?
파라미터 세부 정보
event_name
  • 표준 이벤트 또는 사용자 지정 이벤트 이름입니다. 이 필드는 Singular 이벤트 이름에 자동으로 매핑됩니다. 이 값은 메타에서 이벤트 중복 제거를 지원하는 데 사용됩니다. event_id 매개변수도 중복 제거에 사용됩니다.
fbc
  • 페이스북 클릭 ID
  • 자동 전달
hashed email
  • 선택 사항
  • 해시된 이메일은 Singular 계측 이벤트 속성 "ehash"로 전달될 수 있습니다.
  • 해시된 이메일 값은 정규화되고 SHA 256 해시되어야 합니다.
hashed phone number
  • 선택 사항
  • 해시된 전화번호는 Singular 계측 이벤트 속성 "phash"로 전달될 수 있습니다.
  • 해시된 전화 번호는 E164 정규화 및 SHA 256 해시되어야 합니다.
hashed first name
  • 선택 사항
  • 해시된 이름은 Singular 계측 이벤트 속성 "fnamehash"로 전달될 수 있습니다.
  • 로마 알파벳 a-z 문자를 사용하는 것이 좋습니다. 구두점 없이 소문자만 사용해야 합니다. 특수 문자를 사용하는 경우 텍스트는 UTF-8 형식으로 인코딩해야 합니다.
  • 해시된 이름은 SHA 256 해시된 이름이어야 합니다.
hashed last name
  • 선택 사항
  • 해시된 성은 Singular 계측 이벤트 속성 "fnamehash"로 전달할 수 있습니다.
  • 로마 알파벳 a-z 문자를 사용하는 것이 좋습니다. 구두점 없이 소문자만 사용해야 합니다. 특수 문자를 사용하는 경우 텍스트는 UTF-8 형식으로 인코딩해야 합니다.
  • 해시된 성은 SHA 256 해시여야 합니다.
IP address
  • 클라이언트 IP 주소
user agent
  • (웹에만 해당) 이벤트에 해당하는 브라우저의 사용자 에이전트
이벤트 중복 제거(선택 사항)
event_id
  • 중복 제거를 위한 필수 파라미터
  • 속성 이름"eventId"를 사용하여 이벤트 인수의 Singular에 event_id 값을 전달합니다.

메타 요구 사항:

  • event_id 파라미터는 전환 API와 브라우저 픽셀 모두에서 이벤트에 추가해야 합니다.
  • event_id 파라미터는 유사한 이벤트를 고유하게 구분할 수 있는 식별자입니다. event_id 파라미터에 대해 자세히 알아보세요.
메타 전환 API의 제한 사항은 무엇인가요?
  • 메타는 기존 메타 픽셀 구현을 보강하는 데 메타 변환 API를 사용할 것을권장합니다.