Criação de links de referência curtos

Utilize links curtos para transformar Links Singulares longos e cheios de parâmetros em links mais curtos e mais seguros que são convenientes para partilha.

Normalmente, pretende criar ligações curtas de forma dinâmica para que os utilizadores da sua aplicação possam partilhá-las com amigos para os convidar a utilizar a aplicação.

Para criar um link curto, você precisa de:

• Um link singular que leva ao download do seu aplicativo (consulte as Perguntas frequentes sobre links singulares).
• Quaisquer parâmetros que queira adicionar ao link dinamicamente (consulte Parâmetros de link de rastreamento para obter a lista de opções).
• O nome e a ID do usuário de referência, se você quiser rastrear as novas instalações do aplicativo até o usuário que compartilhou o link.

Para habilitar links curtos, primeiro adicione este código ao construtor do personagem principal:

if (AUnrealTestAppCharacter::singularDelegates == NULL) {
    AUnrealTestAppCharacter::singularDelegates =
      CreateDefaultSubobject<USingularDelegates>(TEXT("SingularShortLinksHandler"));
      singularDelegates->OnSingularShortLinksResolved.AddDynamic(this, &AUnrealTestAppCharacter::SingularShortLinksResolved);
  }
      
  void AUnrealTestAppCharacter::SingularShortLinksResolved(const FSingularShortLinkParams& linkParams) {
    const FString shortLinkURL = linkParams.SingularShortLinksParams["data"];
    const FString errorMessage = linkParams.SingularShortLinksParams["error"];
  // Add your share logic here

  // If there is an error, add logic to retry/abort/modify the params passed 

  // to the function, based on the cause of the error

  }

Em seguida, use o método CreateReferrerShortLink para criar um link curto, como no exemplo abaixo.

// Add parameters to the link (if they don't already exist in the long link URL)

  TMap<FString, FString> params;
  params.Add(TEXT("channel"), TEXT("sms"));
  params.Add(TEXT("anotherparam"), TEXT("paramvalue"));
  
  // Create the short link based on the original Singular Link URL 

// with a referrer name, referrer ID, and optional additional parameters

  USingularSDKBPLibrary::CreateReferrerShortLink(
      "https://sample.sng.link/B4tbm/v8fp?_dl=https%3A%2F%2Fabc.com",
      "referrer name",
      "referrer ID", 
      params
  );

Acompanhamento de desinstalações

Rastreamento de desinstalação do Android

Para ativar o rastreamento de desinstalação para seu aplicativo Android, primeiro configure o aplicativo na plataforma Singular conforme detalhado em Configurando o rastreamento de desinstalação. Em seguida, siga as instruções abaixo.

Como ativar o rastreamento de desinstalação usando o Firebase Cloud Messaging (FCM)

1. Integrar com o FCM:

Para rastrear desinstalações, você pode usar os serviços da plataforma Firebase Cloud Messaging (FCM). Se ainda não estiver usando o FCM, siga as instruções do Google sobre como Configurar um aplicativo cliente do Firebase Cloud Messaging no Android.

2. Atualizar o arquivo AndroidManifest.xml:

Actualize o seu ficheiro AndroidManifest.xml para adicionar o filtro de intenção necessário para a sua aplicação (substitua MyFirebaseMessagingService pela sua classe que implementa o Serviço Firebase):

<service android:name=".java.MyFirebaseMessagingService"
android:exported="false">
<intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter> </service>
  <service
      android:name=".java.MyFirebaseMessagingService"
      android:exported="false">
      intent-filter> 
          action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter> 
  </service>

3. Registar e enviar o FCM Device Token:

Por fim, defina o token de dispositivo FCM depois que o SingularConfig for inicializado em OnCreate(), da seguinte forma:

Singular.setFCMDeviceToken(String fcmDeviceToken);

Rastreamento de desinstalação do iOS

O rastreamento de desinstalação no iOS é baseado na tecnologia de notificação por push da Apple. Se o seu aplicativo não suporta atualmente notificações push, consulte o guia da Apple. Se a sua aplicação já suporta notificações push, tudo o que precisa de fazer é passar o token de dispositivo devolvido pelo APNS utilizando o método RegisterDeviceTokenForUninstall, depois de o SDK ser inicializado.

public static void SetUninstallToken(FString token)

// pass the token as a hex-string

  USingularSDKBPLibrary::SetUninstallToken("ba85ab31a7c7
f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

Conformidade com as leis de privacidade de dados

A Singular fornece a funcionalidade de proteção da privacidade para o ajudar a cooperar com quaisquer parceiros que possam estar em conformidade com as leis de privacidade do consumidor, como o GDPR e o CCPA(California Consumer Privacy Act). Estes parceiros querem ser notificados se o utilizador final consentiu em partilhar as suas informações privadas.

Limitar a partilha de dados

Se você implementou uma maneira de pedir o consentimento dos usuários para compartilhar suas informações, use o método limitDataSharing para notificar a Singular sobre a escolha do usuário:

• Utilize limitDataSharing:NO para indicar que o utilizador consentiu (optou por aceitar) a partilha das suas informações.
• Utilize limitDataSharing:YES se o utilizador não deu o seu consentimento.

A Singular utiliza o LimitDataSharing em"Postbacks de privacidade do utilizador", bem como a transmissão destas informações a parceiros que as exigem para cumprir os regulamentos relevantes. Consulte"Privacidade do utilizador e Limitar partilha de dados" para obter mais informações.

// user has opted in to share data

  USingularSDKBPLibrary::LimitDataSharing(false);

Métodos adicionais para conformidade com o GDPR

O Singular SDK fornece vários métodos para ajudá-lo a cumprir as políticas do GDPR e permitir que o Singular saiba sobre o consentimento ou não consentimento do usuário para rastreamento.

USingularSDKBPLibrary::TrackingOptIn();

USingularSDKBPLibrary::StopAllTracking();

USingularSDKBPLibrary::ResumeAllTracking();

USingularSDKBPLibrary::IsAllTrackingStopped();