API 호출

광고 규칙 엔진을 사용하기 위한 API 호출의 예를 참조하세요.

계정의 모든 규칙 읽기

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

규칙 읽기

curl -G   \
-d 'fields=name,evaluation_spec,execution_spec,status'   \
-d 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

규칙 업데이트

사양을 업데이트하려면 변경되지 않는 필드를 포함하여 모든 필드를 제공하세요. 노출 1,000회당 규칙 트리거를 업데이트하는 예시는 다음과 같습니다. 규칙 상태를 업데이트할 때 사양을 변경할 필요가 없습니다.

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "trigger" : {
        "type": "STATS_MILESTONE",
        "field": "impressions",
        "value": 1000,
        "operator": "EQUAL"
      },
      "filters": ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

클릭수가 200회를 넘는 모든 광고를 선택하기 위해 필터를 업데이트하는 예시는 다음과 같습니다. entity_type, time_preset 등의 다른 필터가 여전히 이 업데이트에 포함되어야 합니다.

curl \
-F 'evaluation_spec={
      "evaluation_type": ...,
      "filters" : [
       {
         "field": "clicks",
         "value": 200,
         "operator": "GREATER_THAN",
       },
       {
       ...
     ]
   }' \
-F 'access_token=<ACCESS_TOKEN>'   \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

규칙 삭제

curl -X DELETE \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>

규칙 실행 내역에 액세스

각 규칙 실행에 대해 과거 데이터에 액세스하는 엔드포인트가 있습니다. 기본적으로 이 엔드포인트는 결과, 행동 등의 관련 데이터를 제공합니다. 또한 각 실행에서 규칙 상태를 확인하여 수정 사항을 추적할 수 있습니다.

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

게다가 이 엔드포인트는 데이터에 대해 세 가지 필터링 메커니즘(object_id, action 및 hide_no_changes)을 지원합니다. object_id 또는 action으로 결과를 필터링하여 해당 object_id 또는 action 유형에 대해서만 결과를 확인할 수 있습니다.

또한 hide_no_changes 플래그를 사용하여 결과를 필터링하면 변경 사항이 없는 모든 실행을 제외할 수 있습니다. 이러한 필터를 조합하여 더욱 구체적인 결과를 얻을 수 있습니다.

curl -G   \
-d 'object_id=123' \
-d 'action=CHANGED_BID' \
-d 'hide_no_changes=true' \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/history

계정 실행 내역에 액세스

계정 내에 있는 모든 집계된 내역 데이터에 액세스할 수 있는 엔드포인트가 있습니다. 기본적으로 이 엔드포인트는 규칙 실행 내역과 동일한 관련 데이터를 제공하지만 각 항목에 규칙 ID도 포함합니다.

이 엔드포인트의 항목은 최신에서 오래된 순으로 정렬됩니다. 또한 이 엔드포인트는 위와 동일한 필터링 메커니즘(object_id, action 및 hide_no_changes)을 지원합니다.

curl -G   \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_history

규칙 미리 보기

예약 기반 규칙의 변화를 미리 볼 수 있는 엔드포인트가 있습니다. POST 요청을 전송하면 이 엔드포인트는 해당 시점에 규칙의 모든 지정된 필터를 충족하는 개체 리스트를 반환합니다.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/preview

수동으로 규칙 실행

예약 기반 규칙을 수동으로 실행할 수 있는 엔드포인트가 있습니다. POST 요청을 이 엔드포인트로 보내면 규칙 실행이 즉시 예약됩니다.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_RULE_ID>/execute

규칙 실행이 완료되면 실행 내역에서 결과를 가져올 수 있습니다.

개체에 적용되는 규칙 읽기

각 광고, 광고 세트 및 광고 캠페인에 적용되는 모든 규칙을 읽을 수 있는 엔드포인트가 있습니다. id 필터를 사용하여 정적으로 참조하거나 entity_type 필터를 사용하여 동적으로 참조하는 경우 규칙이 기본적으로 개체에 적용됩니다.

이 엔드포인트는 선택적 pass_evaluation도 지원합니다. 이를 통해 해당 시점에 개체가 규칙 필터를 통과하는지 여부로 규칙 리스트를 추가적으로 제한할 수 있습니다. pass_evaluation이 true일 경우 통과하는 규칙을 모두 반환하고 previewed일 경우 개체를 반환합니다. false일 경우 통과하지 않는 규칙을 모두 반환합니다.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<AD_OBJECT_ID>/adrules_governed