Como começar

Confira neste guia as etapas necessárias para configurar, desenvolver e lançar um novo feed da plataforma Coisas legais para fazer.

Configuração inicial

Para criar contas e endpoints SFTP, o Google exige que você forneça chaves SSH para usar como credenciais de upload. Depois disso, o Google vai criar dois endpoints SFTP (um para desenvolvimento e outro para produção) e uma conta da Central de Coisas legais para fazer para você.

Gerar um par de chaves Secure Shell (SSH) para a caixa de depósito SFTP

Siga as instruções em Gerar um par de chaves Secure Shell para uma caixa de depósito SFTP a fim de gerar um par de chaves SSH públicas e privadas. Esse par de chaves é usado para fazer login com segurança nas caixas de depósito SFTP fornecidas pelo Google. A chave pública tem o seguinte formato:

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCXsM9ycbHV6E6t2L+B4p/uYHn9Q0jmu5gUXMYnFnnf4l39xrznfDo8KCASzRrqUkRnuzrno059CvZVzcljkbwWLzKKoE1EwbzHL3nYahMB4MdYNWhBbHbB+ybq6RNO7hkoKDBIQCfqQDY0FEB6sV3d3F1WYl0bAMjp15yyZJzMKa/rRnZKWetHlcL1X+gFWmW2hQ93foPD463gb58/25GujjsS/tzjngw7UJMVkm08U1QEY3z3DE/R++7ovJozTCzH0CTNDN0AH3/oSC3dmG+yDh3ZXFATjWjyPXJSOziNrp9TXgJhlqSmoHcPvpotMVjx21kIZ+T+SusQmnG+hK+L user@yourdomain.com

Não inclua novas quebras de linha na chave.

Depois que as chaves forem criadas, envie-as para o representante do Google quando dois feeds serão criados em seu nome.

Acesso à central de Coisas legais para fazer

A Central de Coisas legais para fazer é um portal de parceiros que permite visualizar e gerenciar seu feed de Coisas legais para fazer. Nessa página, é possível configurar as credenciais do feed, visualizar os problemas encontrados no feed e conferir as estatísticas de referência mais recentes de cada produto.

O acesso será fornecido a você depois que a configuração inicial for concluída pelo Google. Como parte da integração inicial, o Google entrará em contato com você e solicitará uma lista de usuários que serão proprietários da Central de Coisas legais para fazer. Cada usuário dessa lista receberá acesso e terá permissões de proprietário. Eles podem conceder acesso à Central de Coisas legais para fazer e adicionar outros proprietários.

Desenvolvimento e teste

Depois que a conta e os endpoints forem criados, seu representante do Google vai entrar em contato com você com detalhes de acesso do endpoint e da Central de Coisas legais para fazer. Depois de desenvolver o feed, você pode fazer upload para o endpoint de desenvolvimento a qualquer momento e verificar os resultados do processamento na Central de Coisas legais para fazer.

Fazendo upload do feed

Depois de receber os detalhes do feed, faça o upload do feed criado diretamente para o endpoint abaixo:

SFTP URL: partnerupload.google.com.
SFTP Port: 19321
Username: username provided by Google

A chave privada correspondente à chave pública gerada na etapa anterior será necessária para a autenticação. Consulte Conectar-se à sua caixa de depósito SFTP para ver um exemplo detalhado de como fazer isso.

Como testar e validar feeds

A validação e o processamento automáticos do feed ocorrem após o upload do feed. Acesse a central de Coisas legais para fazer para conferir o histórico de uploads, o status e as mensagens de erro. Durante o desenvolvimento e o teste, é possível fazer upload livremente para o endpoint de feed do partnerdev para acionar a validação.

Após a conclusão do desenvolvimento, os parceiros podem começar a fazer upload de feeds para o endpoint de produção regularmente. Após o upload dos primeiros feeds, entre em contato com seu representante do Google para acionar o processo de lançamento.

Lançamento para produção

Antes de ativar o feed para produção, a equipe do Google fará uma última rodada de controle de qualidade no feed de produção enviado. Qualquer feedback do controle de qualidade será fornecido diretamente à sua equipe. Assim que todos os problemas pendentes forem resolvidos, a equipe do Google vai lançar seu feed ativando-o no back-end.

Integração dos anúncios da seção "Coisas legais para fazer"

Depois que a integração do feed for concluída, entre em contato com ttd-ads-support@google.com com uma lista de contas do Google Ads que podem ter acesso ao conteúdo do feed para iniciar a integração.