Consents and Preferences fältgrupp

Consents and Preferences är en standardfältgrupp för XDM Individual Profile class som samlar in information om samtycke och preferenser för en enskild kund.

NOTE
Eftersom fältgruppen bara är kompatibel med XDM Individual Profilekan den inte användas för XDM ExperienceEvent scheman. Om du vill inkludera samtycke och inställningsdata i Experience Event-schemat lägger du till Consent for Privacy, Personalization and Marketing Preferences datatyp till schemat med hjälp av en anpassad fältgrupp i stället.

Fältgruppstruktur structure

The Consents and Preferences fältgruppen innehåller ett enda fält av objekttyp, consents, för att få information om samtycke och preferenser. Det här fältet utökar Consent for Privacy, Personalization and Marketing Preferences datatyp, tar bort adID fält och lägga till ett idSpecific kartfält.

TIP
Se guiden på utforska XDM-resurser om du vill ha steg om hur du söker upp en XDM-resurs och inspekterar dess struktur i plattformens användargränssnitt.

I följande JSON visas ett exempel på den datatyp som Consents and Preferences fältgruppen kan bearbeta. Information om hur du använder de flesta fält som finns i fältgruppen finns i handboken på Datatypen Innehåll och inställningar. Underavsnitten nedan fokuserar på de unika attribut som fältgruppen lägger till i datatypen.

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}
TIP
Du kan generera JSON-exempeldata för alla XDM-scheman som du definierar i Experience Platform för att visualisera hur kundens samtycke och inställningsdata ska mappas. Mer information finns i följande dokumentation:

idSpecific

idSpecific kan användas när ett visst samtycke eller en viss preferens inte gäller för en kund, utan är begränsad till en enda enhet eller ett enda ID. En kund kan till exempel välja att inte ta emot e-post till en adress, samtidigt som e-post kan tillåtas på en annan adress.

IMPORTANT
Samtycken och preferenser på kanalnivå (dvs. de som anges i consents utanför idSpecific) gäller för alla ID:n i den kanalen. Därför påverkar allt innehåll och alla inställningar på kanalnivå direkt om motsvarande ID- eller enhetsspecifika inställningar uppfylls:
  • Om kunden har valt att inte göra det på kanalnivå, finns motsvarande samtycke eller inställningar i idSpecific ignoreras.
  • Om samtycke eller inställning på kanalnivå inte har angetts, eller om kunden har valt att göra det, kommer motsvarande samtycke eller inställningar i idSpecific är stolta.

Varje tangent i idSpecific -objektet representerar ett specifikt ID-namnområde som känns igen av Adobe Experience Platform Identity Service. Du kan definiera egna namnutrymmen för att kategorisera olika identifierare, men vi rekommenderar att du använder ett av de standardnamnutrymmen som ingår i identitetstjänsten för att minska lagringsstorlekarna för kundprofilen i realtid. Mer information om namnutrymmen för identiteter finns i Översikt över namnutrymmet identity i identitetstjänstens dokumentation.

Nycklarna för varje namnområdesobjekt representerar de unika identitetsvärden som kunden har angett inställningar för. Varje identitetsvärde kan innehålla en komplett uppsättning innehåll och inställningar, formaterade på samma sätt som consents.

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Inom marketing objekt som anges i idSpecific -avsnittet, any och preferred fält stöds inte. Dessa fält kan bara konfigureras på användarnivå. Dessutom är idSpecific marknadsföringsinställningar för email, smsoch push stöder inte subscriptions fält.

Det finns också ett samtycke som bara kan ges i idSpecific avsnitt: adID. Detta fält beskrivs i underavsnittet nedan.

adID

The adID samtycke representerar kundens samtycke för om ett annonser-ID (IDFA eller GAID) kan användas för att länka kunden mellan appar på den här enheten. Det här värdet kan bara konfigureras under ECID identity namespace in the idSpecific och kan inte anges för andra namnutrymmen eller på användarnivå för den här fältgruppen.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
Du förväntas inte ange det här värdet direkt eftersom Adobe Experience Platform Mobile SDK automatiskt anger det när det är lämpligt.

Inmatning av data med fältgruppen ingest

För att kunna använda Consents and Preferences fältgrupp för att kunna importera medgivandedata från dina kunder, måste du skapa en datauppsättning baserad på ett schema som innehåller den fältgruppen.

Se självstudiekursen om skapa ett schema i användargränssnittet för steg om hur du tilldelar fältgrupper till fält. När du har skapat ett schema som innehåller ett fält med Consents and Preferences fältgrupp, se avsnittet om skapa en datauppsättning i användarhandboken för datauppsättningen följer du stegen för att skapa en datauppsättning med ett befintligt schema.

IMPORTANT
Om du vill skicka medgivandedata till Real-Time Customer Profilemåste du skapa en Profile-aktiverat schema baserat på XDM Individual Profile klassen som innehåller Consents and Preferences fältgrupp. Den datauppsättning som du skapar baserat på det schemat måste också aktiveras för Profile. Se självstudiekurserna som är länkade ovan för specifika steg som rör Real-Time Customer Profile krav för scheman och datauppsättningar.
Dessutom måste du se till att dina sammanfogningsprinciper är konfigurerade för att prioritera de datauppsättningar som innehåller de senaste samtycke- och inställningsdata, så att kundprofilerna uppdateras korrekt. Se översikten på sammanfogningsprinciper för mer information.

Hantera samtycke och ändringar av inställningar

När en kund ändrar sitt samtycke eller sina inställningar på webbplatsen bör dessa ändringar samlas in och tillämpas omedelbart med hjälp av Adobe Experience Platform Web SDK. Om en kund väljer bort från datainsamlingen måste all datainsamling omedelbart upphöra. Om en kund väljer bort personalisering bör det inte finnas någon personalisering på nästa sida de besöker.

Nästa steg

Detta dokument innehöll strukturen och användningen av Consents and Preferences fältgrupp. Mer information om de andra fälten som finns i fältgruppen finns i dokumentet på Consent for Privacy, Personalization and Marketing Preferences datatyp.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07