ভূমিকা
অফারওয়াল কাস্টম চয়েস এপিআই আপনাকে Google অ্যাড ম্যানেজারে অফারওয়ালের সাথে আপনার নিজস্ব কাস্টম নগদীকরণ সমাধানকে একীভূত করতে দেয়।
অফারওয়ালের সাথে আপনার নিজস্ব নগদীকরণ সমাধান সংহত করতে, এই কাস্টম চয়েস সেটআপ পদক্ষেপগুলি অনুসরণ করুন। সংক্ষেপে:
অ্যাড ম্যানেজারে গোপনীয়তা এবং বার্তাপ্রেরণ ট্যাবের মধ্যে থেকে আপনার অফারওয়ালের জন্য "কাস্টম চয়েস" বিকল্পটি সক্ষম করুন৷
আপনি যেখানে আপনার অফারওয়াল প্রকাশ করেছেন সেই সাইটের
<head>এবং</head>ট্যাগের মধ্যে কাস্টম জাভাস্ক্রিপ্ট যোগ করুন।অনুসরণকারী বিভাগগুলিতে সংজ্ঞায়িত একটি
CustomOfferwallChoiceঅবজেক্ট ইনস্ট্যান্টিয়েট করুন এবং উইন্ডোতে আপনার অফারওয়ালের সাথে এটি নিবন্ধন করুন ।
নমুনা কোড
দ্রুত শুরু করতে, একটি অফারওয়াল কাস্টম চয়েস এপিআই বাস্তবায়নের এই কার্যকরী নমুনাটি দেখুন।
API ব্যবহার
একটি CustomOfferwallChoice হল একটি JavaScript অবজেক্ট যা আপনি আপনার কাস্টম নগদীকরণ বাস্তবায়নকে একীভূত করতে আপনার অফারওয়ালে প্লাগ ইন করেন।
// Define your custom choice.
class CustomOfferwallChoice {
// Initialize your custom choice, which may include loading or preparing any
// resources required to function.
async initialize(params: InitializeParams): Promise<InitializeResponseEnum> {...}
// Show your custom choice on the web page, which may be a subscription
// service, micropayments service, rewarded ad, etc.
async show(): Promise<boolean> {...}
}
// Register your custom choice with your Offerwall.
window.googlefc = window.googlefc || {};
window.googlefc.offerwall = window.googlefc.offerwall || {};
window.googlefc.offerwall.customchoice = window.googlefc.offerwall.customchoice || {};
window.googlefc.offerwall.customchoice.registry = new CustomOfferwallChoice();
পদ্ধতির সংজ্ঞা
এই বিভাগটি প্রতিটি পদ্ধতির বর্ণনা করে যা বাস্তবায়নের জন্য একটি CustomOfferwallChoice প্রয়োজন।
আরম্ভ করা
initialize(params: InitializeParams ): Promise< InitializeResponseEnum >
আপনার কাস্টম নগদীকরণ সমাধান শুরু করুন। এই ফাংশনটি অন্য যেকোন ফাংশনের আগে আহ্বান করা হয় এবং প্রদত্ত পৃষ্ঠা লোডের সময় সর্বাধিক একবার আহ্বান করা হবে বলে আশা করা যেতে পারে।
উদাহরণ
async initialize(params: InitializeParams): Promise<InitializeResponseEnum> {
// If your custom choice is inoperable on this page, return CUSTOM_CHOICE_DISABLED,
// causing your Offerwall to exclude the custom choice option when rendering.
const isCustomChoiceEnabled: boolean = await this.initializeCustomOfferwallChoice(params);
if (!isCustomChoiceEnabled) {
resolve(googlefc.offerwall.customchoice.InitializeResponseEnum.CUSTOM_CHOICE_DISABLED);
}
// If the user should automatically be granted page access on page load, return
// ACCESS_GRANTED, causing your Offerwall to be ineligible to render on this page.
const isAccessGranted: boolean = await this.shouldUserBeGrantedPageAccess();
if (isAccessGranted) {
resolve(googlefc.offerwall.customchoice.InitializeResponseEnum.ACCESS_GRANTED);
}
// If the user shouldn't automatically be granted page access on page load, return
// ACCESS_NOT_GRANTED, causing your Offerwall to be eligible to render on this page.
resolve(googlefc.offerwall.customchoice.InitializeResponseEnum.ACCESS_NOT_GRANTED);
}
প্রদর্শন
show(): Promise<boolean>
আপনার কাস্টম নগদীকরণ সমাধান রেন্ডার করুন এবং ব্যবহারকারীর নগদীকরণ ক্রিয়াগুলি পরিচালনা করুন৷ ব্যবহারকারী কাস্টম পছন্দ বিকল্পে ক্লিক করলে এই পদ্ধতিটি আপনার অফারওয়াল দ্বারা চালু করা হয়। নগদীকরণ একটি সদস্যতা পরিষেবা, মাইক্রোপেমেন্ট পরিষেবা, পুরস্কৃত বিজ্ঞাপন এবং আরও অনেক কিছু সহ যে কোনও রূপ নিতে পারে৷ আহ্বান করা হলে, এই প্রতিশ্রুতির সমাধান না হওয়া পর্যন্ত আপনার অফারওয়াল লুকানো থাকে এবং এর মধ্যে পৃষ্ঠার সামগ্রী গেট করার দায়িত্ব আপনার CustomOfferwallChoice এর। এই প্রতিশ্রুতির সমাধান হয়ে গেলে, আপনার CustomOfferwallChoice অবশ্যই ওয়েব পৃষ্ঠায় আর দৃশ্যমান হবে না তা নিশ্চিত হতে হবে।
show() ফাংশনের প্রতিশ্রুতির রেজোলিউশনের পরে, আপনাকে অবশ্যই:
আপনার রেন্ডার করা নগদীকরণ সমাধান লুকান।
ব্যবহারকারী পৃষ্ঠা বিষয়বস্তুতে অ্যাক্সেস পেয়েছে কিনা তা নির্দেশ করে একটি বুলিয়ান মান ফেরত দিন:
-
true: ব্যবহারকারী পৃষ্ঠার বিষয়বস্তুতে অ্যাক্সেস পেয়েছে। এই ক্ষেত্রে, প্রতিশ্রুতি রেজোলিউশনে আপনার অফারওয়াল আবার রেন্ডার করা হবে না। -
false: ব্যবহারকারী পৃষ্ঠার বিষয়বস্তুতে অ্যাক্সেস পায়নি। এই ক্ষেত্রে, প্রতিশ্রুতি রেজোলিউশনের পরে আপনার অফারওয়াল আবার রেন্ডার করা হবে।
-
উদাহরণ
async show(): Promise<boolean> {
// Show your custom choice dialog and hide it once the user completes an action.
const didUserGainAccessToPage: boolean = await this.showCustomChoiceDialogUntilUserAction();
resolve(didUserGainAccessToPage);
}
কাস্টম চয়েস রেজিস্ট্রেশন
রেজিস্ট্রেশনের মধ্যে নিম্নলিখিত উইন্ডো রেজিস্ট্রিতে আপনার তাত্ক্ষণিক CustomOfferwallChoice অবজেক্ট পাস করা অন্তর্ভুক্ত: window.googlefc.offerwall.customchoice.registry
উদাহরণ
// Register your custom choice with your Offerwall.
window.googlefc = window.googlefc || {};
window.googlefc.offerwall = window.googlefc.offerwall || {};
window.googlefc.offerwall.customchoice = window.googlefc.offerwall.customchoice || {};
window.googlefc.offerwall.customchoice.registry = new CustomOfferwallChoice();
API প্রকার সংজ্ঞা
এই বিভাগটি API-তে প্রতিটি ডেটা টাইপ বর্ণনা করে।
বস্তুর সংজ্ঞা
এই বিভাগটি API-তে প্রতিটি বস্তুর সংজ্ঞা বর্ণনা করে।
প্যারামস শুরু করুন
ইনিশিয়ালাইজ ফাংশনের জন্য প্যারামিটার অবজেক্ট টাইপ।
| সম্পত্তি | টাইপ | বর্ণনা |
|---|---|---|
offerwallLanguageCode | string | undefined | BCP 47 দ্বারা সংজ্ঞায়িত আপনার অফারওয়ালের ভাষা কোড যা পরিবেশন করা হচ্ছে। |
Enum সংজ্ঞা
এই বিভাগটি API-তে প্রতিটি enum সংজ্ঞা বর্ণনা করে।
googlefc.offerwall.customchoice.InitializeResponseEnum
ইনিশিয়ালাইজ ফাংশনের জন্য প্রতিক্রিয়া enum প্রকার।
| গণনা সদস্য | বর্ণনা |
|---|---|
CUSTOM_CHOICE_DISABLED | আপনার অফারওয়ালে কাস্টম পছন্দ বিকল্পটি অক্ষম করুন। কাস্টম পছন্দ অক্ষম করা থাকলে, আপনার অফারওয়াল শুধুমাত্র করতে পারে অন্যান্য যোগ্য পছন্দের সাথে রেন্ডার করুন; অন্য কোন পছন্দ যোগ্য না হলে, আপনার অফারওয়াল পৃষ্ঠায় রেন্ডার হবে না। |
ACCESS_GRANTED | পৃষ্ঠা লোড হলে ব্যবহারকারী পৃষ্ঠা অ্যাক্সেস মঞ্জুর করুন. যদি এই প্রতিক্রিয়াটি ফেরত দেওয়া হয় তবে আপনার অফারওয়াল পৃষ্ঠায় রেন্ডার হবে না। |
ACCESS_NOT_GRANTED | পৃষ্ঠা লোড হলে ব্যবহারকারী পৃষ্ঠা অ্যাক্সেস মঞ্জুর করবেন না. আপনার অফারওয়াল পৃষ্ঠায় রেন্ডার করার যোগ্য যদি এই প্রতিক্রিয়াটি ফেরত দেওয়া হয়। |