sfmc // CloudPagesPROJETO

Upsert em CloudPage em Vez de Insert Cego

Use uma chave estável para que refresh/retry não acrescente cegamente linhas duplicadas de estado.

cloudpagesupsertdataidempotencydata extension
Context Pack →Abrir Workspace →
Trust & provenancePROJECT
Nível de evidênciaPROJECTFontes oficiais1Outras fontes0Última verificação2026-10-05

O nível de evidência descreve minha experiência com o conteúdo. Fonte oficial descreve contrato/documentação da plataforma. Observação de produção não deve ser tratada automaticamente como limite oficial.

EvidênciaPROJETO
Dificuldadeintermediário
Verificado2026-10-05
Use quando

Uma página de preferência/ação pode ser submetida mais de uma vez.

%%[
VAR @subscriberKey, @choice
SET @subscriberKey = RequestParameter("subscriberKey")
SET @choice = RequestParameter("choice")

IF NOT Empty(@subscriberKey) AND NOT Empty(@choice) THEN
  UpsertData(
    "Preference_State",
    1,
    "SubscriberKey", @subscriberKey,
    "Choice", @choice,
    "UpdatedAt", Now()
  )
ENDIF
]%%
Por que funciona

UpsertData atualiza a linha correspondente ou insere quando não existe, tornando requests repetidos mais seguros que InsertData para estado atual.

Gotchas

Idempotência depende da chave e semântica corretas. Uma tabela de auditoria/histórico pode intencionalmente inserir novo evento.

Fontes / verificação