Show Menu
TÓPICOS×

Configuração da integração de dados do Campaign com os Pontos de interesse

Configuração da integração de dados de Pontos de Campanha de interesse com SDKs Adobe Experience Platform

Seu aplicativo móvel já deve estar configurado no Adobe Campaign Standard usando o Adobe Experience Platform SDK. For the detailed steps, refer to this page .
Os aplicativos móveis usados para coletar dados de localização devem ser configurados por um administrador na interface do Adobe Campaign.
Para poder usar os Adobe Experience Platform Location Services com aplicativos móveis configurados com o Adobe Experience Platform SDK, é necessário:
  1. Adicione as extensões Places e Places Monitor à configuração do aplicativo móvel no Adobe Experience Platform Launch. Configure seu aplicativo móvel no Adobe Campaign. Consulte Instalar a extensão de Locais no Adobe Experience Platform Launch e Instalar a extensão do Monitor de Lugares no Experience Platform Launch .
  2. Depois que suas extensões forem configuradas, crie elementos de dados dentro Adobe Experience Platform Launch para recuperar dados dessas extensões. Consulte esta página para criar seus elementos de dados.
  3. Em seguida, em Adobe Experience Platform Launch , é necessário criar regras para suportar casos de uso móvel entre Ponto de interesse e Adobe Campaign. Essa regra será acionada quando um usuário entrar em uma área delimitada geograficamente Point of Interest . Consulte esta página para criar sua regra.
  4. Defina o seu Points of Interest em Locais. Consulte Criar um ponto de interesse .
  5. Certifique-se de acessar o aplicativo móvel e os dados de localização coletados no Adobe Campaign. Consulte Acessar aplicativos móveis usados para coletar dados de localização e Acessar dados de localização coletados.

Configuração da integração de dados de Pontos de Campanha de interesse usando o SDK V4

Os aplicativos móveis usados para coletar dados de localização devem ser configurados por um administrador na interface do Adobe Campaign.
Para usar o recurso de dados Ponto de interesse com aplicativos móveis configurados com SDK V4, é necessário:
  1. Tenha acesso ao Adobe Analytics para dispositivos móveis. Verifique seu contrato de licença ou entre em contato com o executivo da sua Conta Adobe para obter mais informações.
  2. Configure seu aplicativo móvel no Adobe Campaign. Consulte Configurar um aplicativo móvel na Campaign .
  3. Configure seu aplicativo móvel na interface do Adobe Mobile Services. Isso permite garantir que os dados coletados pelo Adobe Mobile Services sejam enviados para a Adobe Campaign. Consulte Configurar um aplicativo móvel no Adobe Mobile Services .
  4. Execute a configuração específica do aplicativo móvel:
    • Compacte o arquivo de configuração baixado da interface do Adobe Mobile Services com o aplicativo móvel.
    • Integre o SDK do Experience Cloud Mobile ao seu aplicativo móvel. Consulte Integrar o SDK a um aplicativo móvel.
  5. Defina Pontos de interesse na interface do Adobe Mobile Services. Consulte Definição de pontos de interesse no Adobe Mobile Services .
  6. Defina os dados que deseja coletar dos assinantes do aplicativo móvel. Consulte Coletando dados de Pontos de interesse dos assinantes.
  7. Certifique-se de acessar o aplicativo móvel e os dados de localização coletados no Adobe Campaign. Consulte Acessar aplicativos móveis usados para coletar dados de localização e Acessar dados de localização coletados.

Configuração de um aplicativo móvel no Adobe Campaign usando o SDK V4

Para poder coletar dados de Pontos de interesse com a Adobe Campaign, é necessário configurar o aplicativo móvel do qual a Adobe Campaign receberá dados.
  1. Clique no logotipo Adobe Campaign , no canto superior esquerdo, em seguida selecione Administration > Channels > Mobile app .
  2. Clique em Create para configurar um aplicativo.
  3. Digite um nome no Application name campo e clique em Create .
    Não preencha a Device-specific settings seção. Isso se aplica somente à configuração de aplicativos que recebem notificações por push.
Na Mobile application properties seção, dois URLs são listados: Collect PII endpoint e Location Services endpoint . Eles serão usados na interface do Adobe Mobile Services. Consulte Configurar um aplicativo móvel no Adobe Mobile Services .
  • O Collect PII endpoint URL é usado para coletar as IDs de Experience Cloud dos usuários e os tokens de registro do aplicativo móvel quando ele é iniciado. Quando um usuário entra no aplicativo usando credenciais como email, nome, sobrenome etc., esses dados também são coletados e usados para reconciliar o token de registro do usuário com um perfil Adobe Campaign.
  • O Location Services endpoint URL é usado para coletar dados de localização, como latitude, longitude e raio de um usuário de um Ponto de interesse.
Agora você pode usar esses valores no Adobe Mobile Services para concluir a configuração, como explicado na seção Configuração de um aplicativo móvel na seção Adobe Mobile Services .

Configuração de um aplicativo móvel V4 no Adobe Mobile Services

