Fluxo de trabalho de Deep Linking

Configuração

Configurar um OneLink exige que duas pessoas diferentes dentro de uma organização trabalhem juntas, usando seus próprios recursos: profissional de marketing e desenvolvedor.

Função do profissional de marketing

Os profissionais de marketing planejam as campanhas de marketing e configuram as URLs do OneLink. As URLs do OneLink são configuradas para transportar parâmetros (por exemplo, deep_link_value) e dados que são usados para oferecer aos usuários uma experiência personalizada ao criar deep linking e deferred deep linking.

📘

Dica

O profissional de marketing e os desenvolvedores precisam decidir juntos sobre o melhor sistema de longo prazo para o deep_link_value (and any other parameters/values) to minimize additional app updates.

The deep_link_value can be based on a SKU, post ID, path, or anything else. We strongly recommend agreeing on a system that allows for you to enter dynamic values on your chosen parameter, so you can generate many different deep links that go to different content within the app, without any further changes to the app code by the developers.

See the following URL examples. The deep_link_value of a fruit type was chosen by the marketer and developer together. And the developers made the values dynamic, so the marketer could enter any fruit without the need for further work by the dev team.

https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=apples...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=bananas...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=peaches...

Função do desenvolvedor

Os desenvolvedores executam a configuração do OneLink no aplicativo:

• Configuração inicial
• Implementando a API UDL
• Implementando deferred deep linking

Initial setup

Configuração inicial para Android e iOS: abre o aplicativo (usando links de aplicativos Android, links universais ou esquemas de URI).

Implement Unified Deep Linking (UDL)

Implement the unified deep linking (UDL) API to retrieve data from the click and use that data to redirect users for a personalized experience to a specific in-app activity (deep linking or deferred deep linking).
This API is fast, easy to use, and supports both owned and paid media sources.

Observação: para novos usuários, o método UDL retorna apenas parâmetros relevantes para deferred deep linking: deep_link_value and deep_link_sub1-10. If you try to get any other parameters (media_source, campaign, af_sub1-5, etc.), they return null.

Implement UDL

[Recommended] Implement extended deferred deep linking

Em alguns casos, o UDL não é ativado para deferred deep linking. Por exemplo, quando:
- Um usuário clica em um link de uma rede de autorrelato (SRN), como anúncios do Meta ou Twitter.
- Um usuário clica em um link que não contém parâmetros como deep_link_value or deep_link_sub1-10.
- O período de tempo entre o clique e a instalação excede a janela de lookback do UDL de 15 minutos.
Para garantir trabalhos de deferred deep linking nesses casos, recomendamos a implementação do método onConversionDataSuccess (OCDS), que faz parte da API GCD. OCDS é geralmente usado para recuperar dados de conversão e, antes do UDL, era o método exclusivo para lidar com deferred deep linking.
Importante: ao implementar UDL e OCDS, é responsabilidade do desenvolvedor garantir que apenas um dos métodos manipule deferred deep linking.
Consulte as instruções para implementar deferred deep linking estendidos para Android e iOS.

Legacy: Use only GCD API for Deep-Linking

Os desenvolvedores que já usam o OneLink podem estar usando os métodos herdados para deep linking e deferred deep linking, em vez do UDL.
Os métodos legados usam exclusivamente a API GCD, que consiste em dois métodos: onConversionDataSuccess para deferred deep linking e onAppOpenAttribution para deep linking. Veja informações sobre os métodos legados para Android e iOS.

Recomendado: aplicativos com apenas a API GCD implementada devem implementar UDL e deferred deep linking estendido.

User invites

Permita que os usuários indiquem outras pessoas ao aplicativo com links do OneLink criando convites de usuário