마케팅 액션 엔드포인트
Adobe Experience Platform 데이터 거버넌스 컨텍스트에서 마케팅 액션은 Experience Platform 데이터 소비자가 수행하는 액션으로, 데이터 사용 정책 위반을 확인해야 합니다.
Policy Service API의 /marketingActions 끝점을 사용하여 조직의 마케팅 작업을 관리할 수 있습니다.
시작하기
이 가이드에 사용된 API 끝점은 Policy Service API의 일부입니다. 계속하기 전에 시작 안내서를 검토하여 관련 문서에 대한 링크, 이 문서의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.
마케팅 액션 목록 검색 list
/marketingActions/core 또는 /marketingActions/custom에 각각 GET 요청을 하여 핵심 또는 사용자 지정 마케팅 작업 목록을 검색할 수 있습니다.
API 형식
GET /marketingActions/core
GET /marketingActions/custom
요청
다음 요청은 조직에서 유지 관리하는 사용자 지정 마케팅 작업 목록을 검색합니다.
curl -X GET \
https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
응답이 성공하면 name 및 href을(를) 포함하여 검색된 각 마케팅 작업에 대한 세부 정보가 반환됩니다. href 값은 데이터 사용 정책을 만들 때 마케팅 작업을 식별하는 데 사용됩니다.
{
"_page": {
"count": 2
},
"_links": {
"page": {
"href": "https://platform.adobe.io/marketingActions/custom?{?limit,start,property}",
"templated": true
}
},
"children": [
{
"name": "sampleMarketingAction",
"description": "Marketing Action description.",
"imsOrg": "{ORG_ID}",
"created": 1550714012088,
"createdClient": "string",
"createdUser": "string",
"updated": 1550714012088,
"updatedClient": "string",
"updatedUser": "string",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/sampleMarketingAction"
}
}
},
{
"name": "newMarketingAction",
"description": "Another marketing action.",
"imsOrg": "{ORG_ID}",
"created": 1550793833224,
"createdClient": "string",
"createdUser": "string",
"updated": 1550793833224,
"updatedClient": "string",
"updatedUser": "string",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/newMarketingAction"
}
}
}
]
}
_page.countchildrenname특정 마케팅 액션 조회 lookup
마케팅 작업의 name 속성을 GET 요청 경로에 포함하여 특정 마케팅 작업의 세부 정보를 조회합니다.
API 형식
GET /marketingActions/core/{MARKETING_ACTION_NAME}
GET /marketingActions/custom/{MARKETING_ACTION_NAME}
{MARKETING_ACTION_NAME}name 속성입니다.요청
다음 요청은 이름이 combineData인 사용자 지정 마케팅 작업을 검색합니다.
curl -X GET \
https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
응답 개체에는 데이터 사용 정책을 정의(marketingActionsRefs)할 때 마케팅 작업을 참조하는 데 필요한 경로(_links.self.href)를 포함하여 마케팅 작업에 대한 세부 정보가 포함되어 있습니다.
{
"name": "combineData",
"description": "Combine multiple data sources together.",
"imsOrg": "{ORG_ID}",
"created": 1550793805590,
"createdClient": "string",
"createdUser": "string",
"updated": 1550793805590,
"updatedClient": "string",
"updatedUser": "string",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/combineData"
}
}
}
사용자 지정 마케팅 액션 만들기 또는 업데이트 create-update
마케팅 작업의 기존 이름 또는 의도한 이름을 PUT 요청 경로에 포함하여 새 사용자 지정 마케팅 작업을 만들거나 기존 사용자 지정 마케팅 작업을 업데이트할 수 있습니다.
API 형식
PUT /marketingActions/custom/{MARKETING_ACTION_NAME}
{MARKETING_ACTION_NAME}요청
다음 요청은 이름이 같은 마케팅 작업이 시스템에 아직 없는 경우 이름이 crossSiteTargeting인 새 마케팅 작업을 만듭니다. crossSiteTargeting 마케팅 작업이 있으면 이 호출은 대신 페이로드에 제공된 속성을 기반으로 해당 마케팅 작업을 업데이트합니다.
curl -X PUT \
https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "crossSiteTargeting",
"description": "Perform targeting on information obtained across multiple web sites."
}'
name중요: 이 속성은 경로의
{MARKETING_ACTION_NAME}과(와) 일치해야 합니다. 그렇지 않으면 HTTP 400(잘못된 요청) 오류가 발생합니다. 즉, 마케팅 액션이 만들어지면 해당 name 속성을 변경할 수 없습니다.description응답
성공적인 응답은 마케팅 액션의 세부 정보를 반환합니다. 기존 마케팅 작업이 업데이트된 경우 응답은 HTTP 상태 200(OK)을 반환합니다. 새 마케팅 작업이 생성되면 응답은 HTTP 상태 201(생성됨)을 반환합니다.
{
"name": "crossSiteTargeting",
"description": "Perform targeting on information obtained across multiple web sites.",
"imsOrg": "{ORG_ID}",
"created": 1550713341915,
"createdClient": "string",
"createdUser": "string",
"updated": 1550713856390,
"updatedClient": "string",
"updatedUser": "string",
"_links": {
"self": {
"href": "https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting"
}
}
}
사용자 지정 마케팅 액션 삭제 delete
사용자 지정 마케팅 액션의 이름을 DELETE 요청 경로에 포함하여 삭제할 수 있습니다.
API 형식
DELETE /marketingActions/custom/{MARKETING_ACTION_NAME}
{MARKETING_ACTION_NAME}요청
curl -X DELETE \
https://platform.adobe.io/data/foundation/dulepolicy/marketingActions/custom/crossSiteTargeting \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
성공한 응답은 빈 응답 본문과 함께 HTTP 상태 200(OK)을 반환합니다.
마케팅 액션을 조회하여 삭제를 확인할 수 있습니다. 마케팅 작업이 시스템에서 제거된 경우 HTTP 404(찾을 수 없음) 오류가 표시됩니다.