기부 캠페인 API

Customize the Share or create fundraisers on Facebook and Instagram Use Case

This document shows you how to customize the Customize a Meta app with the Share or create fundraisers on Facebook and Instagram Use Case use case you added to your app during the app creation process.

Existing apps

If you have an existing business app that you created with the Fundraisers product with the manage_fundraisers permission, you can still submit this app for App Review. Learn more.

What are permissions and features?

Permissions are how your app asks someone if it can access their data stored on Meta's servers. Learn more.

Features are authorization mechanisms that allow your app to access specific endpoints that don’t require explicit consent from your app users in order to access the user’s data for a specific purpose. Learn more.

When customizing a use case, you will see a list of permissions and features that are available for the use case. A use case has permissions that are required for the use case to work proper. These required permission can't be removed. A use case might also have optional permissions that you can add that provide additional functionality. Optional permissions can be added or removed at any time during development. Only add optional permissions that your app needs in order to work the way you want it to.

Use case customization

  1. Click Dashboard in menu to the left in the App Dashboard. Each use case that you have added to your app is listed here.
  2. Select the use case you want to customize. This allows you to add settings and permissions to make your app work the way you want it to.
  3. Add permissions that your app needs and remove permissions that your app doesn't need.
    • If a permission or feature is required for a use case, it can't be removed.
  4. Click Ready to test to test each use case. If you need to submit your app for Meta App Review, you must test each use case. The Meta's Graph API Explorer allows you to test your queries and get access tokens and code samples for your queries.
  5. Click Dashboard to repeat the above for each use case.

Permissions

To customize the Fundraiser API use case, select Share or create fundraisers on Facebook and Instagram. You are redirected to a list of permissions.

The manage_fundraisers permission is required for this use case and added by default.

Click Add next to each additional feature or permission that your app needs to work the way you want it to.

앱에서 비즈니스용 Facebook 로그인을 구현하는 경우 다음 단계를 따르세요.

설정

  1. 앱 대시보드의 왼쪽 메뉴에서 비즈니스용 Facebook 로그인을 클릭합니다.
  2. 설정을 선택합니다.
  3. 리디렉션 URI를 추가하고 URI 확인을 클릭하여 유효성을 검사합니다.
  4. 클라이언트 OAuth 설정을 맞춤 설정합니다.
  5. 승인 해제 콜백 URL을 추가합니다.
  6. 데이터 삭제 요청 URL을 추가합니다.
  7. 변경 내용 저장을 클릭합니다.

빠른 시작

빠른 시작을 사용하여 비즈니스용 Facebook 로그인을 앱에 추가합니다.

  1. 빠른 시작을 클릭합니다.
  2. 이 앱에 대해 각 플랫폼을 선택하고 맞춤 설정합니다.
  3. Facebook 로그인 버튼을 앱에 추가합니다.

구성

비즈니스용 Facebook 로그인의 이 선택적 기능을 사용하면 여러 구성을 만들어 다양한 사용자 집단에 표시할 수 있습니다. 구성을 만들 때 다음 항목을 선택할 수 있습니다.

  • 앱 사용자에게 표시할 로그인 버전 유형
  • 비즈니스 클라이언트에 요청하고자 하는 액세스 토큰 유형(사용자 액세스 토큰 또는 시스템 사용자 액세스 토큰) 및 토큰 만료 기간
    • 사용자 액세스 토큰을 선택한다면 앱 사용자가 개인용 Facebook 계정을 사용하여 로그인할 것입니다.
    • 시스템 사용자 액세스 토큰을 선택한다면 앱 사용자가 비즈니스 포트폴리오를 사용하여 로그인해야 합니다. 이 토큰은 이 구성에 비즈니스 자산(예: Facebook 페이지, 광고 계정, Instagram 계정)에 대한 지속적인 액세스 권한이 필요할 경우에만 필요합니다.
  • 클라이언트에 요청하고자 하는 비즈니스 자산
  • 앱 사용자가 앱에 부여해야 하는 권한

App Review

If you are submitting an existing business app with Fundraiser product for App Review, please visit our App Review documentation to learn how to submit your app. If you are submitting a new use case app, following these instructions:

  1. In the left side menu go to Review > App Review. Click the Edit button to start your submission. All permissions and features you are requesting, with links to the documentation for each, are listed here.
  2. Complete App Settings – Click Review your app settings to add or update any app settings such as app icon, privacy policy URL, and app category. This step must be complete before continuing.
  3. Reviewer instructions – Click Provide reviewer instructions A popup dialog appears for each platform on which you app is available. Select each platform and answer the questions with questions for our reviewers to test your use case implementations. Click Done.
  4. Click each permission and feature you requested.
  5. Click the checkbox to agree to use each permission or feature in accordance with its allowed usage. If your app doesn't use a permission or feature listed, remove it by clicking the trashcan icon.
  6. Click the Submit for Review button in the lower right.

Publish

Required app assets

To publish your app, you need the following assets:

  • An app icon – Your app's unique icon image; this file must be less than 5 MB, between 512 x 512 and 1024 x 1024 pixels, and in JPEG, GIF or PNG format.
  • Contact information for a Data Protection Officer, if you are doing business in the European Union.
  • A Privacy Policy URL for your app
  • A data deletion URL with instructions or a callback that allows your app user to delete their data from your app.
  1. When you are ready to publish, select Publish in the left side menu.
  2. Review your use cases and requirements.
  3. Click Publish in the lower right corner.

Congratulations on completing your app!

See Also

Visit the following to learn more about the app development process: