Audience Network 보고 API V2와 Facebook 로그인 통합

Facebook 로그인은 Audience Network 보고 API 데이터에 액세스할 수 있는 새로운 방식입니다. 이는 수익 관리자 인터페이스에서 제공하던 복사해서 붙여넣는 방식의 기존 시스템 사용자 토큰을 대체할 것입니다. 수익 관리자의 토큰은 비즈니스 외부에 노출될 위험이 있으므로 이 방법을 통해 더욱 안전하게 데이터에 대한 액세스 권한을 부여할 수 있습니다.

이 문서는 퍼블리셔를 대신하여 직접 보고 API 데이터에 액세스하고자 하는 모바일 측정 파트너, 미디에이션 파트너 및 기타 Facebook 파트너에게 지침을 제공하는 데 초점을 맞춥니다.

타사를 사용하여 보고 API 데이터를 가져오는 경우

기존 파트너(모바일 측정 또는 미디에이션 파트너)를 사용하는 경우에는 추가로 필요한 코딩 작업이 없습니다. 파트너가 Facebook 로그인 플로를 통합해야 합니다. 'FB로 로그인' 옵션을 클릭하고 생성할 토큰으로 액세스 권한을 부여하려는 속성을 선택해야 합니다.

ALL 속성을 선택하는 경우 토큰이 비즈니스 아래의 모든 속성에 액세스 권한을 부여합니다. 단, 토큰을 만든 사용자가 비즈니스 관리자의 속성에 대한 액세스 권한이 있어야 합니다.

권한

보고 API를 직접 사용해야 할 경우에는 먼저 Facebook 앱을 만들고 필수 권한을 얻어야 합니다. 앱이 Audience Network 보고 API 데이터에 액세스하려면 read_audience_network_insights 권한이 필요합니다. 앱에 대해 이 권한을 얻으려면 비즈니스가 Audience Network로 온보딩되어야 합니다.

• 수익 관리자에서 온보딩되고 나면 Facebook 개발자 페이지로 이동해서 새 비즈니스 앱을 만들기 시작합니다.

• 비즈니스 계정 필드에서 새로 만든 비즈니스를 선택합니다.

앱을 만든 후에는 'Audience Network'를 선택하고 '설정 버튼'을 클릭하여 수익 관리자 계정에 연결해야 합니다. 어떤 수익 관리자 계정을 연결할지 선택해야 합니다.

developers.facebook.com/apps로 이동해서 조금 전에 만든 앱을 선택해도 수익 관리자 계정을 연결할 수 있습니다.

이제 앱이 Audience Network에 온보딩되고 read_audience_network_insights 권한을 사용할 수 있습니다. read_audience_network_insights를 볼 수 없다면 해당 앱에 수익 관리자 비즈니스 계정에 대한 액세스 권한이 있는지 확인하세요.

이전에 Facebook 로그인으로 read_insights permission을 얻은 경우 해당 권한이 계속 작동합니다. 하지만 read_audience_network_insights 권한으로 전환할 것을 권장합니다.

보고 API 액세스에 접근하는 방법은 사용하는 통합의 유형에 따라 달라집니다. 자신의 사례에 적용되는 지침을 따르세요.

• UI 인터페이스를 사용하지 않는 직접 API 통합
• UI 인터페이스를 사용하는 직접 API 통합

UI 인터페이스를 사용하지 않는 직접 API 통합

프런트엔드/UI 인터페이스가 없는 맞춤(직접) 보고 API 통합을 사용하여 비즈니스만을 위한 데이터를 쿼리하고 있다면 다음 지침을 사용하여 보고 API에 대한 액세스 권한을 얻을 수 있습니다.

그래프 API 탐색기에서 사용자 토큰 만들기

