문서가 업데이트되었습니다.
한국어로 번역이 아직 완료되지 않았습니다.
영어 업데이트됨: 4월 26일

전환 API 게이트웨이: 설정 가이드

다음 단계에 따라 전환 API 게이트웨이를 설정하세요.

이 설정 가이드를 읽기 전에 전환 API 게이트웨이 필수 조건을 검토하고 완료하세요.

1단계: 시작하기 및 배포 시작

설정 프로세스를 시작하려면 Meta 이벤트 관리자의 설정 탭으로 이동합니다. '전환 API 게이트웨이 설정'에서 시작하기를 클릭합니다.



  • 전환 API 게이트웨이의 필수 조건을 검토한 후 다음을 선택합니다.

기본 설정 선택

  • 활성화하려는 설정을 선택한 후 계속을 클릭합니다.

    • 이벤트를 강화하면 전환 기여를 개선하고 현재 Meta와 공유하는 이벤트의 성과 이익을 극대화하는 데 도움이 됩니다.
    • 전환 API 게이트웨이 상태 모니터링을 사용하면 Meta가 더욱 효과적으로 잠재적 문제를 해결할 수 있습니다.


  • 이제 호스팅 리전 선택에서 원하는 리전을 선택합니다. 하나의 리전에서만 전환 API 게이트웨이를 설정할 수 있습니다.
  • 다음을 클릭하여 Amazon Web Services(AWS)를 열거나 URL 복사를 클릭하여 조직의 AWS 계정 관리자에게 보냅니다.

2단계: AWS 구성 및 설치

아직 AWS에 로그인하지 않았다면 로그인합니다.

  • 전환 API 게이트웨이 스택의 간편 제작 플로가 열립니다.

  • 모든 필드는 자동 입력됩니다. ProvisioningData 필드를 변경하지 마세요.
  • 스택 생성을 클릭하여 설치를 시작합니다.
  • 생성 프로세스는 약 30~40분이 소요되며, 생성이 끝나면 새로운 AWS 인스턴스의 '출력' 탭에 세 개의 출력이 기록됩니다. 스택 정보 탭에 상태가 CREATE_COMPLETE라고 나오면 완료된 것입니다.
  • 생성이 완료되면 출력 탭으로 이동합니다.
  • (권장) 맞춤 도메인을 만들어 데이터 라우팅을 지원하려면 아래의 4단계를 참조하세요.
  • CapigSetupURL을 메모합니다. 이는 전환 API 게이트웨이 UI를 프로비저닝하는 데 필요합니다.

3단계: 데이터 수집 확인

전환 API 게이트웨이 관리자 UI에 액세스하려면 출력 탭 내의 CapigSetupURL을 사용합니다(2단계 참조). CapigSetupURL은 Meta 이벤트 관리자 내에서도 확인할 수 있습니다.

  • 관리자 UI에 처음으로 로그인하면 관리자 계정을 만들라는 요청을 받게 됩니다.
  • 관리자 계정을 만든 후 로그인을 선택합니다.
  • 전환 API 게이트웨이 관리자 UI 사이트가 표시됩니다.
  • 사이트를 처음 보았을 때는 서버와 브라우저 데이터가 0일 수 있습니다. 이 정보는 채우는 데 5분~2시간이 소요될 수 있습니다.
  • 데이터가 수집되고 있는지 확인하려면 웹사이트로 이동하여 페이지를 새로 고침합니다.
  • 2시간이 지나도 이벤트가 채워지지 않으면 Meta에 문의하세요.
  • 이제 픽셀 설정 아래에 전환 API 게이트웨이가 보일 것입니다.

(권장) 4단계: 맞춤 도메인 추가

전환 API 게이트웨이 관리자 UI 내에서 맞춤 도메인을 설정합니다. 맞춤 도메인은 데이터 라우팅을 최적화하고 비용을 절감하는 데 도움이 될 수 있으므로 권장됩니다.

참고: DNS 공급자에 액세스하여 맞춤 도메인을 추가해야 합니다.

  • 전환 API 게이트웨이 관리자 UI에 로그인합니다.
  • 설정 아래에 있는 왼쪽 사이드바에서 도메인 관리로 이동합니다.
  • DNS 공급자 AWS 인증 관리자(ACM)와 Cloudflare 중에서 선택합니다.

1. AWS 인증 관리자

