(API 변환) API 메타 변환

팔로우
Avatar
Jonathan Chen
Updated
문서
웹, PC, 콘솔 이벤트 에대한 전환 포스트백은 Singular의 웹, PC, 콘솔 게임 어트리뷰션에 액세스할 수 있는 Singular 고객만 사용할 수 있습니다.

광고주는 메타 전환 API와 Singular의 연동을 통해 Singular 어트리뷰션 메타 클릭 전환을 메타로 전송할 수 있습니다. 이 연동은 Singular 웹, PC, 콘솔 측정에 대해 지원됩니다. Singular의 모바일 측정과 메타의 연동에 대한 자세한 내용은 해당 주제에 대한 도움말 센터 문서를 참조하세요.

메타 전환 API 연동을 구성하는 방법

  1. 웹, PC 또는 콘솔 앱이 Singular와 연동되어 있는지 확인합니다.
  2. Singular > 어트리뷰션 > 파트너 구성으로 이동합니다.
  3. "파트너 추가"를 클릭하고 "메타 컨버젼스 API"를 입력하고 선택합니다.
  4. 대화 상자에서 구성할 앱과 앱 사이트(플랫폼)를 선택합니다. 이 연동에서는 웹, PC 및 콘솔 앱만 지원됩니다.
  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를 사용할 것을권장합니다.
  • 모바일 연동의 경우, 메타 및 Singular는 모바일 전환 데이터를 Singular의 전용 모바일 어트리뷰션과 메타의 연동을 통해 전달할 것을 권장합니다. 메타 전환 API를 통해 모바일 전환 데이터를 전달하는 데 관심이 있는 경우, Singular 고객 성공 매니저에게 문의하세요.