Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Escolher um fluxo de inscrição
Uma decisão importante com o AFP é escolher um fluxo de inscrição para integrar seus usuários. O objetivo da inscrição é permitir que os usuários criem uma nova conta do Google AdSense (ou acessem uma conta existente) e a vinculem à sua plataforma. A opção que você escolher depende dos recursos técnicos que você quer investir no desenvolvimento e da experiência de integração que você pretende proporcionar aos usuários.
Opção 1: fluxo sem API
A opção 1 requer menos recursos técnicos por não usar uma API. Você só precisa que um desenvolvedor da Web construa a interface do usuário na sua plataforma. No entanto, a desvantagem é que os usuários precisam seguir mais etapas para concluir o fluxo de inscrição.
Visão geral do fluxo de inscrição sem API
Implementação
Para implementar um fluxo de inscrição sem API, você precisa fornecer um componente de interface para monetização do Google AdSense. Por exemplo, na página em que seus usuários acessam o perfil de usuário ou as configurações da conta, adicione uma página de monetização com o seguinte:
- Uma breve descrição do Google AdSense e de como ele interage com sua plataforma. Os usuários precisam estar totalmente cientes de que estão se inscrevendo em uma nova conta do Google AdSense ou usando uma conta existente.
- Informações sobre as políticas do programa Google AdSense. Todos os usuários que se inscreverem precisam conhecer o programa e as políticas relacionadas.
- A participação na receita que seus usuários vão receber. É importante mostrar explicitamente aos usuários com qual porcentagem da receita do Google AdSense você ficará e qual será a parcela do editor. O AdSense também vai mostrar essas informações durante o fluxo de integração.
- Um botão "Conectar o Google AdSense". Esse botão vai abrir uma nova guia e levar o usuário à página correta no AdSense, dependendo se ele já tem ou não uma conta do AdSense.
Exemplo de URL personalizado:
https://adsense.google.com/adsense/signup?url={platform-site-url}
Observação:o Google vai fornecer o URL da página de inscrição personalizada e ajudar a definir o conteúdo da variável de URL.
- Uma caixa de entrada para coletar e armazenar o ID do editor do Google AdSense do usuário. Depois que um usuário acessar o link acima, ele precisará copiar e colar o ID de editor dele nessa caixa de entrada.
Importante:é fundamental armazenar o ID de editor do usuário para que você possa marcar as páginas de conteúdo do usuário com as informações corretas do editor. Consulte Adicionar a tag de anúncio às suas páginas para mais informações.
Valide a string inserida. O formato de um ID de editor é: pub-1234567890987654
Ou em termos de regex: pub\-\d{16}
Importante:alguns usuários do Google AdSense podem colar o ID de editor sem clicar no botão "Conectar o AdSense". É importante informar aos usuários que a página Sites na conta do Google AdSense precisa ter o domínio da plataforma listado antes que os anúncios possam ser veiculados. Essa é a principal finalidade do botão.
- O status da inclusão de tag do usuário. Os usuários vão querer saber se o código de anúncio foi colocado nas páginas deles ou não. Como parte da experiência do usuário, avise-os quando tiver incluído as tags nas páginas deles com o ID de editor do Google AdSense. Você também pode preencher a metatag da conta filha, que vai ajudar o Google AdSense durante as etapas de verificação do site. Isso também elimina a necessidade de publicar tags de anúncios nas páginas em nome do usuário.
Opção 2: fluxo de API semiassistido
A opção 2 usa a API AdSense Management para simplificar um pouco o fluxo de inscrição. Ela requer mais recursos técnicos, mas reduz o número de etapas que seus usuários precisam seguir para se inscrever no Google AdSense.
Visão geral do fluxo de API semiassistido
Implementação
Para implementar um fluxo de inscrição semiassistido com uma API, você precisa fornecer um componente de interface para monetização do Google AdSense. Por exemplo, na página em que seus usuários acessam o perfil de usuário ou as configurações da conta, adicione uma página de monetização com o seguinte:
- Uma breve descrição do Google AdSense e de como ele interage com sua plataforma. Os usuários precisam estar totalmente cientes de que estão se inscrevendo em uma conta do Google AdSense ou usando uma conta existente.
- Informações sobre as políticas do programa Google AdSense. Todos os usuários que se inscreverem precisam conhecer o programa e as políticas relacionadas.
- A participação na receita que seus usuários vão receber. É importante mostrar explicitamente aos usuários com qual porcentagem da receita do Google AdSense você ficará e qual será a parcela do editor. O AdSense também vai mostrar essas informações durante o fluxo de integração.
- Um botão "Conectar o Google AdSense". Esse botão autoriza você, como plataforma, a acessar as informações da conta de um cliente do AdSense usando a API AdSense Management. Siga as instruções da nossa documentação de desenvolvedores para configurá-lo. Com essa API, você pode seguir as próximas duas etapas.
- Use a API AdSense Management para coletar o ID de editor do Google AdSense do usuário. Lembre-se de validar a string inserida.
O formato de um ID de editor é: pub-1234567890987654
Ou em termos de regex: pub\-\d{16}
Importante:é fundamental armazenar o ID de editor do usuário para que você possa marcar as páginas de conteúdo do usuário com as informações corretas do editor. Consulte Adicionar a tag de anúncio às suas páginas para mais informações.
- Use a API AdSense Management para verificar se o usuário adicionou o site da plataforma à conta do AdSense. Se ele não tiver feito isso, peça para seguir o link abaixo e concluir a configuração. O nome do site que você precisa verificar na API é a variável
{platform-site-url} no link abaixo.
https://adsense.google.com/adsense/signup?url={platform-site-url}
Observação:o Google vai fornecer o URL da página de inscrição personalizada e ajudar a definir o conteúdo da variável de URL.
- - O status da inclusão de tag do usuário. Os usuários vão querer saber se o código de anúncio foi colocado nas páginas deles ou não. Como parte da experiência do usuário, avise-os quando tiver incluído as tags nas páginas deles com o ID de editor do Google AdSense. Você também pode preencher a metatag da conta filha, que vai ajudar o Google AdSense durante as etapas de verificação do site. Isso também elimina a necessidade de publicar tags de anúncios nas páginas em nome do usuário.
Opção 3: conexão integrada
O Embedded Connect elimina toda a complexidade de lidar com contas do AdSense em diferentes estados. Dependendo da conta, do cliente de publicidade e dos status do site da conta do Google AdSense de um determinado usuário, o fluxo de integração incorporado vai apresentar uma experiência de integração personalizada para cada usuário, para que você não precise fazer isso.
A implementação envolve uma biblioteca JavaScript, uma div vazia em que o Google AdSense renderiza um widget de inscrição e algumas funções de callback que permitem salvar o ID do editor depois que o usuário concluir o fluxo de inscrição. Você pode usar a API AdSense Management para melhorar a experiência, por exemplo, recuperando blocos de anúncios ou o estado dos anúncios automáticos.
Saiba mais sobre o Embedded Connect
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],[],[[["\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)"]]
