Consents and Preferences veldgroep

Consents and Preferences is een standaardgebiedsgroep voor de XDM Individual Profile klassedie toestemming en voorkeurinformatie voor een individuele klant vangt.

NOTE
Aangezien deze veldgroep alleen compatibel is met XDM Individual Profile , kan deze niet worden gebruikt voor XDM ExperienceEvent -schema's. Als u toestemmings en voorkeursgegevens in uw schema van de Gebeurtenis van de Ervaring wilt omvatten, voeg het Consent for Privacy, Personalization and Marketing Preferences gegevenstypeaan het schema door het gebruik van de groep van het a douanegebiedin plaats daarvan toe.

Groepsstructuur van veld structure

De veldgroep Consents and Preferences biedt één objecttype veld, consents , waarin toestemmings- en voorkeursgegevens worden vastgelegd. Dit veld is een uitbreiding van het Consent for Privacy, Personalization and Marketing Preferences gegevenstype, waarbij het veld adID wordt verwijderd en een kaartveld idSpecific wordt toegevoegd.

TIP
Zie de gids op het onderzoeken van middelen XDMaan voor stappen op hoe te om het even welk middel XDM op te zoeken en zijn structuur in Platform UI te inspecteren.

In het volgende JSON-voorbeeld ziet u het type gegevens dat de veldgroep Consents and Preferences kan verwerken. Voor informatie over hoe te om de meeste gebieden te gebruiken die door de gebiedsgroep worden verstrekt, verwijs naar de gids op het gegevenstype van de Inhoud en van de Voorkeur. De subsecties hieronder richten zich op de unieke attributen die de gebiedsgroep aan het gegevenstype toevoegt.

{
  "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
U kunt steekproefJSON gegevens voor om het even welk XDM schema produceren dat u in Experience Platform bepaalt helpen visualiseren hoe uw klantentoestemming en voorkeursgegevens zouden moeten in kaart worden gebracht. Raadpleeg de volgende documentatie voor meer informatie:

idSpecific

idSpecific kan worden gebruikt wanneer een bepaalde toestemming of voorkeur niet universeel op een klant van toepassing is, maar tot één apparaat of identiteitskaart beperkt is. Zo kan een klant ervoor kiezen geen e-mails naar het ene adres te ontvangen, terwijl e-mails naar een ander adres mogelijk worden toegestaan.

IMPORTANT
De toestemmingen en voorkeuren op kanaalniveau (dat wil zeggen de onder consents buiten idSpecific opgegeven waarden) zijn van toepassing op alle id's in dat kanaal. Alle toestemming en voorkeuren op kanaalniveau worden daarom rechtstreeks toegepast, ongeacht of de equivalente id- of apparaatspecifieke instellingen worden gerespecteerd:
  • Als de klant heeft opgegeven dat de toepassing is uitgeschakeld op het kanaalniveau, worden gelijkwaardige toestemmingen of voorkeuren in idSpecific genegeerd.
  • Als de toestemming of voorkeur op kanaalniveau niet is ingesteld of als de klant zich heeft aangemeld, worden de equivalente toestemmingen of voorkeuren in idSpecific gerespecteerd.

Elke sleutel in het idSpecific -object vertegenwoordigt een specifieke naamruimte die wordt herkend door de Adobe Experience Platform Identity Service. Hoewel u uw eigen aangepaste naamruimten kunt definiëren om verschillende id's te categoriseren, wordt u aangeraden een van de standaardnaamruimten van Identity Service te gebruiken om opslaggrootten voor Real-Time Klantprofiel te reduceren. Voor meer informatie over identiteit namespaces, zie het overzicht van identiteitskaart namespacein de documentatie van de Dienst van de Identiteit.

De sleutels voor elk namespacevoorwerp vertegenwoordigen de unieke identiteitswaarden waarvoor de klant voorkeur heeft geplaatst. Elke identiteitswaarde kan een volledige reeks toestemmingen en voorkeur bevatten, die op de zelfde manier zoals consents wordt geformatteerd.

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

De velden any en preferred worden niet ondersteund binnen marketing -objecten die worden aangeboden in de sectie idSpecific . Deze velden kunnen alleen op gebruikersniveau worden geconfigureerd. Daarnaast bieden de idSpecific marketingvoorkeuren voor email , sms en push geen ondersteuning voor subscriptions -velden.

Er is ook een toestemming die alleen kan worden opgegeven in de sectie idSpecific : adID . Dit veld wordt behandeld in de onderafdeling hieronder.

adID

De adID toestemming geeft de toestemming van de klant weer om te bepalen of een adverteerder-id (IDFA of GAID) kan worden gebruikt om de klant te koppelen tussen apps op dit apparaat. Deze waarde kan alleen worden geconfigureerd onder de naamruimte ECID in de sectie idSpecific en kan niet worden ingesteld voor andere naamruimten of op gebruikersniveau voor deze veldgroep.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
Deze waarde wordt niet rechtstreeks ingesteld, aangezien de Adobe Experience Platform Mobile SDK deze waarde automatisch instelt wanneer dit van toepassing is.

Gegevens invoegen met de veldgroep ingest

Als u de veldgroep Consents and Preferences wilt gebruiken om toestemmingsgegevens van uw klanten in te voeren, moet u een dataset tot stand brengen die op een schema wordt gebaseerd dat die gebiedsgroep bevat.

Zie het leerprogramma op creërend een schema in UIvoor stappen op hoe te om gebiedsgroepen aan gebieden toe te wijzen. Zodra u een schema hebt gecreeerd dat een gebied met de Consents and Preferences gebiedsgroep bevat, verwijs naar de sectie op creërend een datasetin de gids van de datasetgebruiker, na de stappen om een dataset met een bestaand schema tot stand te brengen.

IMPORTANT
Als u toestemmingsgegevens naar Real-Time Customer Profile wilt verzenden, is het vereist dat u een Profile -ingeschakeld schema maakt op basis van de XDM Individual Profile -klasse die de Consents and Preferences -veldgroep bevat. De dataset die u creeert die op dat schema wordt gebaseerd moet ook voor Profile worden toegelaten. Raadpleeg de zelfstudies die hierboven zijn gekoppeld voor specifieke stappen met betrekking tot Real-Time Customer Profile -vereisten voor schema's en gegevenssets.
Bovendien moet u ook ervoor zorgen dat uw samenvoegingsbeleid wordt gevormd om aan de dataset(s) voorrang te geven die de recentste toestemmings en voorkeursgegevens bevatten, opdat de klantenprofielen correct worden bijgewerkt. Zie het overzicht op fusiebeleidvoor meer informatie.

Verwerking van toestemmings- en preferenties

Wanneer een klant hun toestemmingen of voorkeur op uw website verandert, zouden deze veranderingen moeten worden verzameld en onmiddellijk worden afgedwongen gebruikend Adobe Experience Platform Web SDK. Als een klant ervoor kiest geen gegevens meer te verzamelen, moet de gegevensverzameling onmiddellijk worden beëindigd. Als een klant ervoor kiest geen personalisatie meer te gebruiken, dan is er geen personalisatie aanwezig op de volgende pagina die zij bezoeken.

Volgende stappen

Dit document behandelt de structuur en het gebruik van de veldgroep Consents and Preferences . Zie het document over het Consent for Privacy, Personalization and Marketing Preferences gegevenstypevoor meer informatie over de andere velden die door de veldgroep worden verschaft.

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