Configuração das regras de tag para oferecer suporte a casos de uso do Adobe Campaign Standard

Última atualização em 2023-12-29
  • Criado para:
  • Experienced
    Admin

Na interface da Coleção de dados, crie elementos de dados e regras para enviar PII e outros dados de aplicativos móveis para o Adobe Campaign Standard.

Para garantir que todas as alterações de configuração na interface da Coleção de dados tenham efeito, publique essas alterações. Para obter mais informações, consulte Publicação.

Para criar regras na interface da Coleção de dados, siga estas etapas:

  1. Criação de elementos de dados
  2. Criação de regras para casos de uso que você deseja suportar:

Criação de elementos de dados

Estes são os elementos de dados que recomendamos criar na interface da Coleção de dados.
Você pode criar elementos de dados adicionais de acordo com suas necessidades.

  • Experience Cloud ID
  • Pkey
  • Campaign server

Para criar esses elementos de dados:

  1. Na interface da Coleção de dados, no painel do aplicativo móvel, clique na Data Elements guia.

  2. Para criar o Experience Cloud ID elemento de dados, clique em Create New Data Element.

  3. No Name por exemplo, digite em mcid.

  4. No Extension selecione Mobile Core. Depois Experience Cloud ID no Data element menu suspenso de tipo.

  5. Para criar o elemento de dados Pkey, clique em Add data element.

  6. No Name por exemplo, digite em pkey.

  7. No Extension selecione Adobe Campaign Standard. Depois pkey no Data element menu suspenso de tipo.

  8. Para criar o elemento de dados do servidor do Campaign, clique em Add data element.

  9. No Name digite um nome, por exemplo, camp-server.

  10. No Extension selecione Adobe Campaign Standard. Em seguida, Campaign Server no Data element menu suspenso de tipo.

Criação de regras

Você deve criar regras para o seguinte:

Postback de PII

OBSERVAÇÃO

Para enviar informações de PII de um aplicativo móvel para o Adobe Campaign, é necessário implementar uma API do SDK. Para obter mais informações, acesse CollectPII.

Para enviar dados de PII para o Adobe Campaign Standard, crie uma regra na interface da Coleção de dados:

  1. Na interface da Coleção de dados, no painel do aplicativo móvel, clique na Rules depois guia Create New Rule.

  2. Digite um nome, por exemplo, Mobile Core - Coletar PII.

  3. No Events clique em Add.

  4. No Extension selecione Mobile Core. Em seguida, Collect PII no Event type menu suspenso.

  5. Clique em Keep changes.

  6. No Actions clique em Add.

  7. No Extension selecione Mobile Core. Em seguida, Send PII no Action type menu suspenso.

  8. Entrada URL, insira o seguinte URL:

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
    
  9. Selecione o Add Post Body caixa de seleção

  10. Entrada Post Body, digite o seguinte:

    {
    "marketingCloudId":
    "{%%mcid%%}",
    "pushPlatform":
    "{%contextdata.pushPlatform%}",
    "cusEmail":
    "{%contextdata.email%}",
    "cusFirstName":
    "{%contextdata.firstName%}",
    "cusLastName":
    "{%contextdata.lastName%}" }
    

    A marketingCloudId permite reconciliar os assinantes de aplicativo com os recipients no banco de dados e, como resultado, é necessária. Você pode especificar outros pares de valor-chave de acordo com suas necessidades comerciais. No exemplo acima, Email, Nome e Sobrenome estão sendo transmitidos do aplicativo.

    As chaves (por exemplo cusEmail, cusFirstName e cusLastName) devem corresponder às IDs de campo definidas no recurso personalizado na instância do Adobe Campaign Standard. As variáveis de valor (por exemplo, email, firstName e LastName) devem corresponder às chaves nos dados JSON enviados pelo aplicativo móvel ao chamar a API collectPII do AMS a partir do código do aplicativo.

    Você também pode enviar dados do ciclo de vida no postback Coletar PII ou em um postback diferente, dependendo dos acionadores do Evento. este é um exemplo do JSON de dados do ciclo de vida:

    {
    "marketingCloudId":"{%%mcid%%}",
    "pushPlatform":"{%contextdata.pushPlatform%}",
    "cusDayslastlaunch": "{%%DaysSinceLastUse%%}",
    "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}",
    "cusLaunches": "{%%Launches%%}"
    }
    

    Os elementos de dados definidos na interface da Coleção de dados devem ser colocados em porcentagens duplas, por exemplo %%mcid%%As variáveis de contexto e do aplicativo devem ser colocadas em porcentagens únicas, por exemplo %contextdata.email%.

  11. Entrada Content Type, tipo application/json.

  12. Entrada Timeout, selecione 0.

