A API Search Ads 360 Reporting é baseada em uma plataforma moderna e apresenta vários conceitos novos. Eles são descritos nas seções a seguir.
Recursos
Os objetos de recursos substituem os tipos de relatórios. Em vez de solicitar tipos de relatórios predefinidos, agora é possível consultar todos os recursos usando uma nova linguagem de consulta semelhante a SQL. Consulte Estrutura da API Search Ads 360 Reporting para saber mais.
Relatórios de pesquisa
A pesquisa tem o próprio serviço na nova API. O serviço de pesquisa substitui o serviço de relatórios legados. Todas as consultas passam pelo
SearchAds360Service
que oferece dois métodos, SearchStream e Search, para pesquisar e
recuperar dados e métricas de relatórios. Os dois métodos de pesquisa retornam todos os objetos SearchAds360Row que correspondem à consulta de pesquisa. Consulte
Criar relatórios de pesquisa para mais informações.
Metadados do recurso
SearchAds360FieldService
permite solicitar dinamicamente o catálogo de recursos, campos de recursos,
chaves de segmentação e métricas disponíveis nos métodos de pesquisa SearchAds360Service. Consulte Recuperar metadados de recursos para saber
mais.
Nomes de campos
A API apresenta nomes de campos aninhados separados pela notação de ponto. Por exemplo, campaign.id e ad_group.id. Também é possível aninhar ainda mais, por exemplo,ad_group.campaign.id. Consulte
Estrutura da API Search Ads 360 Reporting para saber
mais.
Os relatórios na API anterior do Search Ads 360 são baseados em campos separados em entidades diferentes para conceitos semelhantes. Por exemplo, os relatórios
campaign e
adgroup incluem um campo
campaignId separado.
Linguagem da consulta
A API apresenta a linguagem de consulta do Search Ads 360. Essa é uma linguagem flexível, semelhante a SQL, que permite definir consultas para recuperar os dados de relatórios específicos mais adequados para sua empresa. Consulte Linguagem de consulta do Search Ads 360 para saber mais.
Solicitações GET
Na nova API, a pesquisa tem o próprio serviço (SearchAds360Service), mas as solicitações GET ainda existem no serviço específico de cada entidade. Por exemplo, é possível receber
informações de colunas personalizadas do
CustomColumnService.
Consulte
Mudanças de formato na API Search Ads 360 Reporting
para saber mais.
Colunas personalizadas
Na nova experiência do Search Ads 360, as colunas de fórmulas e as conversões personalizadas são chamadas colunas personalizadas.
Saiba mais sobre as colunas personalizadas.
O novo
CustomColumnService
ativa as colunas personalizadas. Desde que você tenha as permissões necessárias, é possível solicitar recursos CustomColumn pertencentes a qualquer conta na árvore de contas.
Gerenciamento da conta
O novo Search Ads 360 organiza as contas em uma hierarquia de contas de administrador, de subadministrador e de cliente. Uma conta de administrador representa a conta da agência, e as contas de subadministrador representam as contas de anunciantes do Search Ads 360 anterior. Consulte Sobre as contas de administrador do Search Ads 360 para saber mais.
É possível consultar a árvore de contas e enviar solicitações para cada conta de que você quer dados de relatórios.
Como resultado da mudança na hierarquia de contas, os campos relacionados ao conceito de anunciante/agência foram substituídos por alternativas adequadas para fornecer paridade funcional sempre que possível. Consulte Mapeamentos de campos para uma lista de campos afetados e seus substitutos.
Cabeçalho do ID de cliente de login
login-customer-id é um novo cabeçalho necessário ao usar uma conta de administrador para acessar uma conta de subadministrador ou de cliente. Consulte
Cabeçalho do ID de cliente de login
para mais informações.
Controle de versões
A API Search Ads 360 Reporting usa
o controle de versões semântico. Há versões principais e secundárias,
formatadas como vMAJOR_MINOR. Consulte
Controle de versões para saber mais.