Documento
Criação de links de referência curtos
Nota: Esta funcionalidade está disponível na versão 11.0.8+ do SDK.
Utilize o método createReferrerShortLink para gerar uma ligação de partilha abreviada para o utilizador partilhar a aplicação com amigos. Defina os detalhes do utilizador de referência no código da sua aplicação quando a ligação for criada. Isto permite acompanhar as atribuições do referenciador nos relatórios.
Para criar um link curto:
- Crie um link de origem personalizado singular com links profundos definidos, que leva ao download do aplicativo (consulte as Perguntas frequentes sobre links singulares). Este link será referido como um link de base no código abaixo.
- Quaisquer parâmetros de substituição de campanha para 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, a fim de rastrear novas instalações de aplicativos até o usuário que compartilhou o link.
Use o método createReferrerShortLink para gerar o link curto como no exemplo abaixo.
| método createReferrerShortLink |
| Descrição |
Utilize o método createReferrerShortLink para gerar uma ligação de partilha abreviada para o utilizador partilhar a aplicação com amigos. |
| Assinatura |
(void)createReferrerShortLink:(NSString *)baseLink referrerName:(NSString *)referrerName referrerId:(NSString *)referrerId passthroughParams:(NSDictionary *)passthroughParams completionHandler:(void(^)(NSString *, NSError *))completionHandler; |
| Exemplo de utilização |
// 1. Define variables for the referrer short link
// Define your Singular tracking link to be used as a base link:
let referrerBaseLink = "https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3";
// Add your Referrer ID and Name
let referrerID = referrerIDField.text;
let referrerName = referrerNameField.text;
// Customize any Passthrough Parameters
let passthroughParams = ["channel": "sms"]
// 2. Call ReferrerShortLink to get your shortlink to share on social media
Singular.createReferrerShortLink(referrerBaseLink,
referrerName: referrerName,
referrerId: referrerID,
passthroughParams: passthroughParams,
completionHandler: {(shortLink, error) in
if error != nil {
// Logic to retry/abort/modify the params passed to the function,
// based on the cause of the error
}
if (shortLink != nil || shortLink != "") {
// Add your share logic here:
//...
}
})
// 1. Define variables for the referrer short link
// Define your Singular tracking link to be used as a base link.
// Include any override parameters in the string as query string parameters.
NSString* referrerBaseLink = @"https://yourdomain.sng.link/Csfge/aknl?_dl=myscheme%3A%2F%2Fmydeeplink/referrer&_smtype=3";
// Add your Referrer ID and Name
NSString* referrerID = self.referrerIDField.text;
NSString* referrerName = self.referrerNameField.text;
// Customize any Passthrough Parameters
NSDictionary* passthroughParams = @{@"channel": @"sms"};
// 2. Call the ReferrerShortLink Method to get the shortlink to share on social media
[Singular createReferrerShortLink:referrerBaseLink
referrerName:referrerName
referrerId:referrerID
passthroughParams:passthroughParams
completionHandler:^(NSString *shortLink, NSError *error) {
if (error) {
// Logic to retry/abort/modify the params passed to the function,
// based on the cause of the error
}
if (shortLink) {
// Add your share logic here:
//...
}
}
];
|
