同意和偏好設定欄位群組

同意和偏好設定是XDM Individual Profile 類別的標準欄位群組,可擷取個別客戶的同意和偏好設定資訊。

NOTE
由於此欄位群組僅與XDM Individual Profile相容,因此無法用於XDM ExperienceEvent結構描述。 如果您想要在體驗事件結構描述中包含同意和偏好設定資料,請改用自訂欄位群組,將隱私權同意、Personalization和行銷偏好設定資料型別新增到結構描述。

欄位群組結構 structure

同意和偏好設定欄位群組提供單一物件型別欄位consents,以擷取同意和偏好設定資訊。 此欄位延伸隱私權、Personalization和行銷偏好設定的同意資料型別,移除adID欄位並新增idSpecific對應欄位。

TIP
如需如何在Platform UI中查詢任何XDM資源及檢查其結構的步驟,請參閱探索XDM資源的指南。

下列JSON顯示同意和偏好設定欄位群組可以處理的資料型別範例。 如需有關如何使用欄位群組所提供之大部分欄位的資訊,請參閱同意和偏好設定資料型別的指南。 以下子區段著重於欄位群組新增至資料型別的獨特屬性。

{
  "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
您可以為您在Experience Platform中定義的任何XDM結構描述產生範例JSON資料,以協助視覺化客戶同意和偏好設定資料應如何對應。 如需詳細資訊,請參閱下列檔案:

idSpecific

當特定同意或偏好設定不普遍適用於客戶,但僅限於單一裝置或ID時,可以使用idSpecific。 例如,客戶可以選擇不接收某個地址的電子郵件,而可能允許另一個地址的電子郵件。

IMPORTANT
管道層級的同意和偏好設定(亦即idSpecific以外的consents底下提供的同意和偏好設定)套用至該管道內的所有ID。 因此,無論遵循對等的ID或裝置特定設定,所有管道層級同意和偏好設定都會直接生效:
  • 如果客戶已在頻道層級選擇退出,則會忽略idSpecific中的任何對等同意或偏好設定。
  • 如果未設定管道層級的同意或偏好設定,或客戶已選擇加入,則會接受idSpecific中相等的同意或偏好設定。

idSpecific物件中的每個索引鍵代表Adobe Experience Platform Identity服務可辨識的特定身分名稱空間。 雖然您可以定義自己的自訂名稱空間來分類不同的識別碼,但建議您使用Identity Service提供的標準名稱空間之一,來減少即時客戶個人檔案的儲存大小。 如需識別名稱空間的詳細資訊,請參閱Identity Service檔案中的識別名稱空間概觀

每個名稱空間物件的索引鍵代表客戶已設定偏好設定的唯一身分值。 每個身分值都可以包含一組完整的同意和偏好設定,格式與consents相同。

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

idSpecific區段中提供的marketing物件中,anypreferred欄位不受支援。 這些欄位只能在使用者層級設定。 此外,emailsmspushidSpecific行銷偏好設定不支援subscriptions欄位。

也有一個同意只能在idSpecific區段中提供: adID。 以下小節將介紹此欄位。

adID

adID同意代表客戶同意是否可以使用廣告商ID (IDFA或GAID)在此裝置上跨應用程式連結客戶。 此值只能在idSpecific區段中的ECID身分名稱空間下設定,並且不能為其他名稱空間或此欄位群組的使用者層級設定。

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
您不應直接設定此值,因為Adobe Experience Platform Mobile SDK會在適當時自動進行設定。

使用欄位群組擷取資料 ingest

若要使用同意和偏好設定欄位群組來擷取客戶的同意資料,您必須根據包含該欄位群組的結構描述建立資料集。

如需如何將欄位群組指派給欄位的步驟,請參閱有關在UI中建立結構描述的教學課程。 建立包含具有同意和偏好設定欄位群組的欄位的結構描述後,請參閱資料集使用指南中有關建立資料集的章節,然後依照步驟使用現有結構描述建立資料集。

IMPORTANT
若要將同意資料傳送至Real-Time Customer Profile,您必須根據包含同意和偏好設定欄位群組的XDM Individual Profile類別,建立啟用Profile的結構描述。 您根據該結構描述建立的資料集也必須為Profile啟用。 請參閱上述連結的教學課程,以瞭解結構描述和資料集Real-Time Customer Profile需求的相關特定步驟。
此外,您也必須確保合併原則已設定為優先處理包含最新同意和偏好設定資料的資料集,以便客戶設定檔能夠正確更新。 如需詳細資訊,請參閱合併原則的概觀。

處理同意和偏好設定變更

當客戶在您的網站上變更其同意或偏好設定時,應使用Adobe Experience Platform Web SDK收集這些變更並立即強制執行。 如果客戶選擇退出資料收集,所有資料收集必須立即停止。 如果客戶選擇退出個人化,則他們造訪的下一個頁面上應該不會出現個人化。

後續步驟

此檔案涵蓋同意和偏好設定欄位群組的結構和使用。 如需欄位群組所提供其他欄位的詳細資訊,請參閱隱私權同意、Personalization和行銷偏好設定資料型別的檔案。

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