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

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

필수 조건

전환 API 게이트웨이를 배포하기 전에 다음 항목을 준비하세요.

  • Meta 픽셀 ID
  • 이벤트 관리자의 관리자 액세스 권한(부분적인 액세스 권한 이용 불가)
  • 모든 웹사이트 도메인
  • DNS 제공자 액세스 권한(하위 도메인 구성에 필요)
  • 클라우드 제공업체 관리자 액세스 권한(예: AWS)

권장 사항: Meta 픽셀에서 고급 매칭을 활성화하여 전환 API 게이트웨이 통합의 성능을 극대화하세요. 고급 매칭을 사용하면 암호화된 고객 연락처 정보를 픽셀 이벤트와 함께 Facebook으로 보내 전환을 늘리는 데 기여하고 더 많은 사람에게 도달할 수 있습니다. 자세한 내용은 여기를 참조하세요.

전환 API 게이트웨이의 현재 버전은 타사 클라우드 제공자로 Amazon Web Services(AWS)만 지원합니다.

  • AWS 계정이 없을 경우 이 가이드에 따라 계정을 생성할 수 있습니다.

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

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


  • 직접 호스팅 옵션을 선택합니다.


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


  • 기본 설정 선택 단계에서 활성화하고자 하는 설정을 선택하고 계속을 클릭합니다.

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


  • 클라우드 제공업체를 선택하라는 메시지가 나오면 AWS App Runner 클라우드 설정 옵션을 선택합니다.


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


2단계: AWS 구성 및 설치

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

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


  • 모든 필드는 미리 입력됩니다. ProvisioningDataBootstrapInformation 필드를 바꾸지 마세요.
  • 스택 만들기를 클릭하여 설치를 시작합니다.
  • 생성 프로세스는 약 15~20분이 소요되며, 생성이 끝나면 새로운 AWS 인스턴스의 출력 탭에 하나의 출력이 기록됩니다. 스택 정보 탭에 CREATE_COMPLETE라고 상태가 나오면 완료된 것입니다.
  • 생성이 완료되면 출력 탭으로 이동합니다.
  • CapigSetupURL을 메모합니다. 이는 전환 API 게이트웨이 UI를 프로비저닝하는 데 필요합니다.


3단계: 데이터 수집 확인

전환 API 게이트웨이 관리자 UI에 액세스하려면 출력 탭 내의 CapigSetupURL을 사용합니다.

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