Para enviar os dados coletados pelo Adobe Mobile Services para a Adobe Campaign, você deve configurar postbacks na interface do Mobile Services.
Você precisará de informações específicas que possam ser encontradas nos parâmetros do aplicativo móvel definidos no Adobe Campaign (consulte Configuração de um aplicativo móvel na Campanha ):
  • IMS Organization ID
  • Collect PII Endpoint
  • Location Services endpoint
É necessário ter acesso ao Adobe Analytics para fazer a seguinte configuração. Se você não for um usuário do Adobe Analytics, entre em contato com o administrador do Adobe Campaign.
  1. Faça logon em mobilemarketing.adobe.com .
  2. Crie o aplicativo ou selecione um existente.
  3. Go to the Manage App Settings page.
  4. Na seção Serviço de ID de Visitante, marque Ativar e selecione sua organização na lista suspensa. Clique em Save .
    Essa organização deve ser a mesma usada na instância do Adobe Campaign.
  5. Clique em Manage Postbacks .
  6. Crie um postback.
    • Selecione PII como o Postback Type .
    • No URL campo, copie o Collect PII Endpoint URL do aplicativo móvel que você configurou na interface do Adobe Campaign, precedido pelo nome do servidor. Consulte Configurar um aplicativo móvel na Campaign .
    • Preencha o Post Body campo da seguinte forma:
      Para iOS:
      {
      "userKey": "{userKey}",
      "pushPlatform":"apns",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      
      
      Para Android:
      {
      "userKey": "{userKey}",
      "pushPlatform":"gcm",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      
      
    • Defina Tipo ​de conteúdo como application/json .
    • Em Quais tags de dados acionam o postback? , selecione qualquer evento, normalmente Launched e exists .
    • Clique em Save & Activate .
  7. Crie um segundo postback.
    • Selecione Postback como o Postback Type .
    • No URL campo, copie o Location Services Endpoint URL do aplicativo móvel que você configurou na interface do Adobe Campaign, precedido pelo nome do servidor. Consulte Configurar um aplicativo móvel na Campaign .
    • Preencha o Post Body campo da seguinte forma:
      {
      "locationData":{
      "distances":"{a.loc.dist}",
      "poiLabel":"{a.loc.poi}",
      "latitude.a":"{a.loc.lat.a}",
      "latitude.b":"{a.loc.lat.b}",
      "latitude.c":"{a.loc.lat.c}",
      "longitude.a":"{a.loc.lon.a}",
      "longitude.b":"{a.loc.lon.b}",
      "longitude.c":"{a.loc.lon.c}",
      "appId":"{a.appid}",
      "marketingCloudId":"{mid}"
      }
      }
      
      
    • Defina Tipo ​de conteúdo como application/json .
    • Em Quais tags de dados acionam o postback? , selecione campaign.test e exists .
    • Clique em Save & Activate .
Para obter informações detalhadas sobre como configurar postbacks, consulte a documentação do Adobe Mobile Services.

Integrating the SDK into a mobile application

O kit de desenvolvimento de software (SDK) do Mobile Core Service facilita a integração de um aplicativo móvel ao Adobe Campaign.
Esta etapa está descrita nesta página .

Definição de pontos de interesse no Adobe Mobile Services

Para definir os Pontos de interesse usados para coletar dados de localização:
  1. Vá para a interface do Adobe Mobile Services.
  2. Adicione seu aplicativo.
    Para obter mais informações sobre como gerenciar aplicativos no Mobile Services, consulte a documentação do Adobe Mobile Services.
  3. Defina os Pontos de interesse.
    Para obter mais informações sobre como gerenciar pontos de interesse, consulte a documentação do Adobe Mobile Services.

Recolha de dados sobre os pontos de interesse dos assinantes

Um recurso personalizado específico permite que você defina os dados que deseja coletar dos assinantes de seus aplicativos.

Acessar aplicativos móveis usados para coletar dados de localização

Para acessar os aplicativos criados com êxito no Adobe Campaign:
  1. Click the Adobe Campaign logo, in the top left corner.
  2. Selecione Administration > Channels > Mobile app (SDK v4) ou Mobile app (AEP SDK) dependendo do SDK.
  3. Selecione um aplicativo móvel na lista para exibir suas propriedades.
Uma lista dos assinantes do aplicativo também é exibida na guia Mobile application subscribers . Os assinantes são todos os usuários que instalaram o aplicativo em seu dispositivo móvel. Os perfis do banco de dados Adobe Campaign são identificados com um token de registro.

Acessar dados de localização coletados

Quando a configuração estiver concluída, os dados coletados de Pontos de interesse serão listados na Places guia de cada perfil. Para acessar a lista:
  1. Selecione um perfil.
  2. Clique no Edit profile properties botão à direita.
  3. Selecione a guia Places .
Os dados de Pontos de interesse coletados para o perfil atual são listados. Os dados de localização são armazenados no banco de dados da Adobe Campaign por seis meses.
Para obter mais informações sobre como acessar e editar perfis, consulte Perfis .