반드시 알아야 할 사항

기술 요구 사항

• Adobe Campaign API는 서버 간 에만 사용해야 합니다.
• 구현하려는 사용 사례가 Adobe Campaign API에서 허용하는 규모에 맞게 조정된 경우 항상 Adobe 기술 담당자에게 문의하십시오.
• AdobeIO 액세스를 설정하려면 특정 권한이 필요합니다. 문제가 발생하면 Adobe 지원 센터에 문의하십시오.

권한 및 액세스

• 기본적으로 Adobe Campaign API는 관리자 컨텍스트를 사용하므로 조직 단위 및 역할은 적용되지 않습니다.
• Adobe Campaign API는 역할 컨텍스트에서 제외됩니다.
• 조직 단위 또는 역할로 API를 구성하려면 먼저 기술 Adobe 담당자에게 문의하십시오.

리소스 표시

모든 API 리소스는 JSON URL 확장이나 HTTP Accept 헤더 내에서 다음을 수행합니다.

GET /profileAndServices/<resourceName>.json

요청 샘플

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile.json \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

기본 키 및 URL

• 직접 URL을 만들지 마십시오. 모든 URL은 API에서 반환됩니다. 그러나 최상위 리소스 이름을 기반으로 URL을 작성할 수 있습니다.

• 예를 보여 주는 자동 기본 키(PKey) 값은 다른 특정 배포에서 작동하지 않습니다. Adobe Campaign API에서 생성합니다.

• Adobe Campaign에서 생성한 자동 기본 키 값은 외부 데이터베이스 또는 웹 사이트에 저장해서는 안 됩니다. 데이터베이스 정의에 특정 키 필드를 생성하여 개발 중에 사용해야 합니다.

사용자 지정 키

프로필 리소스가 사용자 지정 키 필드로 확장된 경우 Adobe Campaign에서 생성된 자동 기본 키 대신 이 필드를 키로 사용할 수 있습니다.

GET /.../profileAndServicesExt/profile/<customKey>

키 값이 원본 키와 다르거나 Adobe에서 제공한 키 대신 고유한 비즈니스 키를 URI로 사용하는 경우에는 PATCH 작업을 사용하여 사용자 지정 키를 수정할 수 없습니다.

에 사용자 지정 키 사용 최상위 프로필 리소스 전용. URL은 API에서 반환되며, 직접 빌드해서는 안 됩니다.

샘플 요청

사용자 지정 키를 사용하여 프로필에 대한 구독을 검색하려면 사용자 지정 키에 대해 GET 작업을 수행하십시오.

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/<customKey> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

반환된 구독 URL에 대해 GET 요청을 수행합니다.

-X GET <SUBSCRIPTION_URL> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

프로필에 대한 구독 목록을 반환합니다.

"service": {
"PKey": "<PKEY>",
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>",
"label": "Sport Newsletter",
"name": "SVC1",
"title": "Sport Newsletter (SVC1)"
}