ACM 설정 안내에 따라 설정을 완료하세요.

2. Cloudflare

Cloudflare 설정 안내에 따라 설정을 완료하세요.

설정 문제 해결

이 단계를 통해 전환 API 게이트웨이를 설정할 때 발생하는 문제를 해결하세요. 일반적인 문제 해결의 경우, 전환 API 게이트웨이 - 오류 및 경고 해결을 참조하세요.

브라우저 자동 완성이 설정에 방해가 되는 경우

이벤트 관리자에서 설치를 시작했는데도 만료된 프로비저닝 데이터로 인해 전환 API 게이트웨이를 설치할 수 없을 경우, 브라우저 자동 완성이 이전에 사용한 정보를 자동으로 채우고 있기 때문일 수 있습니다.

진단

  1. 이벤트 관리자에서 설치를 시작하고 나중에 검사하는 데 사용할 프로비저닝 데이터를 저장합니다.
  2. URL 복사를 클릭하고 복사한 URL을 텍스트 편집기(예: 메모장)에 저장합니다.
  3. 배포 시작을 클릭하여 AWS 생성 페이지를 시작합니다.
  4. AWS 생성 페이지에서 ProvisioningData를 찾아서 앞서 복사한 URL과 항목이 일치하는지 확인합니다. 항목이 일치하지 않으면 자동 완성이 활성화되어 있는 것이므로 이를 비활성화해야 합니다.

해결 방법

FireFox 브라우저의 경우 다음 단계를 따르세요.

  1. Firefox 메뉴 아이콘(화면 오른쪽 상단의 막대 세 개)을 클릭합니다.
  2. 설정을 클릭합니다.
  3. 개인 정보 및 보안 설정을 선택합니다.
  4. 기록으로 스크롤을 내리고 Firefox의 경우 기록에 사용자 지정 설정 사용을 선택합니다.
  5. 검색 및 양식 기록 기억이 선택된 것을 취소합니다.
  6. 변경 사항은 자동으로 저장됩니다.

Chrome 브라우저의 경우 다음 단계를 따르세요.

  1. Chrome 메뉴 아이콘(화면 오른쪽 상단의 막대 세 개)을 클릭합니다.
  2. 설정을 클릭합니다.
  3. 자동 완성 설정을 선택합니다.
  4. 적절한 영역을 펼칩니다.
  5. 자동 완성 설정을 해제로 전환합니다.
  6. 변경 사항은 자동으로 저장됩니다.

추가 구성

Meta 이벤트 관리자를 사용하면 새 연결을 추가하고 추가 도메인을 구성하며 기존 전환 API 게이트웨이 연결에 새 픽셀을 추가할 수 있습니다. 이를 정의하려면 아래의 단계를 따르세요.

파트너 통합을 클릭하면 페이지 왼쪽에 나타납니다.



전환 API 게이트웨이를 선택하여 전환 API 게이트웨이를 엽니다.



이 화면에서는 다음과 같은 항목을 확인할 수 있습니다.

  • 웹사이트 이벤트
    1. 이벤트는 전환 API 게이트웨이 사이트에서 설정되고 Meta 픽셀을 사용하여 Meta에 별도로 전송되는 웹사이트 작업입니다.
  • 웹사이트 도메인
    1. 전환 API 게이트웨이가 픽셀을 통해 연결하도록 구성된 웹사이트입니다.


설정을 클릭하고 원하는 작업을 선택합니다.

다른 전환 API 게이트웨이 연결 추가

이렇게 하면 다른 Meta 픽셀로 새로운 전환 API 게이트웨이 인스턴스를 설정할 수 있습니다. Meta 픽셀 설정 페이지에서와 같이, 대화 상자의 첫 단계는 다음과 같습니다. 이제 새로운 전환 API 게이트웨이 연결을 설치하기 위한 Meta 픽셀을 선택하라고 요청할 것입니다.

다른 Meta 픽셀을 기존 전환 API 게이트웨이 연결에 추가

이 옵션을 사용하면 기존 전환 API 게이트웨이 설치에 다른 Meta 픽셀을 등록할 수 있습니다.

설정 프로세스를 시작하려면 Meta 이벤트 관리자의 설정 탭으로 이동합니다. '기존 전환 API 게이트웨이' 섹션에서 연결 버튼을 클릭합니다.