Conectando o Microsoft Advertising

Conecte sua conta do Microsoft ao Opus Growth.

Antes de começar

• Você precisa de uma conta do Microsoft Advertising e de um usuário Microsoft (Entra) com acesso a ela.
• O acompanhamento de conversões e o remarketing exigem uma tag UET no seu site; você a cria com create_microsoft_uet_tag e a instala.
• Se você pretende importar do Google Ads, isso é feito na interface da Microsoft; a conexão não atrapalha.

Etapas da conexão

1. Execute a ferramenta. Diga ao seu assistente connect_microsoft_ads. Ele retorna um link de autorização de uso único vinculado à sua conta; nada está conectado ainda nesta etapa.
2. Abra o link. O link é válido por uma hora. Abra-o em um navegador no qual você esteja conectado como a pessoa que tem acesso à conta do Microsoft.
3. Conceda o acesso. Aprove as permissões solicitadas na tela do Microsoft. Essa é a tela de consentimento do próprio Microsoft, então o login acontece lá, não conosco.
4. Selecione uma conta. Suas contas são listadas após a autorização. Marque as que você quer gerenciar e salve; todas as operações seguintes são executadas na conta que você escolheu.
5. Confirme. Execute list_microsoft_accounts; se suas contas forem listadas, a conexão está pronta.

Permissões solicitadas

• openid
• offline_access
• https://ads.microsoft.com/msads.manage

Nada além desta lista é solicitado, e o token é armazenado criptografado. Se você recusar qualquer permissão na tela de consentimento, o fluxo é interrompido e nenhum token é gravado.

Observações

• Quando você entra com a Microsoft (Entra), seus tokens de acesso e de atualização são armazenados criptografados; o token é atualizado automaticamente antes de expirar.
• A autorização concede acesso às contas do Microsoft Advertising que você quer gerenciar; suas contas são listadas com list_microsoft_accounts.
• Para acompanhamento de conversões e remarketing, você precisa primeiro criar uma tag UET (create_microsoft_uet_tag) e instalá-la no seu site.

Solução de problemas

Por que os números de conversão estão vazios?

Sem a tag UET instalada no seu site, nenhuma conversão é registrada no lado da Microsoft, e por isso o relatório fica vazio. Crie a tag e coloque-a no site primeiro, depois defina as metas de conversão quando os dados começarem a se acumular.

Com que frequência meu token é atualizado?

A Microsoft emite um token de atualização, então o renovamos automaticamente antes de expirar e o uso normal nunca pede que você autorize novamente. Alterar sua senha ou revogar o acesso invalida o token, e então você precisa reconectar.

Por que a tela diz que contas de anúncios exigem o plano Pro ou Agência?

Essa mensagem só aparece em contas com plano WordPress, que não inclui contas de anúncios. Ao migrar para o Pro ou Agência, a mesma ferramenta de conexão funciona sem nenhuma alteração.

Por que o link diz que a conexão é inválida ou expirou?

Um link de autorização expira uma hora após ser gerado e só pode ser usado uma vez; abrir um link que já foi usado gera o mesmo erro. Execute a ferramenta de conexão novamente e você receberá um novo link para continuar.

Selecionei várias contas, mas só uma foi salva. Por quê?

Os planos Grátis e Pro conectam uma conta de anúncios por plataforma; gerenciar várias é um recurso do plano Agência. Mesmo que você marque mais de uma na tela de seleção, apenas a primeira é mantida ao salvar. Para trabalhar como agência, é preciso fazer upgrade do plano; depois disso, você atualiza a seleção pelo seletor de contas do painel, que reutiliza o token armazenado, então você nunca precisa autorizar de novo.

Autorizei com o usuário errado. O que acontece?

O acesso armazenado se limita às contas que o usuário autorizador consegue ver; uma conta que esse usuário não alcança também não fica visível para nós. Desconecte pelo painel e conecte novamente com o usuário correto, e o token antigo será excluído.

Desconexão

Abra o painel, encontre o Microsoft em plataformas conectadas e escolha desconectar. O token armazenado é excluído imediatamente, não apenas ocultado, então não conseguimos mais acessar a conta. Reconectar depois significa executar connect_microsoft_ads novamente e passar pela autorização do zero. Desconectar não exclui nada dentro da sua conta do Microsoft.

→ lista completa de ferramentas do Microsoft