실행 사양

규칙의 execution_spec은 평가를 통과하는 모든 개체에 적용되는 조치를 결정합니다. 일정 및 트리거 기반 규칙은 여러 가지 조치를 지원합니다. 조치는 execution_type에 나열되어 있습니다.

실행 유형	설명
`NOTIFICATION`	이 옵션을 제공하는 경우 규칙을 만든 사람이나 `user_ids`에 지정된 사용자 리스트로 강조된 알림을 전송합니다. 지원되는 평가 유형:`SCHEDULE`, `TRIGGER`
`PAUSE`	개체를 일시 정지합니다. 지원되는 평가 유형:`SCHEDULE`, `TRIGGER`
`UNPAUSE`	개체 일시 정지를 취소합니다. 지원되는 평가 유형:`SCHEDULE`, `TRIGGER`
`CHANGE_BUDGET`	정의된 `change_spec`을 기반으로 예산을 변경합니다. 이는 광고 세트에만 적용됩니다. 지원되는 평가 유형:`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	정의된 `change_spec`을 기반으로 예산을 변경합니다. 이는 광고 캠페인에만 적용됩니다. 지원되는 평가 유형:`SCHEDULE`
`CHANGE_BID`	정의된 `change_spec`을 기반으로 입찰가를 변경합니다. 이는 광고 세트에만 적용됩니다. 지원되는 평가 유형:`SCHEDULE`
`ROTATE`	현재 활성 상태의 광고를 일시 중단하고 광고 세트에서 ID 기준으로 다음 광고를 활성화합니다. 광고 세트의 `id` 필터와 광고의 `entity_type` 필터가 필요합니다. 지원되는 평가 유형:`SCHEDULE`
`REBALANCE_BUDGET`	평가 기준과 매칭되는 개체를 일시 정지하고 정의된 `rebalance_spec`를 기준으로 나머지에 대해 예산을 조정합니다. 이는 광고 세트에만 적용됩니다. 지원되는 평가 유형:`SCHEDULE`
`PING_ENDPOINT`	Webhooks를 통해 앱 구독으로 핑을 보냅니다. 설정에 대한 자세한 내용은 트리거 기반 규칙을 참조하세요. 지원되는 평가 유형:`TRIGGER`

`execution_options`

이러한 조치를 수행하기 위해서는 추가적인 정보를 제공해야 할 수 있습니다. execution_spec는 이러한 추가적 매개변수를 지정하기 위한 선택적 execution_options 배열을 제공합니다. 배열에는 execution_option 개체의 리스트가 포함됩니다. 이는 평가 사양의 filter 개체와 마찬가지로 field, value 및 operator의 키가 포함된 사전입니다.

트리거 기반 규칙은 실행 옵션이 필요하지 않습니다.

지원되는 실행 옵션과 지원하는 execution_type 값, 구성 방법에 대한 내용은 아래를 참조하세요. 현재 모든 옵션에 대해 유일하게 지원되는 연산자는 EQUAL입니다.

실행 옵션 필드	설명
`user_ids`*	`NOTIFICATION`에 대한 강조된 알림을 받는 사람, 또는 각 `execution_type`에 대한 일정 기반 규칙 요약 이메일의 받는 사람 지원되는 실행 유형:일정 기반 규칙에서 지원하는 모든 `execution_type` 값(예):`array ([123, 456])`
`change_spec`	`amount`, `limit`, `unit`, `target_field`를 지정합니다. 지원되는 유형에 대한 사전으로 필요합니다. `target_field`가 존재하는 경우 대상 필드의 현재 값과 `amount`에 지정된 대상 값 사이의 차이를 기준으로 한 입찰가 또는 예산 규모. `target_field`는 유효한 인사이트 필터여야 합니다. 지원되는 실행 유형:`CHANGE_BUDGET`, `CHANGE_BID` 값(예):광고 규칙 변경 사양 예시
`rebalance_spec`	예산 조정 방법을 결정하는 여러 가지 옵션을 지원합니다. 자세한 내용은 예시를 참조하세요. 지원되는 실행 유형:`REBALANCE_BUDGET` 값(예):예산 조정 광고 규칙
`execution_count_limit`	규칙에 대해 각 개별 광고 개체에 예산/입찰가 변경 조치를 취하는 최대 횟수를 지정합니다. 지정하지 않는 경우 기본값은 무한입니다. 지원되는 실행 유형:`CHANGE_BUDGET`, `CHANGE_BID` 값(예): int (123)
`action_frequency`	규칙에서 개체에 대해 동일한 조치를 취할 수 있을 때까지 최소 시간(분)을 지정합니다. 예를 들어 `CHANGE_BUDGET` 규칙에 대한 값이 `10080`이고 방금 전에 해당 규칙에서 개체 A에 대해 예산을 늘린 경우, 개체 A가 해당 주에 규칙 평가를 통과하더라도 해당 규칙은 적어도 일주일 이상 개체 A에 대한 예산을 늘리지 않습니다. 지원되는 실행 유형:`CHANGE_BUDGET`, `CHANGE_BID` 값(예): int (123)

`user_ids`

user_ids가 일정 기반 규칙에 제공되는 경우는 다음과 같습니다.

최근 24시간 이내에 규칙에서 수행한 조치를 요약하는 일일 이메일이 생성됩니다.
이 정보는 user_ids에 지정된 사용자 리스트로 전송됩니다.
이 이메일은 광고 계정 시간대로 오전 12시 30분에 전송됩니다.

이 요약 이메일은 각 사용자가 구독하는 모든 규칙에 대한 알림을 집계합니다. 구독한 규칙 중에서 조치를 취하지 않는 경우 사용자는 해당하는 날에 대한 이메일을 받지 않습니다.