Meta

Step1. Create Meta Account

① Login Meta official website to apply for an account

Tips:

• It is recommended not to select China when registering with Meta, because it involves filling in the payment account. If you accidentally select China, it is recommended to change the email address and re-register or contact Meta to modify it.
• The payment information must be filled in with a non-mainland bank. If you need to fill in the mainland bank information, you need to contact the Meta contact person to open a whitelist before you can use the mainland bank information to receive payments.

② Create Meta Apps

 

Step2. Create Meta's Business Manager Account

Create Business Manager Account 

Follow these steps to create a business manager account.

 

Step3. Create Meta's Property

(1) Monetization Manager

Go to Monetization Manager (Choose one existed Business or create a new business.)

 

(2) Create Property

Log in to the Monetization Manager through the business management platform account and create property(One property can contain one iOS application and one Android application).

 

(3) Add Platform Choose your platform and display format.

 

(4) Create an app

Create an app in Property

① Apps must be on the AppStore or Google play to use Meta to generate revenue.

② Each application can only be created in one Business Manager(BM) at most. If the application has been created in other BM before, it must apply to the Meta partner to unbind the original BM first.

 

(5) Add Ad Space & Placement

① Each application can correspond to more than one AD Space, which ACTS as a folder for Placements.

② Each AD Space can correspond to multiple placements,which are placements corresponding to various types of scenarios within the app.

Note: Meta's reward video ads are only available for gaming apps, and users of non-gaming apps need to apply to Meta contact for access.

 

(6) Obtain Meta access token (optional)

From August 31st, 2022, Meta will stop the Mediation platform to obtain Audience Network's Report API data through the publisher's System User Access Token. Currently，Mediation platform can obtain the Report API data of Meta Audience Network through the publisher's Meta Oauth authorization.

At present, Taku has completed Meta's new Report API 2.0 solution (obtaining AN Report API data through Oauth authorization). Taku's publishers need to modify the existing Meta Network Account to Oauth authorization on Taku.

Click for details

● Method 1

When you reach step 3 "Integrate Audience Network SDK", click "Generate Token" to generate an access token , a system user access token.
Note: The password of the same Meta account can be reused for all assets in the account

● Method 2

Generate an access token according to the Meta page for obtaining system user password instructions

 

(7) Verify Meta SDK integration

Apps that integrate Meta SDK cannot obtain Meta's official ads if they are not online. You need to configure a test device for verification. Test device number: IDFA (IOS)/GAID (Android)

 

(8) Complete the receiving account information

Complete the payment account information in the business management platform.

 

(9) Start generating income

After the app is launched, when the notification prompts that it can generate revenue and the placement status is green and prompts "Receiving ads", it means that the app is using Meta ads to generate revenue.

 

Step 4. Meta app ID and placement ID

1. App ID

① Enter the Monetization Manager page

② Enter the property page corresponding to the application

③ Get the app id of the corresponding platform

 

2. Placement ID

① Go to Meta's Monetization Manager.

② Monetization Manager→Properties→choose your property→Ad Space→Copy the placement ID

 

3. Configure Meta parameters on Taku

(1) Create a Meta Network in the Taku

① Log in to Taku→Network→ Monetization →Network→ Add new network（Meta)

② After completing the relevant information, click Login with Meta to log in to the Meta account and Oauth authorization. Learn More  At this time, you can enable the Auto Create Ad Source function.

Note: When pulling Meta backend placement data through Meta's API, if the data is too little, the API will not return data. That is, if the data volume is too small, it is impossible to pull Meta's impression and revenue data to the TopOn backend through the API. For details, please refer to Meta's API documentation.

 

(2) Add advertising source

① Fill in the placement ID of the Meta placement corresponding to the Taku placement

② The mapping between Meta and Taku placement is as follows

Meta placement type	Taku placement type	Note
Rewarded Video	Rewarded	Unit Type=Rewarded Video
Rewarded Interstitial Ad	Rewarded	Unit Type=Rewarded Interstitial
Interstitial	Interstitial	-
Native	Native	Unit Type = Native(Self-rendering) or Native(Template rendering)， Please refer to the integration method： Native(Self-rendering)、Native(Template rendering)
Native Banner	Native	Unit Type = Native Banner(Self-rendering) or Native(Template rendering)，Please refer to the integration method： Native(Self-rendering)、Native(Template rendering)
Banner	Banner	-
Native	Splash (Ad Source Type= Native)	Taku SDK v6.1.78 and above supports the splicing of Meta's native ads into an Splash ad source. When using this function, please reserve 25% of the area at the bottom of the Splash to display the App's logo

 

Step5. Add Meta adapter to your code

Refer to the Taku SDK integration documentation

