DocumentaçãoCampaignDocumentação do Campaign Standard

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

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Experiente
  • Administrador

Na interface da Coleção de Dados, crie elementos de dados e regras para enviar PII e outros dados de aplicativos móveis para 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. Criando regras para casos de uso aos quais você deseja oferecer suporte:

Criação de elementos de dados create-data-elements

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 guia Data Elements.

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

  3. No campo Name, por exemplo, digite mcid.

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

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

  6. No campo Name, por exemplo, digite pkey.

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

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

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

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

Criação de regras creating-rules

Você deve criar regras para o seguinte:

Postback de PII pii-postback

NOTE
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, vá para CollectPII.

Para enviar dados de PII para 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 guia Rules e depois em Create New Rule.

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

  3. Na seção Events, clique em Add.

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

  5. Clique em Keep changes.

  6. Na seção Actions, clique em Add.

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

  8. Em URL, insira a seguinte URL:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  9. Marque a caixa de seleção Add Post Body.

  10. Em Post Body, digite o seguinte:

    code language-none 
    {
"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:

    code language-none 
    {
"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%%, e as variáveis de contexto do aplicativo devem ser colocadas em porcentagens únicas, por exemplo %contextdata.email%.

  11. Em Content Type, digite application/json.

  12. Em Timeout, selecione 0.

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

Postback de rastreamento no aplicativo inapp-tracking-postback

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

Para enviar dados de rastreamento ao Adobe Campaign Standard para relatórios sobre como os usuários interagem com mensagens no aplicativo em seu 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 guia Rules e clique em Add Rule.

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

  3. Na seção Events, clique em Add.

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

  5. Clique em Keep changes.

  6. Na seção Actions, clique em Add.

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

  8. Em URL, digite a seguinte URL:

    code language-none 
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  9. Marque a caixa de seleção Add post body.

  10. Em Post Body, digite {}.

  11. Em Content Type, digite application/json.

  12. Em Timeout, selecione 0.

Postback de rastreamento de notificações por push push-tracking-postback

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

Para enviar dados de rastreamento para o Adobe Campaign Standard, que ajuda a rastrear as entregas 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 de 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 guia Rules e em Add Rule.

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

  3. Na seção Events, clique em Add.

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

  5. Na lista suspensa Action, selecione Action, selecione equals e digite tracking.

  6. Clique em Keep changes. Na seção Actions, clique em Add.

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

  8. Em URL, insira a seguinte URL:

    code language-none 
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  9. Marque a caixa de seleção Add post body.

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

  11. Em Content Type, digite application/json.

  12. Em Timeout, selecione 0.

Postback de localização location-postback

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

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

  3. Na seção Events, clique em Add.

  4. Crie um evento, por exemplo, Enter POI ou Exit POI. No menu suspenso Extension, selecione Places - Beta. Em seguida, Insira o POI ou Saia do POI no menu suspenso Event type.

  5. Insira um nome, por exemplo, Places - Beta - Insira o POI ou Saia do POI.

  6. Na seção Actions, clique em Add.

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

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

  9. Em URL, insira a seguinte URL:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  10. Marque a caixa de seleção Add post body e adicione o corpo da publicação, por exemplo:

    code language-none 
    {
"locationData": {
    "distances": "{%%Distance%%}",
    "poiLabel": "{%%POILabel%%}",
    "latitude": "{%%Latitude%%}",
    "longitude": "{%%Longitude%%}",
    "appId": "{%%AppId%%}",
    "marketingCloudId": "{%%ECID%%}"
}
}
    note note
    NOTE
    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 você precisar de dados adicionais, deverá executar extensões de recursos personalizadas no Adobe Campaign Standard.

  11. Em Content Type, digite application/json.

  12. Em Timeout, selecione 5.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff