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 recurso substituem os tipos de relatórios. Em vez de solicitar tipos de relatórios predefinidos, agora você pode consultar todos os recursos usando uma nova linguagem de consulta semelhante ao SQL. Consulte a Estrutura da API Search Ads 360 Reporting para saber mais.
Relatórios de pesquisa
A pesquisa tem um serviço próprio na nova API. O serviço de pesquisa substitui o serviço de relatórios legado. Todas as consultas passam pelo SearchAds360Service, que oferece dois métodos, SearchStream e Search, para pesquisar e extrair 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
Extrair 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 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 diferentes entidades 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. É uma linguagem flexível, semelhante ao SQL, que permite definir consultas para extrair os dados de relatórios específicos mais adequados para sua empresa. Consulte a Linguagem de consulta do Search Ads 360 para saber mais.
Solicitações de recebimento
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 da coluna personalizada em CustomColumnService. Consulte Alterações de formato na API Search Ads 360 Reporting para saber mais.
Colunas personalizadas
No novo Search Ads 360, as colunas de fórmula e as conversões personalizadas são chamadas de colunas personalizadas. Saiba mais sobre as colunas personalizadas. O novo CustomColumnService ativa colunas personalizadas. Se você tiver as permissões necessárias, poderá solicitar recursos CustomColumn de qualquer conta na
árvore de contas.
Gerenciamento da conta
O novo Search Ads 360 organiza as contas em uma hierarquia de contas de administrador, subadministrador e cliente. Uma conta de administrador representa a conta da agência, e as contas de subadministrador representam as contas de anunciantes no Search Ads 360 anterior. Consulte Sobre as contas de administrador do Search Ads 360 para saber mais.
Você pode consultar a árvore de contas e enviar solicitações para cada conta de que gostaria de gerar dados.
Como resultado da mudança na hierarquia da conta, os campos relacionados ao conceito de anunciante/agência foram substituídos pelas alternativas adequadas para oferecer paridade funcional sempre que possível. Consulte Mapeamentos de campos para ver uma lista dos campos afetados e os substitutos deles.
Cabeçalho de ID de cliente de login
login-customer-id é um novo cabeçalho obrigatório ao usar uma conta de administrador para acessar uma conta de subadministrador ou cliente. Consulte
Cabeçalho de ID do cliente de login para
mais informações.
Controle de versões
A API Search Ads 360 Reporting usa versionamento semântico.
Há versões principais e secundárias, formatadas como
vMAJOR_MINOR. Consulte Controle de versão para saber mais.