【IOS14 Important Notes】 In order to ensure the monetization effect of Meta ads, while integrating Taku SDK, you also need to complete the requirements of the Meta integration documentation Advertising Tracking Enabled and SKAdNetwork settings

 

Step 6. Meta Test Guide

Note: Do not use Meta's official ID test multiple times during integration testing, especially don't use test equipment to click on Meta's official ID advertisement, otherwise it may be misjudged as a fake ad request (recommended to refer to Taku's test guidelines or use Meta's official test ID test)

(1) Note before testing

① The Meta APP has been downloaded on the test device and a valid account has been logged in. (Cannot be a blocked or restricted account) The reason is that Meta only fills ads for valid users who log in to its own APP.

② VPN to the United States (Because the US area has more ad filling, it is easy to test. Use the US VPN to test first.)

 

(2) Testing with test ads

① Use Taku debugging mode.
To facilitate developers to test and verify their own ad integration, Taku provides a DebuggerConfig. You can call the API in your own project, configure the information required for testing, use the test ad sources that Taku pre-configured for various networks, perform various ad behaviors, and then locate problems in ad integration through log output.

• iOS

• Android

② Use the Meta placement ID of your own application to configure the test device in the Meta dashboard.

Path: Meta dashboard --Monetization Management Tools--Properties--Test Adding a Test

Device Reference: Testing Audience Network Integration Using a Test Device | Facebook Business Help Center

③ Use the Meta official ID/or Taku test ID (any one way of the above two is OK), set the test mode in the code, and test. How to Set test mode in code ?

Call ATSDK.setBiddingTestDevice("AndroidId"); to open the Bidding test mode. (AndroidId is obtained in log print)If the bidding is successful after the Bidding test mode is turned on, and the advertisement is filled successfully, the Meta advertisement is integrated correctly

④ If the advertisement cannot be displayed, please troubleshoot the problem according to the error code in the log

• iOS

• Android

⑤ After using the test ID or the test mode is normal, the integration is normal.

 

(3) After the integration is correct, use the official id test ( be careful not to request multiple times for live meta ad with your test device, it is recommended to use the test id test as much as possible )

If the official ID cannot be displayed, troubleshooting steps:

① Check the advertising source configuration in the Taku dashboard First make sure that the Meta's application ID and placements ids are configured correctly in Taku dashboard.Then check to see if the ad type matches correctly . For example: whether the splash in Meta matches the splash in Taku, etc. Reference link for matching Taku and Meta ad types:

② Meta dashboard checking

a. Fill Meta payment information : Whether the receiving account is filled in completely, use a non-mainland China account.

b. Check the property status : Check whether the application creation process in the Meta dashboard has been completed. If not, complete the steps accordingly.

Pay attention to the following : application details, payment account, and verification parts must be in green tick.

c. Check Meta account status : Check the Home, Issues, etc. tabs for any issues and resolve them accordingly.

d. Judging the status of the Meta advertisement placements, if it is newly created, it may take a period of time to take effect. And adjust accordingly by referring to the link of placement status below.Placement status reference link

Recommended actions: If the Meta placement ID creation time is too long: Create a new Meta ID, use a US VPN, and test it (clear the cache on the mobile phone, and adjust the time to 2 hours later); try to change the device to test. If the Meta placement ID creation time is too short: wait 2 hours to test.

③ Confirm whether you have used VPN to America to test.

④ Check the application itself in Store : Note that both Android and iOS applications need to be officially launched, and it may be recognized by Meta after a period of time. If it is an Android application, make sure that in the Google Play Console it is in public status.

⑤ Add test equipment to test the official ID You can add test equipment in the Meta background and use the official ID to test. Refer to point 2 above, step 3. Use the Meta placement ID of your own application to configure the test device in the Meta dashboard.

Path: Meta dashboard --Monetization Management Tools--Properties--Test

Adding a Test Device Reference: Testing Audience Network Integration Using a Test Device | Facebook Business Help Center

⑥ Solve the problem according to the error code in the test log.The following is the Taku error code link

• iOS
• Android

⑦ Meta problem Checklist link (add property_id in the end of the following link to see what steps are still missing in the integration process) https://developers.facebook.com/tools/property/checklist/?property_id=

 

FAQ

(1) Where is the Meta Help Center?

① Advertisement Monetization Access Guide

Provides guidance on in-app ad monetization through Meta. Audience Network Introduction

② Meta payment problem help

Use this link to initiate payment-related tickets to Meta. Facebook payment help for income generators

(2) What should I do if the Meta Reporting API authorization expires?

① Log in with the Facebook account that you used to authorize Taku

② Go to Facebook-Settings & Privacy-Business Integration Tools to remove the authorization for Taku

③ The path to re-login and authorize Meta in the Taku backend is: Taku - Network -Meta-Edit-Click to re-authorize