تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار مسار الاشتراك
من القرارات المهمة في "برنامج شركاء المحتوى في تطبيقات Google" اختيار مسار الاشتراك لإعداد المستخدمين. الغرض من الاشتراك هو السماح للمستخدمين بإنشاء حساب جديد على AdSense (أو تسجيل الدخول إلى حساب حالي على AdSense) وربطه بمنصتك. يعتمد الخيار الذي تختاره على الموارد التقنية التي تريد استثمارها في التطوير وتجربة الإعداد التي تريد تقديمها للمستخدمين.
الخيار 1: عملية بدون واجهة برمجة تطبيقات
يتطلب الخيار 1 أقل الموارد الفنية لأنّه لا يستخدم واجهة برمجة تطبيقات. ستحتاج فقط إلى مطوّر ويب لإنشاء واجهة المستخدم في منصتك. في المقابل، يتطلّب هذا الخيار من المستخدمين اتّخاذ المزيد من الخطوات لإكمال عملية الاشتراك.
نظرة عامة على خطوات الاشتراك بدون استخدام واجهة برمجة التطبيقات
التنفيذ
لتنفيذ عملية اشتراك بدون واجهة برمجة تطبيقات، عليك توفير مكوّن واجهة مستخدم لتحقيق الربح من AdSense. على سبيل المثال، في الصفحة التي يصل فيها المستخدمون إلى "ملف التعريف" أو "إعدادات الحساب"، أضِف صفحة تحقيق الربح التي تتضمّن ما يلي:
- وصف موجز لخدمة AdSense وطريقة تفاعلها مع منصّتك يجب أن يكون المستخدمون على دراية تامة بأنّهم إما يشتركون في حساب جديد على AdSense أو يستخدمون حسابهم الحالي على AdSense.
- معلومات عن سياسات برنامج AdSense يجب أن يكون جميع المستخدمين الذين يشتركون على دراية ببرنامج AdSense وسياساته.
- حصة الأرباح التي سيحصل عليها المستخدمون من المهم أن توضِّح للمستخدمين صراحةً النسبة المئوية لأرباح AdSense التي ستحتفظ بها والنسبة المئوية التي سيحتفظ بها الناشر. ستعرض AdSense هذه المعلومات أيضًا أثناء عملية الإعداد.
- زر "ربط AdSense" سيؤدي هذا الزر إلى فتح علامة تبويب جديدة ونقل المستخدم إلى الصفحة الصحيحة في AdSense استنادًا إلى ما إذا كان لديه حساب حالي على AdSense أم لا.
مثال على عنوان URL مخصّص:
https://adsense.google.com/adsense/signup?url={platform-site-url}
ملاحظة: ستزوّدك Google بعنوان URL لصفحة الاشتراك المخصّصة، وستساعدك في تحديد محتوى متغيّر عنوان URL.
- مربّع إدخال لجمع الرقم التعريفي للناشر في AdSense الخاص بالمستخدم وتخزينه بعد أن يزور المستخدم الرابط أعلاه، عليه نسخ معرّف الناشر ولصقه في مربّع الإدخال هذا.
ملاحظة مهمة: من المهم تخزين معرّف الناشر الخاص بالمستخدم حتى تتمكّن من الإشارة إلى صفحات المحتوى الخاصة بالمستخدم باستخدام معلومات الناشر الصحيحة. اطّلِع على مقالة إضافة علامة الإعلان إلى صفحاتك للحصول على مزيد من المعلومات.
تأكَّد من التحقّق من صحة السلسلة التي أدخلتها. تنسيق رقم تعريف الناشر هو: pub-1234567890987654
أو بمصطلحات التعبير العادي: pub\-\d{16}
ملاحظة مهمة: قد يلصق بعض مستخدمي AdSense رقم تعريف الناشر بدون النقر على الزر "ربط AdSense". من المهم إعلام المستخدمين بأنّه يجب إدراج نطاق المنصة في صفحة المواقع الإلكترونية في حساباتهم على AdSense قبل أن يتم عرض الإعلانات. وهذا هو الغرض الأساسي من هذا الزر.
- حالة الإشارة إلى المستخدم. سيريد المستخدمون معرفة ما إذا تمّ وضع رمز إعلاناتهم على صفحاتهم أم لا. كجزء من تجربة المستخدم، أطلِع المستخدمين على أنّك أشرت إلى صفحاتهم باستخدام رقم تعريف الناشر الخاص بهم في AdSense. يمكنك أيضًا ملء العلامة الوصفية للحساب الفرعي التي ستساعد AdSense أثناء خطوات إثبات ملكية الموقع الإلكتروني. ويؤدي ذلك أيضًا إلى إزالة الحاجة إلى نشر علامات الإعلانات على صفحاتهم نيابةً عن المستخدم.
الخيار 2: عملية استخدام واجهة برمجة التطبيقات شبه مُساعَدة
يستخدم الخيار 2 AdSense Management API لتبسيط عملية الاشتراك قليلاً. وتتطلّب هذه الطريقة المزيد من الموارد الفنية، ولكنها تقلّل من عدد الخطوات التي يحتاج المستخدمون إلى اتّخاذها للاشتراك في AdSense.
نظرة عامة على عملية واجهة برمجة التطبيقات شبه التلقائية
التنفيذ
لتنفيذ عملية اشتراك شبه مُساعدة باستخدام واجهة برمجة التطبيقات، عليك توفير مكوّن واجهة مستخدم لتحقيق الربح من AdSense. على سبيل المثال، في الصفحة التي يصل فيها المستخدمون إلى "ملف التعريف" أو "إعدادات الحساب"، أضِف صفحة تحقيق الربح التي تتضمّن ما يلي:
- وصف موجز لخدمة AdSense وطريقة تفاعلها مع منصّتك يجب أن يكون المستخدمون على دراية تامة بأنّهم يشتركون في حساب على Google AdSense أو يستخدمون حسابهم الحالي على AdSense.
- معلومات عن سياسات برنامج AdSense يجب أن يكون جميع المستخدمين الذين يشتركون على دراية ببرنامج AdSense وسياساته.
- حصة الأرباح التي سيحصل عليها المستخدمون من المهم أن توضِّح للمستخدمين صراحةً النسبة المئوية لأرباح AdSense التي ستحتفظ بها والنسبة المئوية التي سيحتفظ بها الناشر. ستعرض AdSense هذه المعلومات أيضًا أثناء عملية الإعداد.
- زر "ربط AdSense" سيمنحك هذا الزر إذنًا بصفتك النظام الأساسي للوصول إلى معلومات حساب عميل AdSense باستخدام AdSense Management API. يُرجى اتّباع التعليمات الواردة في مستندات المطوّرين لدينا لإعداد هذا الإجراء. باستخدام واجهة برمجة التطبيقات هذه، يمكنك تنفيذ الخطوتَين التاليتَين.
- استخدِم AdSense Management API لجمع الرقم التعريفي للناشر في AdSense الخاص بالمستخدم. تأكَّد من التحقّق من صحة السلسلة التي أدخلتها.
تنسيق رقم تعريف الناشر هو: pub-1234567890987654
أو بمصطلحات التعبير العادي: pub\-\d{16}
ملاحظة مهمة: من المهم تخزين رقم تعريف الناشر الخاص بالمستخدم حتى تتمكّن من الإشارة إلى صفحات المحتوى الخاصة بالمستخدم باستخدام معلومات الناشر الصحيحة. اطّلِع على إضافة علامة الإعلان إلى صفحاتك للحصول على مزيد من المعلومات.
- استخدِم AdSense Management API للتحقّق مما إذا كان المستخدم قد أضاف موقع المنصة إلى حسابه على AdSense. إذا لم يكن الأمر كذلك، اطلب من المستخدم اتّباع الرابط أدناه لإكمال عملية الإعداد. اسم الموقع الإلكتروني الذي يجب البحث عنه في واجهة برمجة التطبيقات هو المتغيّر
{platform-site-url} في الرابط أدناه.
https://adsense.google.com/adsense/signup?url={platform-site-url}
ملاحظة: ستزوّدك Google بعنوان URL لصفحة الاشتراك المخصّصة، وستساعدك في تحديد محتوى متغيّر url.
- - حالة الإشارة إلى المستخدم. سيريد المستخدمون معرفة ما إذا تمّ وضع رمز إعلاناتهم على صفحاتهم أم لا. كجزء من تجربة المستخدم، أطلِع المستخدمين على أنّك أشرت إلى صفحاتهم باستخدام رقم تعريف الناشر الخاص بهم في AdSense. يمكنك أيضًا ملء العلامة الوصفية للحساب الفرعي التي ستساعد AdSense أثناء خطوات إثبات ملكية الموقع الإلكتروني. ويؤدي ذلك أيضًا إلى إزالة الحاجة إلى نشر علامات الإعلانات على صفحاتهم نيابةً عن المستخدم.
الخيار 3: Embedded Connect
تزيل ميزة "الربط المضمّن" كلّ التعقيدات المتعلّقة بالتعامل مع حسابات AdSense في حالات مختلفة. استنادًا إلى حالة الحساب والعميل والموقع الإلكتروني لحساب AdSense الخاص بمستخدم معيّن، ستقدّم عملية "الربط المضمّن" تجربة إعداد مخصّصة لكل مستخدم كي لا يكون عليك إجراء ذلك.
يتضمّن التنفيذ مكتبة JavaScript وdiv فارغًا حيث ستعرض AdSense تطبيقات مصغّرة للاشتراك، وبعض دوالّ ردّ الاتصال التي ستسمح لك بحفظ رقم تعريف الناشر بعد أن يكمل المستخدم عملية الاشتراك. يمكنك استخدام AdSense Management API بشكلٍ إضافي لتحسين التجربة، على سبيل المثال من خلال استرداد الوحدات الإعلانية أو حالة الإعلانات التلقائية.
مزيد من المعلومات عن Embedded Connect
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
[null,null,[],[[["\u003cp\u003eAdSense for Platforms (AFP) offers three signup flow options to onboard users, each with varying technical requirements and user experiences.\u003c/p\u003e\n"],["\u003cp\u003eThe API-less flow is the simplest to implement but requires more user steps; the Semi-assisted API flow utilizes the AdSense Management API for a smoother experience; and Embedded Connect provides a fully customized and automated signup process.\u003c/p\u003e\n"],["\u003cp\u003eAll signup flows necessitate clear communication with users about AdSense policies, revenue share, and tagging status, ensuring transparency and understanding.\u003c/p\u003e\n"],["\u003cp\u003eRegardless of the chosen flow, securely storing the user's AdSense Publisher ID is crucial for proper ad serving and revenue tracking.\u003c/p\u003e\n"],["\u003cp\u003eAFP provides flexibility for platforms to tailor the signup experience to their specific needs and technical capabilities while adhering to AdSense guidelines.\u003c/p\u003e\n"]]],["The document outlines three signup flows for integrating AdSense into a platform. The API-less flow requires users to manually connect their AdSense account via a link and input their publisher ID. The semi-assisted API flow utilizes the AdSense Management API to retrieve the user's publisher ID and check their site status, reducing user steps. Embedded Connect, a third option, uses a JavaScript library for a streamlined experience and handles complex account states automatically. All options involve displaying AdSense policies and revenue sharing information.\n"],null,["Choose a sign up flow\n---------------------\n\nAn important decision with AFP is to choose a sign up flow to onboard your users. The purpose of the sign up is to allow your users to create a new AdSense account (or sign in to an existing AdSense account) and link it to your platform. The option you choose will depend on the technical resources you want to invest in development and the onboarding experience you want to provide for your users.\n\n### Option 1: API-less flow\n\nOption 1 requires the fewest technical resources as it doesn't use an API. You will only need a web developer to build the user interface within your platform. However, the trade-off is that this option requires your users to take more steps to complete the signup flow.\n\n#### Overview of the API-less signup flow\n\n#### Implementation\n\nTo implement an API-less signup flow, you need to provide a UI component for AdSense monetization. For example, on the page where your users access their \"user profile\" or \"account settings\", add a monetization page that includes the following:\n\n- A short description of AdSense and how it interacts with your platform. Users should be completely aware that they're either signing up for a new AdSense account or using their existing AdSense account.\n- Information about the [AdSense Program policies](https://support.google.com/adsense/answer/48182). All users who sign up should be aware of the AdSense Program and its policies.\n- The revenue share that your users will receive. It's important to explicitly show users what percentage of the AdSense revenue you will keep and what percentage the publisher will keep. AdSense will additionally show this information during the onboarding flow.\n- A \"Connect AdSense\" button. This button will open a new tab and take the user to the correct page in AdSense depending on whether or not they have an existing AdSense account. \n Example custom URL: \n `https://adsense.google.com/adsense/signup?url={platform-site-url}` \n **Note:** Google will provide you with the URL of the custom signup page, and help you define the contents of the URL variable.\n- An input box to collect and store the user's AdSense publisher ID. After a user visits the link above, they will need to copy and paste their publisher ID into this input box. \n **Important:** It's critical that you store the user's publisher ID so that you can tag the user's content pages with the correct publisher information. See the [Add the ad tag to your pages](/adsense/platforms/transparent/ad-tags) for more information. \n Make sure you validate the inputted string. The format of a publisher ID is: `pub-1234567890987654` \n Or in regex terms: `pub\\-\\d{16}` \n **Important:** Some AdSense users may paste their publisher ID without clicking on the \"Connect AdSense\" button. It's important to let users know that the **Sites** page in their AdSense account needs to have the platform domain listed before ads can be served. This is the primary purpose of this button.\n- The user's tagging status. Users will want to know whether their ad code has been placed on their pages or not. As part of the user experience, let your users know when you've tagged their pages with their AdSense publisher ID. You can additionally populate the [child account meta tag](/adsense/platforms/transparent/meta-tags#child_account) which will assist AdSense during the site verification steps. This also removes the need to publish ad tags on their pages on the user's behalf.\n\n### Option 2: Semi-assisted API flow\n\nOption 2 uses the [AdSense Management API](https://developers.google.com/adsense/management) to slightly simplify the signup flow. It requires more technical resources but reduces the number of steps your users need to take to sign up for AdSense.\n\n#### Overview of the semi-assisted API flow\n\n#### Implementation\n\nTo implement a semi-assisted signup flow with an API, you need to provide a UI component for AdSense monetization. For example, on the page where your users access their \"user profile\" or \"account settings\", add a monetization page that includes the following:\n\n- A short description of AdSense and how it interacts with your platform. Users should be completely aware that they are signing up for a Google AdSense account, or using their existing AdSense account.\n- Information about the [AdSense Program policies](https://support.google.com/adsense/answer/48182). All users who sign up should be aware of the AdSense Program and its policies.\n- The revenue share that your users will receive. It's important to explicitly show users what percentage of the AdSense revenue you will keep and what percentage the publisher will keep. AdSense will additionally show this information during the onboarding flow.\n- A \"Connect AdSense\" button. This button will authorize you as the platform to access an AdSense customer's account information using the [AdSense Management API](https://developers.google.com/adsense/management). Please follow the instructions on our developer documentation to set this up. Using this API you can perform the next two steps.\n- Use the AdSense Management API to collect the user's AdSense publisher ID. Make sure you validate the inputted string. \n The format of a publisher ID is: `pub-1234567890987654` \n Or in regex terms: `pub\\-\\d{16}` \n **Important:** It's critical that you store the user's publisher ID so that you can tag the user's content pages with the correct publisher information. See the See the [Add the ad tag to your pages](/adsense/platforms/transparent/ad-tags) for more information.\n- Use the AdSense Management API to check if the user has added the platform site to their AdSense account. If not, ask the user to follow the link below to complete the set up. The name of the site you should check for in the API is the `{platform-site-url}` variable in the link below. \n `https://adsense.google.com/adsense/signup?url={platform-site-url}` \n **Note:** Google will provide you with the URL of the custom signup page, and help you define the contents of the url variable.\n- - The user's tagging status. Users will want to know whether their ad code has been placed on their pages or not. As part of the user experience, let your users know when you've tagged their pages with their AdSense publisher ID. You can additionally populate the [child account meta tag](/adsense/platforms/transparent/meta-tags#child_account) which will assist AdSense during the site verification steps. This also removes the need to publish ad tags on their pages on the user's behalf.\n\n### Option 3: Embedded Connect\n\nEmbedded Connect removes all the complexity of dealing with AdSense accounts in different states. Depending on the account, ad client and site statuses for a given user's AdSense account, the Embedded Connect flow will present a customized onboarding experience for each user so that you don't have to.\n\nThe implementation involves a JavaScript library, an empty div where AdSense will render a sign-up widget, and some callback functions which will allow you to save the publisher ID once the user has completed the sign-up flow. You can supplementally use the [AdSense Management API](/adsense/management) to augment the experience, for example by retrieving ad units or the state of Auto ads.\n\n[Learn more about Embedded Connect](/adsense/platforms/transparent/embedded-connect)"]]
