마케팅 작업 끝점

Adobe Experience Platform Data Governance 컨텍스트에서 마케팅 작업은 Experience Platform 데이터 소비자가 취하는 동작이며, 데이터 사용 정책 위반을 확인해야 합니다.

정책 서비스 API에서 /marketingActions 종단점을 사용하여 조직에 대한 마케팅 작업을 관리할 수 있습니다.

시작하기

이 안내서에 사용된 API 엔드포인트는 Policy Service API의 일부입니다. 계속하기 전에 시작 안내서에서 관련 설명서에 대한 링크, 이 문서에서 샘플 API 호출을 읽는 방법에 대한 안내서 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요한 정보를 검토하십시오.

마케팅 작업 목록 검색

각각 /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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 namehref을 포함하여 검색된 각 마케팅 작업에 대한 세부 정보를 반환합니다. 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": "{IMS_ORG}",
            "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": "{IMS_ORG}",
            "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.count 반환된 총 마케팅 작업 수입니다.
children 검색된 마케팅 작업의 세부 사항을 포함하는 개체 배열입니다.
name 특정 마케팅 작업을 조회할 때 고유한 식별자 역할을 하는 마케팅 작업의 이름입니다.
_links.self.href 데이터 사용 정책을 만들 때 marketingActionsRefs 배열을 완료하는 데 사용할 수 있는 마케팅 작업에 대한 URI 참조입니다.

특정 마케팅 작업 조회

GET 요청 경로에 마케팅 작업의 name 속성을 포함하여 특정 마케팅 작업의 세부 사항을 조회합니다.

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

응답 개체에는 데이터 사용 정책(marketingActionsRefs)을 정의할 때 마케팅 작업을 참조하는 데 필요한 경로(_links.self.href)를 포함하여 마케팅 작업에 대한 세부 사항이 포함되어 있습니다.

{
    "name": "combineData",
    "description": "Combine multiple data sources together.",
    "imsOrg": "{IMS_ORG}",
    "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"
        }
    }
}

사용자 지정 마케팅 작업 만들기 또는 업데이트

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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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 요청 경로에 해당 이름을 포함하여 사용자 지정 마케팅 작업을 삭제할 수 있습니다.

노트

기존 정책에서 참조하는 마케팅 작업은 삭제할 수 없습니다. 이러한 마케팅 작업 중 하나를 삭제하려고 하면 마케팅 작업을 참조하는 모든 정책의 ID를 포함하는 메시지와 함께 HTTP 400(잘못된 요청) 오류가 발생합니다.

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 빈 응답 본문과 함께 HTTP 상태 200(OK)을 반환합니다.

마케팅 작업을 조회하여 삭제를 확인할 수 있습니다. 시스템에서 마케팅 작업을 제거한 경우 HTTP 404(찾을 수 없음) 오류가 표시됩니다.

이 페이지에서는