1. 앱에서 이미 '마케팅 API'를 사용할 경우 이 단계를 건너뜁니다. 마케팅 API를 사용하지 않는 경우에는 read_audience_network_insights 권한 얻기에 대한 안내를 따릅니다.
2. 그래프 API 탐색기로 이동합니다.
3. 앱 선택
4. 'read_audience_network_insights' 권한(권한 > 이벤트 그룹 페이지 아래에서 확인 가능)을 선택하고 '액세스 토큰 생성'을 클릭합니다.
1. 이제 잠시 동안 수익 관리자에서 제공하는 토큰 대신 이 토큰을 사용하여 Audience Network 보고 API 데이터에 액세스할 수 있습니다.
2. 고지 사항: 이 토큰은 2시간 이내에 만료되므로 아래의 설명에 따라 장기 실행 액세스 토큰으로 전환해야 합니다.

이 토큰을 장기 실행 액세스 토큰으로 전환합니다.

1. 액세스 토큰 디버거로 이동합니다.
2. 토큰을 삽입하고 '디버그' 누릅니다.
3. 스크롤을 표 가장 아래에 모든 토큰 정보가 나올 때까지 내리고 '액세스 토큰 연장' 버튼을 클릭합니다.

4. 그 후에 얻은 토큰을 복사합니다

이제 이 토큰으로 Audience Network Reporting API 데이터에 액세스할 수 있습니다.

UI 인터페이스를 사용하는 직접 API 통합

다음 가이드는 Facebook 로그인 버튼을 배치할 수 있는 자체 UI 인터페이스를 사용하는 퍼블리셔와 파트너에게 유용합니다. 이 가이드는 자신의 데이터에 액세스하고자 하는 퍼블리셔와 자신의 권한으로 다른 퍼블리셔의 수익 창출 데이터에 액세스하고자 하는 파트너에게 유용합니다.

또한 위의 권한 단계를 포함한 다음 가이드에 대한 전체 데모 영상을 확인할 수 있습니다.

문제가 발생했습니다

이 동영상을 재생하는 중 문제가 발생했습니다.

더 알아보기

• 개발자 포털에서 이전 단계에서 새로 만든 비즈니스 앱을 선택합니다.
• 새 'Facebook 로그인' 제품을 이 앱에 추가합니다.

• '웹' 옵션을 선택하고 통합 절차를 따릅니다.

• Facebook 로그인 경험을 보여줄 웹사이트 URL을 삽입합니다. HTTPS 프로토콜을 지원하는지 확인합니다.

• 통합 단계가 끝나면 사이트에서 Facebook 로그인을 통합할 수 있는 예시 코드가 제공됩니다. 이제 이 코드를 복사할 수 있습니다. 단, 추천된 'public_profile,email' 권한 대신 새로 액세스한 'read_audience_network_insights' 권한을 사용합니다. 업데이트된 권한을 사용하면 버튼 코드가 다음과 같이 작성됩니다.

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

• 앱의 제품 설정 페이지의 Facebook 로그인에서 JavaScript SDK를 활성화합니다.

• 이제 사용자는 개발자의 페이지에서 Facebook 로그인 플로를 통해 액세스 토큰을 생성할 수 있습니다.
• 액세스 토큰은 이전 단계에서 statusChangeCallback JavaScript 메서드로 전달된 인수의 일부로 반환됩니다.

• 기본적으로 이 토큰은 약 2시간 후에 만료됩니다.
• 개발자는 추가적인 사용자 인터랙션 없이 장기 실행 액세스 토큰으로 이 토큰을 연장하도록 요청할 수 있습니다.

  • 장기 실행 토큰은 보고 API 요청을 Facebook 서버로 보낼 때 하루 한 번만 새로 고침됩니다. 요청이 없으면 토큰은 약 60일 후에 만료되고 해당 사용자는 새 토큰을 생성해야 합니다.
• 이 토큰을 통해 제공되는 데이터는 누가 이 Facebook 로그인 플로를 통과하는지와, 어떤 데이터를 공유하기로 동의했는지에 크게 좌우됩니다. 따라서 비즈니스 직원이 이 플로를 통과하는 경우 그 결과로 얻은 액세스 토큰은 이 직원과 동일한 권한을 가지게 됩니다.

문제 해결