Os dados do usuário agora estão configurados para serem enviados ao Campaign.

Postback de rastreamento no aplicativo

OBSERVAÇÃO

Se você estiver usando o Android ACPCore v1.4.0 ou posterior/ iOS ACPCore v2.3.0 ou posterior, não é necessário configurar o rastreamento de postbacks.

Para enviar dados de rastreamento ao Adobe Campaign Standard para criar relatórios sobre como os usuários interagem com mensagens no aplicativo móvel, crie a seguinte regra na interface da Coleção de dados:

  1. Na interface da Coleção de dados, no painel do aplicativo móvel, selecione a variável Rules e clique em Add Rule.

  2. Digite um nome, por exemplo, Adobe Campaign - Rastreamento de cliques no aplicativo.

  3. No Events clique em Add.

  4. No Extension selecione Adobe Campaign Standard. Em seguida, In-App click tracking no Event type menu suspenso.

  5. Clique em Keep changes.

  6. No Actions clique em Add.

  7. No Extension selecione Mobile Core. Em seguida, Send postback no Event type menu suspenso.

  8. Entrada URL, digite o seguinte URL:

    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
    
  9. Selecione o Add post body caixa de seleção

  10. Entrada Post Body, tipo {}.

  11. Entrada Content Type, tipo application/json.

  12. Entrada Timeout, selecione 0.

Postback de rastreamento de notificações por push

OBSERVAÇÃO

Se você estiver usando o Android ACPCore v1.4.0 ou posterior/ iOS ACPCore v2.3.0 ou posterior, não é necessário configurar o rastreamento de postbacks.

Para enviar dados de rastreamento ao Adobe Campaign Standard, que ajuda a rastrear os deliveries de notificação por push e a interação dos usuários com o aplicativo móvel, é necessário criar uma regra na interface da Coleção de dados.

Para obter mais informações sobre o rastreamento de push, consulte Rastreamento por push.

Para rastrear as ações do aplicativo, use a API trackAction. Para obter mais informações, consulte Rastrear ações do aplicativo.

  1. Na interface da Coleção de dados, no painel do aplicativo móvel, clique na Rules e clique em Add Rule.

  2. Digite um nome, por exemplo, Adobe Campaign - rastreamento de cliques por push.

  3. No Events clique em Add.

  4. No Extension selecione Mobile Core. Em seguida, Track Action no Event type menu suspenso.

  5. No Action selecione Action, selecione equals, e digite rastreamento.

  6. Clique em Keep changes. Em seguida, no Actions clique em Add.

  7. No Extension selecione Mobile Core. Em seguida, Send postback no Action type menu suspenso.

  8. Entrada URL, insira o seguinte URL:

    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}
    
  9. Selecione o Add post body caixa de seleção

  10. Adicione o corpo da publicação, por exemplo, { }.

  11. Entrada Content Type, tipo application/json.

  12. Entrada Timeout, selecione 0.

Postback de localização

  1. Na interface da Coleção de dados, no painel do aplicativo móvel, clique na Rules e clique em Add Rule.

  2. Digite um nome, por exemplo, Postback de localização.

  3. No Events clique em Add.

  4. Crie um evento, por exemplo, Enter POI ou Exit POI. No Extension selecione Places - Beta. Em seguida, Inserir POI ou POI de saída no Event type menu suspenso.

  5. Insira um nome, por exemplo, Places - Beta - Inserir POI ou POI de saída.

  6. No Actions clique em Add.

  7. No Extension selecione Mobile Core. Em seguida, Send postback do Action type menu suspenso.

  8. Insira um nome, por exemplo, Mobile Core - Enviar postback de localização.

  9. Entrada URL, insira o seguinte URL:

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
    
  10. Selecione o Add post body e adicione o corpo da publicação, por exemplo:

    {
    "locationData": {
        "distances": "{%%Distance%%}",
        "poiLabel": "{%%POILabel%%}",
        "latitude": "{%%Latitude%%}",
        "longitude": "{%%Longitude%%}",
        "appId": "{%%AppId%%}",
        "marketingCloudId": "{%%ECID%%}"
    }
    }
    
    OBSERVAÇÃO

    No exemplo acima, os elementos de dados no lado direito devem ser configurados na interface da Coleção de dados aproveitando as etapas em Criação de elementos de dados. Os elementos de dados no lado esquerdo são compatíveis com o Adobe Campaign Standard e não precisam de configuração. Se precisar de dados adicionais, você deverá fazer extensões de recursos personalizadas no Adobe Campaign Standard.

  11. Entrada Content Type, tipo application/json.

  12. Entrada Timeout, selecione 5.

Nesta página