The document discusses new API methods for managing accounts within a Google Ad Manager managed customer center (MCC) structure programmatically. It introduces three new ManagedCustomerService methods - mutateLink to add/remove accounts from an MCC, getPendingInvitations to retrieve pending account invitations, and mutateManager to move accounts between MCCs. It provides examples of how these methods can be used to extend and manage account invitations and links throughout the lifecycle within the MCC structure.
This document summarizes a presentation about new features in the AwReporting tool. AwReporting is an open source Java tool that allows users to download AdWords reports via the API and generate PDF and HTML reports from the data. The presentation covers how to get reports from AwReporting, generate custom reports, do math with report data, and other new features like Google Drive support and performance improvements. It also provides resources for using AwReporting and lists types of reports that can be generated.
El documento presenta consejos y trucos sobre el uso de reportes en la API de AdWords. Explica conceptos clave como la atribución simple vs múltiple y cómo se registran las estadísticas. Además, clasifica los diferentes tipos de reportes y ofrece ejemplos de cómo obtener la estructura de una cuenta y desarrollar aplicaciones que usen reportes.
The document discusses optimization of online advertising accounts at scale. It introduces several Google services for keyword research and traffic estimation. It then demonstrates Kratu, an open-source tool for discovering optimization opportunities in accounts by analyzing performance data. Kratu uses a push model to surface issues for account managers to address, rather than managers manually reviewing all accounts. The document includes a demo of Kratu analyzing a sample advertising account and ends by discussing upcoming improvements to Kratu.
The document summarizes the new features, changes, and deprecations in version 201402 of the Google AdWords API. Key updates include support for shopping campaigns and new ad extensions in the API, new report types, and a new bidding strategy. ClientLogin authentication has been deprecated and replaced with OAuth2.0. Several campaign features have also moved out of beta testing.
La herramienta AwReporting permite descargar informes de AdWords de forma automatizada y almacenarlos en una base de datos local. Esto reduce la curva de aprendizaje para trabajar con la API de AdWords y proporciona un punto de partida para la automatización y optimización de campañas. La herramienta es de código abierto y puede extenderse fácilmente para crear informes personalizados y integrarse con otros sistemas.
The document discusses using Google's API and services to optimize AdWords campaigns. It covers using the TargetingIdeaService to generate keyword ideas and get statistics on existing keywords. It also discusses using the TrafficEstimatorService to estimate traffic and costs for new campaigns. Finally, it discusses how to optimize existing campaigns by analyzing report data and replacing underperforming keywords.
The document discusses optimizing OAuth 2.0 requests when using the Google AdWords API. It recommends sharing access tokens across threads and servers to minimize requests. Handling access token expiration is key, including proactively refreshing tokens before expiration. A shared storage like a cache can store credentials to avoid duplicate requests. A token management server can further centralize OAuth handling. Security best practices like securely storing refresh and access tokens are also covered.
The presentation provided an overview of Google AdWords feeds including what's new, location feeds, reporting, and best practices. Key updates included feed name uniqueness, new call extension metrics, and three new feed types for apps, reviews, and locations based on Google Places data. Location feeds are associated with a Places account and have attributes and items managed automatically. Reporting on feed item performance is available, and best practices include using built-in versus custom feeds and the proper order for deleting feed components.
This document summarizes a presentation about new features in the AwReporting tool. AwReporting is an open source Java tool that allows users to download AdWords reports via the API and generate PDF and HTML reports from the data. The presentation covers how to get reports from AwReporting, generate custom reports, do math with report data, and other new features like Google Drive support and performance improvements. It also provides resources for using AwReporting and lists types of reports that can be generated.
El documento presenta consejos y trucos sobre el uso de reportes en la API de AdWords. Explica conceptos clave como la atribución simple vs múltiple y cómo se registran las estadísticas. Además, clasifica los diferentes tipos de reportes y ofrece ejemplos de cómo obtener la estructura de una cuenta y desarrollar aplicaciones que usen reportes.
The document discusses optimization of online advertising accounts at scale. It introduces several Google services for keyword research and traffic estimation. It then demonstrates Kratu, an open-source tool for discovering optimization opportunities in accounts by analyzing performance data. Kratu uses a push model to surface issues for account managers to address, rather than managers manually reviewing all accounts. The document includes a demo of Kratu analyzing a sample advertising account and ends by discussing upcoming improvements to Kratu.
The document summarizes the new features, changes, and deprecations in version 201402 of the Google AdWords API. Key updates include support for shopping campaigns and new ad extensions in the API, new report types, and a new bidding strategy. ClientLogin authentication has been deprecated and replaced with OAuth2.0. Several campaign features have also moved out of beta testing.
La herramienta AwReporting permite descargar informes de AdWords de forma automatizada y almacenarlos en una base de datos local. Esto reduce la curva de aprendizaje para trabajar con la API de AdWords y proporciona un punto de partida para la automatización y optimización de campañas. La herramienta es de código abierto y puede extenderse fácilmente para crear informes personalizados y integrarse con otros sistemas.
The document discusses using Google's API and services to optimize AdWords campaigns. It covers using the TargetingIdeaService to generate keyword ideas and get statistics on existing keywords. It also discusses using the TrafficEstimatorService to estimate traffic and costs for new campaigns. Finally, it discusses how to optimize existing campaigns by analyzing report data and replacing underperforming keywords.
The document discusses optimizing OAuth 2.0 requests when using the Google AdWords API. It recommends sharing access tokens across threads and servers to minimize requests. Handling access token expiration is key, including proactively refreshing tokens before expiration. A shared storage like a cache can store credentials to avoid duplicate requests. A token management server can further centralize OAuth handling. Security best practices like securely storing refresh and access tokens are also covered.
The presentation provided an overview of Google AdWords feeds including what's new, location feeds, reporting, and best practices. Key updates included feed name uniqueness, new call extension metrics, and three new feed types for apps, reviews, and locations based on Google Places data. Location feeds are associated with a Places account and have attributes and items managed automatically. Reporting on feed item performance is available, and best practices include using built-in versus custom feeds and the proper order for deleting feed components.
This document discusses various options for targeting online advertising campaigns through Google, including targeting by location, location demographics, mobile criteria, and dynamic search ads. It provides examples of how to target specific locations, location groups combining places of interest and income levels, mobile devices and apps, and automatically generate ads based on website content. Resources for each targeting method are also listed.
This document discusses tools and services for optimizing Google Ads accounts, including Kratu for discovering optimization opportunities. It describes profiling accounts, using services like Targeting Idea and Traffic Estimator for keyword research and estimates, and optimizing through an iterative process. The document demonstrates Kratu for analyzing account data and displaying issues and opportunities, and provides resources for using Kratu with a backend like AwReporting.
The document discusses a tool called AW Reports to DB that downloads AdWords report data via the API and persists it to a local SQL or MongoDB database. It provides an overview of the tool's components like report definitions, entity persisters, and the main class that coordinates the download. The tool is open source and designed to be customizable. It can help reduce API adoption time, provide a starting point for automation, and allow users to build custom reports and integrate the data into their own systems.
El documento proporciona una introducción a AdWords Scripts, que permite automatizar AdWords mediante el uso de JavaScript. Explica cómo acceder a la información de la cuenta de AdWords, los principales casos de uso, requisitos y capacidades de los scripts como acceder a entidades, informes y actualizaciones. También cubre la demostración de cómo crear el primer script para obtener campañas y obtener ayuda a través de la documentación y foros.
The document discusses AdWords scripts for managing multiple AdWords accounts from a central MCC account using JavaScript. It provides an overview of MCC scripts, how to get started with them, and examples of common tasks like accessing child accounts, selecting a specific account, processing accounts in parallel, and returning results.
Getting started with Google Analytics and the AdWords APImarcwan
Google Analytics is a platform that allows companies to measure user acquisition, behavior, and conversions on their websites. It provides insights into how to improve marketing initiatives and the user experience. The Google Analytics platform includes APIs and SDKs that allow developers to integrate analytics data into their applications. Google Analytics data can be linked with Google AdWords to help optimize advertising campaigns and prove the value of various marketing services by measuring user engagement and conversions after clicks from ads.
Getting Started with AdWords API and Google Analyticsmarcwan
Google Analytics is a platform that allows businesses to measure user interactions across devices to gain insights and optimize performance. It offers various analysis tools and APIs that developers can use to build applications that integrate with Google Analytics. The Google Analytics developer program provides benefits like quota increases and promotional opportunities to help developers build successful analytics integrations and applications.
This document discusses Google Shopping and Merchant Center. It provides an overview of how to set up and manage Shopping campaigns, including uploading product data through feeds or the Content API, using product dimensions for bidding and filtering, and creating product partitions to organize product inventory. The presenter provides code examples in Java for common tasks like setting up a Shopping campaign, defining product dimensions, and applying filters.
El documento presenta buenas prácticas y estrategias para manejar los límites de frecuencia (rate limits) de la API de AdWords. Se recomienda agrupar operaciones en pocas solicitudes y actualizar solo los campos necesarios. También se discuten tres enfoques para manejar rate limits usando colas de mensajes, incluyendo una sola cola, colas con selectores y múltiples colas.
Este documento presenta una introducción a OAuth 2.0 y cómo obtener tokens de acceso para acceder a los servicios de AdWords API. Explica los pasos para crear una ID de cliente y secreto de cliente, obtener un token de acceso mediante la aprobación del propietario de la cuenta, y luego acceder a los servicios de AdWords API con ese token. También describe los diferentes flujos de OAuth 2.0 y los recursos disponibles para obtener más información.
End to-end how to build a platform (Spanish)marcwan
El documento describe un enfoque paso a paso para que las empresas asociadas desarrollen una plataforma para administrar campañas de AdWords de clientes utilizando la API de AdWords. Se proponen tres fases tecnológicas principales: generación de informes, creación y administración de cuentas, y optimización automatizada. Cada fase agrega más funcionalidad y permite administrar más cuentas por gerente de cuenta a medida que la plataforma se vuelve más sofisticada.
El documento resume las últimas actualizaciones de la API de AdWords, incluyendo nuevas funcionalidades como la importación de conversiones fuera de línea, cambios en los nombres obligatorios de campañas y grupos de anuncios, y cinco funcionalidades que ya no están en beta como los modificadores de ofertas de criterios de visualización y anuncios de búsqueda dinámica. También proporciona ejemplos de código para utilizar estas nuevas características a través de la API.
El documento presenta una capacitación sobre cómo mejorar las páginas móviles y las conversiones a través de la API de AdWords. Cubre temas como la creación de anuncios y ajuste de precios para dispositivos móviles, los 8 fundamentos esenciales de una página móvil efectiva, y herramientas útiles como HTML5 Rocks, depuración remota y emulación móvil.
O documento discute boas práticas e rate limits na AdWords API. Ele explica que executar operações em batch e agrupar operações por entidade melhora o desempenho. Também descreve o que são rate limits e como tratá-los, incluindo usar filas de mensagens para distribuir carga e controlar a velocidade de requisições.
O documento discute o protocolo OAuth 2.0 para autenticação na API do AdWords. Ele explica que o OAuth 2.0 fornece autorização segura e padronizada para a API sem usar nomes de usuário e senhas. O documento também discute como preparar uma aplicação, obter tokens de acesso, fluxos OAuth 2.0, melhores práticas e recursos.
The document discusses optimizing landing pages for mobile devices. It covers displaying mobile ads in the AdWords API, 8 tips for mobile landing pages including prioritizing speed and visible content, and mobile development tools like HTML5 Rocks. The tips are to deliver faster content, ensure good performance, provide full content on all devices, adapt designs for different screens, focus on the user experience, include accessibility, code for robustness, and prioritize above-the-fold content.
1) O documento discute as etapas para construir uma plataforma de vendas usando a API do AdWords de forma incremental e passo-a-passo; 2) A primeira fase envolve relatórios e automação básica para aumentar o número de contas gerenciadas; 3) A segunda fase automatiza tarefas como criação de contas através de uma taxonomia e ferramenta de vendas.
O documento apresenta uma ferramenta chamada AW Reports to DB, que permite fazer download automático de relatórios do AdWords API e armazená-los em bancos de dados. A ferramenta usa a API para fazer downloads noturnos de dados, persiste localmente em bancos de dados como MySQL e MongoDB, e expõe os dados em objetos Java para que desenvolvedores possam acessá-los e criar aplicações.
O documento resume as principais atualizações da API do AdWords, incluindo novas funcionalidades como importação de conversões offline, relatórios aprimorados e mudanças no compartilhamento de orçamento. Além disso, cinco funcionalidades saíram do beta test, como modificadores de lances por critérios de exibição e anúncios de pesquisa dinâmica.
O documento apresenta os AdWords Scripts, ferramenta que permite automatizar tarefas na conta AdWords por meio de códigos JavaScript. É possível acessar dados e objetos da conta e executar ações como criar relatórios, disparar alertas e integrar com feeds externos. O documento também demonstra como criar e executar scripts na IDE do AdWords.
The document discusses reporting concepts and tips for the AdWords API. It provides an overview of reporting features, explains how to interpret single versus multi-attribution reports, and how to include or exclude zero impressions in reports. The document also outlines useful report types for different data needs and provides code examples for retrieving structural account data and building basic reporting functionality.
This document discusses various options for targeting online advertising campaigns through Google, including targeting by location, location demographics, mobile criteria, and dynamic search ads. It provides examples of how to target specific locations, location groups combining places of interest and income levels, mobile devices and apps, and automatically generate ads based on website content. Resources for each targeting method are also listed.
This document discusses tools and services for optimizing Google Ads accounts, including Kratu for discovering optimization opportunities. It describes profiling accounts, using services like Targeting Idea and Traffic Estimator for keyword research and estimates, and optimizing through an iterative process. The document demonstrates Kratu for analyzing account data and displaying issues and opportunities, and provides resources for using Kratu with a backend like AwReporting.
The document discusses a tool called AW Reports to DB that downloads AdWords report data via the API and persists it to a local SQL or MongoDB database. It provides an overview of the tool's components like report definitions, entity persisters, and the main class that coordinates the download. The tool is open source and designed to be customizable. It can help reduce API adoption time, provide a starting point for automation, and allow users to build custom reports and integrate the data into their own systems.
El documento proporciona una introducción a AdWords Scripts, que permite automatizar AdWords mediante el uso de JavaScript. Explica cómo acceder a la información de la cuenta de AdWords, los principales casos de uso, requisitos y capacidades de los scripts como acceder a entidades, informes y actualizaciones. También cubre la demostración de cómo crear el primer script para obtener campañas y obtener ayuda a través de la documentación y foros.
The document discusses AdWords scripts for managing multiple AdWords accounts from a central MCC account using JavaScript. It provides an overview of MCC scripts, how to get started with them, and examples of common tasks like accessing child accounts, selecting a specific account, processing accounts in parallel, and returning results.
Getting started with Google Analytics and the AdWords APImarcwan
Google Analytics is a platform that allows companies to measure user acquisition, behavior, and conversions on their websites. It provides insights into how to improve marketing initiatives and the user experience. The Google Analytics platform includes APIs and SDKs that allow developers to integrate analytics data into their applications. Google Analytics data can be linked with Google AdWords to help optimize advertising campaigns and prove the value of various marketing services by measuring user engagement and conversions after clicks from ads.
Getting Started with AdWords API and Google Analyticsmarcwan
Google Analytics is a platform that allows businesses to measure user interactions across devices to gain insights and optimize performance. It offers various analysis tools and APIs that developers can use to build applications that integrate with Google Analytics. The Google Analytics developer program provides benefits like quota increases and promotional opportunities to help developers build successful analytics integrations and applications.
This document discusses Google Shopping and Merchant Center. It provides an overview of how to set up and manage Shopping campaigns, including uploading product data through feeds or the Content API, using product dimensions for bidding and filtering, and creating product partitions to organize product inventory. The presenter provides code examples in Java for common tasks like setting up a Shopping campaign, defining product dimensions, and applying filters.
El documento presenta buenas prácticas y estrategias para manejar los límites de frecuencia (rate limits) de la API de AdWords. Se recomienda agrupar operaciones en pocas solicitudes y actualizar solo los campos necesarios. También se discuten tres enfoques para manejar rate limits usando colas de mensajes, incluyendo una sola cola, colas con selectores y múltiples colas.
Este documento presenta una introducción a OAuth 2.0 y cómo obtener tokens de acceso para acceder a los servicios de AdWords API. Explica los pasos para crear una ID de cliente y secreto de cliente, obtener un token de acceso mediante la aprobación del propietario de la cuenta, y luego acceder a los servicios de AdWords API con ese token. También describe los diferentes flujos de OAuth 2.0 y los recursos disponibles para obtener más información.
End to-end how to build a platform (Spanish)marcwan
El documento describe un enfoque paso a paso para que las empresas asociadas desarrollen una plataforma para administrar campañas de AdWords de clientes utilizando la API de AdWords. Se proponen tres fases tecnológicas principales: generación de informes, creación y administración de cuentas, y optimización automatizada. Cada fase agrega más funcionalidad y permite administrar más cuentas por gerente de cuenta a medida que la plataforma se vuelve más sofisticada.
El documento resume las últimas actualizaciones de la API de AdWords, incluyendo nuevas funcionalidades como la importación de conversiones fuera de línea, cambios en los nombres obligatorios de campañas y grupos de anuncios, y cinco funcionalidades que ya no están en beta como los modificadores de ofertas de criterios de visualización y anuncios de búsqueda dinámica. También proporciona ejemplos de código para utilizar estas nuevas características a través de la API.
El documento presenta una capacitación sobre cómo mejorar las páginas móviles y las conversiones a través de la API de AdWords. Cubre temas como la creación de anuncios y ajuste de precios para dispositivos móviles, los 8 fundamentos esenciales de una página móvil efectiva, y herramientas útiles como HTML5 Rocks, depuración remota y emulación móvil.
O documento discute boas práticas e rate limits na AdWords API. Ele explica que executar operações em batch e agrupar operações por entidade melhora o desempenho. Também descreve o que são rate limits e como tratá-los, incluindo usar filas de mensagens para distribuir carga e controlar a velocidade de requisições.
O documento discute o protocolo OAuth 2.0 para autenticação na API do AdWords. Ele explica que o OAuth 2.0 fornece autorização segura e padronizada para a API sem usar nomes de usuário e senhas. O documento também discute como preparar uma aplicação, obter tokens de acesso, fluxos OAuth 2.0, melhores práticas e recursos.
The document discusses optimizing landing pages for mobile devices. It covers displaying mobile ads in the AdWords API, 8 tips for mobile landing pages including prioritizing speed and visible content, and mobile development tools like HTML5 Rocks. The tips are to deliver faster content, ensure good performance, provide full content on all devices, adapt designs for different screens, focus on the user experience, include accessibility, code for robustness, and prioritize above-the-fold content.
1) O documento discute as etapas para construir uma plataforma de vendas usando a API do AdWords de forma incremental e passo-a-passo; 2) A primeira fase envolve relatórios e automação básica para aumentar o número de contas gerenciadas; 3) A segunda fase automatiza tarefas como criação de contas através de uma taxonomia e ferramenta de vendas.
O documento apresenta uma ferramenta chamada AW Reports to DB, que permite fazer download automático de relatórios do AdWords API e armazená-los em bancos de dados. A ferramenta usa a API para fazer downloads noturnos de dados, persiste localmente em bancos de dados como MySQL e MongoDB, e expõe os dados em objetos Java para que desenvolvedores possam acessá-los e criar aplicações.
O documento resume as principais atualizações da API do AdWords, incluindo novas funcionalidades como importação de conversões offline, relatórios aprimorados e mudanças no compartilhamento de orçamento. Além disso, cinco funcionalidades saíram do beta test, como modificadores de lances por critérios de exibição e anúncios de pesquisa dinâmica.
O documento apresenta os AdWords Scripts, ferramenta que permite automatizar tarefas na conta AdWords por meio de códigos JavaScript. É possível acessar dados e objetos da conta e executar ações como criar relatórios, disparar alertas e integrar com feeds externos. O documento também demonstra como criar e executar scripts na IDE do AdWords.
The document discusses reporting concepts and tips for the AdWords API. It provides an overview of reporting features, explains how to interpret single versus multi-attribution reports, and how to include or exclude zero impressions in reports. The document also outlines useful report types for different data needs and provides code examples for retrieving structural account data and building basic reporting functionality.
1. New & Improved
MCC Services
Managing thousands of accounts the
automated way!
Google Confidential and Proprietary
2. Agenda
1. Motivation
○ The need for a new service
2. Introducing new API service methods
○ What do they do?
3. The lifecycle of a managed account
○ Using the new functionality
○ Common use-case code samples
4. Mind your budgets
○ Possible account level budget implications
5. Q & A
Google Confidential and Proprietary
4. Motivation
● Until now, developers have not been able to manipulate account
structures programmatically.
● The manual intervention required to link, unlink or reorganize
accounts within an MCC can prevent the full automation of some
business processes.
○ For example, onboarding a customer account.
Google Confidential and Proprietary
5. Common use-cases
● Reorganising accounts according to business needs
● API / platform efficiency improvements: Maintaining an "inactive
accounts" MCC
● Taking control of (onboarding) an existing client account
● Day-to-day management of complex MCC structures
● Relinquishing control of an account no longer managed by a
platform
Google Confidential and Proprietary
7. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
Account 0
Account 1
Account 2
Account 3
Google Confidential and Proprietary
8. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation
Account 0
Invite extended
to Account 1
Account 1
Invite extended
to Account 2
Account 2
Invite extended
to Account 3
Account 3
Google Confidential and Proprietary
9. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation
● Rescind an invitation Account 0
Account 1
Account 2
Rescind invitation
to Account 3
Account 3
Google Confidential and Proprietary
10. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation
● Rescind an invitation Account 0
Account 1
● Accept an invitation (client account accepts invite
only action) Account 1
Account 2
Account 3
Google Confidential and Proprietary
11. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation
● Rescind an invitation Account 0
● Accept an invitation (client account
only action) Account 1
Account 2
● Reject an invitation (client account rejects invite
only action)
Account 2
Account 3
Google Confidential and Proprietary
12. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation
● Rescind an invitation Account 0
● Accept an invitation (client account MCC terminates
Account 1 link
only action) Account 1
● Reject an invitation (client account
only action)
Account 2
● Terminate the link between an
MCC and client account
Account 3
Google Confidential and Proprietary
13. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateLink:
Performs various actions required to add or remove accounts to / from
an MCC
MutateLink actions: MCC
● Extend an invitation Account 0
terminates link
● Rescind an invitation Account 0
● Accept an invitation (client account
only action) Account 1
● Reject an invitation (client account
only action)
Account 2
● Terminate the link between an
MCC and client account
Account 3
Google Confidential and Proprietary
14. ManagedCustomerService: Three new methods
ManagedCustomerService.getPendingInvitations:
Retrieves pending invitations.
● Can be invoked by either the manager (MCC) or the client.
● Once an invitation has been accepted, declined or rescinded, it will no
longer be in a pending state.
● Pending invitations are available via the ManagedCustomerService.
getPendingInvitations method.
● Accepted links will be available via the ManagedCustomerService.get
method.
● Declined, Rescinded and Terminated links will not be available through
the ManagedCustomerService at all.
Google Confidential and Proprietary
15. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateManager:
Enables you to move accounts between MCCs within your account
structure
● Move a client account to or from any MCC within your structure
● Both MCCs (to and from) must be managed by the effective user
● MCCs cannot currently be moved using this method
● To move an MCC: Terminate its link to the parent MCC and
establish a new link using the mutateLink method.
Google Confidential and Proprietary
16. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateManager:
MCC 0
MCC 1 MCC 2
Account 0 Account 1 Account 2
● Account 1 is moved from 'MCC 1' to 'MCC 2'
● This action can only be completed by 'MCC 0'
Google Confidential and Proprietary
17. ManagedCustomerService: Three new methods
ManagedCustomerService.mutateManager:
MCC 0
MCCs can be
nested upto 5
levels deep
MCC 1 MCC 2
Account 0 Account 1 Account 2
Google Confidential and Proprietary
18. The lifecycle of a
managed account
Google Confidential and Proprietary
19. Java code sample
1. MCC extends a link invitation to a client account.
2. [Optional] Retrieve the invitation.
3. The client account accepts the invitation.
4. [Optional] The client is moved to another MCC within the structure.
5. The MCC terminates its link to the client account.
Google Confidential and Proprietary
20. Java code sample
MCC extends a link invitation to a client account
// Get the ManagedCustomerService (for top level MCC).
ManagedCustomerServiceInterface managedCustomerService =
adWordsServices.get(mccSession,
ManagedCustomerServiceInterface.class);
// Create a 'pending' link between sub MCC 0 and client account.
ManagedCustomerLink inviteLink = new ManagedCustomerLink();
inviteLink.setClientCustomerId(CLIENT_ACCOUNT_CID);
inviteLink.setLinkStatus(LinkStatus.PENDING);
inviteLink.setManagerCustomerId(SUB_MCC0_CID);
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
21. Java code sample
MCC extends a link invitation to a client account
(continued)
// Send invitation to client account.
LinkOperation inviteLinkOp = new LinkOperation();
inviteLinkOp.setOperand(inviteLink);
inviteLinkOp.setOperator(Operator.ADD);
managedCustomerService.mutateLink(
new LinkOperation[]{inviteLinkOp});
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
22. Java code sample
MCC extends a link invitation to a client account:
MutateLinkResponse
<ns2:mutateLinkResponse
xmlns="https://adwords.google.com/api/adwords/cm/v201302" xmlns:ns2="
https://adwords.google.com/api/adwords/mcm/v201302">
<ns2:rval>
<ns2:links>
<ns2:managerCustomerId>SUB_MCC0_CID</ns2:managerCustomerId>
<ns2:clientCustomerId>CLIENT_ACCOUNT_CID</ns2:clientCustomerId>
<ns2:linkStatus>PENDING</ns2:linkStatus>
</ns2:links>
</ns2:rval>
</ns2:mutateLinkResponse>
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
23. Java code sample
Retrieve the invitation
// Set session customer ID to sub MCC 0.
mccSession.setClientCustomerId("SUB_MCC0_CID");
// Retrieve all pending invites.
// This can also be performed by the client account.
PendingInvitationSelector selector =
new PendingInvitationSelector();
PendingInvitation[] invitations =
managedCustomerService.getPendingInvitations(selector);
Google Confidential and Proprietary
24. Java code sample
Retrieve the invitation:
getPendingInvitationsResponse
<ns2:getPendingInvitationsResponse xmlns="https://adwords.google.
com/api/adwords/cm/v201302" xmlns:ns2="https://adwords.google.
com/api/adwords/mcm/v201302">
<ns2:rval>
<ns2:manager>
<ns2:name>SUB MCC 0</ns2:name>
<ns2:login>submcc0@company.com</ns2:login>
<ns2:companyName>Google Inc</ns2:companyName>
<ns2:customerId>SUB_MCC_0_CID</ns2:customerId>
<ns2:canManageClients>true</ns2:canManageClients>
<ns2:testAccount>false</ns2:testAccount>
</ns2:manager>
....
Google Confidential and Proprietary
26. Java code sample
The client account accepts the invitation
// Get the ManagedCustomerService (for client account).
managedCustomerService =
adWordsServices.get(clientAccountSession,
ManagedCustomerServiceInterface.class);
// Create an 'active' link between sub MCC 0 and client account.
ManagedCustomerLink activeLink = new ManagedCustomerLink();
activeLink.setClientCustomerId(CLIENT_ACCOUNT_CID);
// Set LinkStatus.REFUSED to decline the invite.
activeLink.setLinkStatus(LinkStatus.ACTIVE);
activeLink.setManagerCustomerId(SUB_MCC0_CID);
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
27. Java code sample
The client account accepts the invitation
(continued)
// Accept the invitation.
LinkOperation acceptInviteLinkOp = new LinkOperation();
acceptInviteLinkOp.setOperand(activeLink);
acceptInviteLinkOp.setOperator(Operator.SET);
managedCustomerService.mutateLink(
new LinkOperation[]{acceptInviteLinkOp});
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
28. Java code sample
The client is moved to sub MCC 1
// The top MCC is the only MCC in this structure that manages
// both sub MCCs.
mccSession.setClientCustomerId("TOP_MCC_CID");
managedCustomerService = adWordsServices.get(mccSession,
ManagedCustomerServiceInterface.class);
// The MoveAccountLink.
ManagedCustomerLink moveAccountLink = new ManagedCustomerLink();
CLIENT_ACCOUNT_CID);
moveAccountLink.setClientCustomerId(
moveAccountLink.setLinkStatus(LinkStatus.ACTIVE);
moveAccountLink.setManagerCustomerId(SUB_MCC1_CID);
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
29. Java code sample
The client is moved to sub MCC 1 (continued)
MoveOperation moveAccountOp = new MoveOperation();
moveAccountOp.setOldManagerCustomerId(SUB_MCC0_CID);
moveAccountOp.setOperator(Operator.SET);
moveAccountOp.setOperand(moveAccountLink);
managedCustomerService.mutateManager(
new MoveOperation[]{moveAccountOp});
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
30. Java code sample
The client is moved to sub MCC 1:
mutateManagerResponse
<ns2:mutateManagerResponse xmlns="https://adwords.google.
com/api/adwords/cm/v201302" xmlns:ns2="https://adwords.google.
com/api/adwords/mcm/v201302">
<ns2:rval>
<ns2:links>
<ns2:managerCustomerId>SUB_MCC1_CID</ns2:managerCustomerId>
<ns2:clientCustomerId>CLIENT_ACCOUNT_CID</ns2:clientCustomerId>
<ns2:linkStatus>ACTIVE</ns2:linkStatus>
</ns2:links>
</ns2:rval>
</ns2:mutateManagerResponse>
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
31. Java code sample
The MCC terminates its link to the client account
// Link can be terminated by either the client or the manager.
ManagedCustomerLink linkToTerminate = new ManagedCustomerLink();
CLIENT_ACCOUNT_CID);
linkToTerminate.setClientCustomerId(
linkToTerminate.setLinkStatus(LinkStatus.INACTIVE);
linkToTerminate.setManagerCustomerId(SUB_MCC1_CID);
Top MCC
sub MCC 0 sub MCC 1
Client
Account
Google Confidential and Proprietary
33. Account Level Budgets
'Managed Defined Order' (MDO) users beware: Breaking the link
between an account and the MDO on which its account budget relies,
will end the budget
MCC 0
MCC 1 MCC 2
MDO
MDO - Budget
Budget linked
link broken
to MDO
Account 1
Budget
BudgetBudget
Active Ended
Google Confidential and Proprietary