API de negócios de evento de indicação

Sobre a API de negócios de evento de indicação

Para saber mais sobre o recurso, o corpo da solicitação e o corpo da resposta da API de negócios de Evento de indicação, consulte Eventos de indicação no Guia do desenvolvedor de marketing de indicação.

Fase 3

Durante o primeiro e segundo estágios, a promoção interage apenas com os defensores. No terceiro estágio, os defensores referenciam seus amigos. Para rastrear o encaminhamento de um defensor, execute a API com estes campos:

• eventType – Especifique o tipo de evento como Referência.
• referralCode – especifique o código do defensor que encaminhou seu amigo e o código da promoção da qual a atividade faz parte, separado por um hífen.
• activityDateTime – especifique a data e a hora em que o defensor encaminhou o amigo.
• firstName – especifique o primeiro nome do amigo indicado.
• lastName – especifique o sobrenome do amigo indicado.
• email – especifique o endereço de email do amigo encaminhado.

Se houver um contato para o amigo na organização, especifique o ID do contato do amigo, em vez do primeiro nome, sobrenome e endereço de email.

Fase 4

Depois que os defensores indicam seus amigos no terceiro estágio, os amigos indicados interagem com a marca pela primeira vez. As maneiras de engajamento podem ser diferentes conforme seus requisitos de negócios ou setor. Para rastrear um amigo indicado se engajando com a marca, execute a API com estes campos:

• eventType – especifique o tipo de evento como Inscrição.
• referralCode – especifique o código do defensor que encaminhou seu amigo e o código da promoção da qual a atividade faz parte, separado por um hífen.
• contactId – especifique o ID do registro de contato do amigo.
• activityDateTime – especifique a data e a hora em que o amigo se inscreveu.

Se não existir um contato para o amigo, especifique o primeiro nome, o sobrenome e o endereço de email do amigo, em vez do ID do contato.

Fase 5

Depois que os amigos indicados interagem com a marca pela primeira vez, eles devem concluir uma atividade. A atividade varia conforme as metas e o setor da promoção. Para rastrear a conclusão de uma atividade por um amigo indicado, execute a API com estes campos:

• eventType – especifique o tipo de evento como Compra.
• referralCode – especifique o código do defensor que encaminhou seu amigo e o código da promoção da qual a atividade faz parte, separado por um hífen.
• contactId – especifique o ID do registro de contato do amigo.
• activityDateTime – especifique a data e a hora em que o amigo concluiu sua primeira compra.

Se não existir um contato para o amigo, especifique o primeiro nome, o sobrenome e o endereço de email do amigo, em vez do ID do contato.