버전 3.0

마케팅 API

출시 2018년 5월 1일 | 이용 가능 시기 2019년 2월 1일 | 블로그 게시물

• 새로운 기능
• 핵심 변경 사항
• 사용 중단 사항
• 즉각적인 사용 중단 사항

새로운 기능

최저 비용 입찰 전략, bid_strategy 필드

새로운 필드 bid_strategy를 {account-id}/adsets에 도입하였습니다. 이 필드를 이용하면 비즈니스 목표에 따라 광고 입찰 전략을 선택할 수 있습니다. 각각의 전략에는 나름의 장점과 반대급부가 있습니다. 옵션에는 다음이 포함됩니다.

• LOWEST_COST - 광고 세트에 산정한 예산과 게재 optimization_goal에 따라 최선의 결과를 얻을 수 있습니다. Facebook이 필요에 따라 자동으로 입찰을 늘려 예산을 지출합니다. 입찰에 대한 최댓값을 정해놓거나 이 옵션에는 제한을 두지 않아도 됩니다.

• TARGET_COST - 광고 세트 예산이 증가하면 그에 따라 안정적인 평균 비용을 제시합니다.

자세한 내용은 광고 구매 및 최적화, 입찰 전략을 참조하세요.

컬렉션 광고, 생성

컬렉션 광고를 만들기 위한 새로운 API - 이전에는 사용자가 컬렉션 광고를 만들 때마다 Facebook이 백그라운드에 캔버스를 생성했습니다. 이렇게 하면 기본 캔버스에 대한 사용자의 액세스가 제한됩니다. 다시 말해 이 캔버스를 사용하여 캔버스 참여 타겟을 통해 타겟을 리타게팅할 수 없었다는 뜻입니다. 이제부터는 제품 세트에서 컬렉션 광고를 만들 때 올바른 요소를 포함하여 명시적으로 캔버스도 하나 생성해야 합니다. 컬렉션 광고에서 이 캔버스를 사용하면 Facebook이 자동으로 컬렉션 광고를 생성합니다. 자세한 내용은 제품 세트의 컬렉션 광고를 참조하세요.

핵심 변경 사항

광고 관리

• 오른쪽 열 무효화 - Facebook에서 무효화하는 광고는 Facebook 위치만 타게팅하는 광고, {ad_account_id}/adsets에서 right_hand_column에 대한 잘못된 목표를 포함한 right_hand_column뿐입니다. 이제부터는 특정 목표를 포함하는 지원되는 광고 형식에 대해서만 오른쪽 노출 위치를 지원합니다. 지원되는 목표는 트래픽, 전환 및 제품 카탈로그 판매입니다.

• v3.0 이후부터는 GET과 POST 둘 모두에서 is_autobid와 is_average_price_pacing 사용이 중단됩니다.

타겟 및 광고 타게팅

• 맞춤 타겟의 규칙 구문 변경 - 웹사이트 맞춤 타겟, 모바일 앱 맞춤 타겟, 페이지 참여 맞춤 타겟, 잠재 고객용 광고 참여 타겟, 캔버스 참여 타겟 및 오프라인 맞춤 타겟을 생성하는 데 쓰이는 규칙의 구조를 업데이트했습니다. 따라서 이제부터 집계 행동, 다양한 이벤트 소스의 규칙을 근거로 규칙을 생성할 수도 있고 규칙을 제외할 수도 있습니다. 다음 내용을 참조하세요.

  • 웹사이트의 맞춤 타겟, 타겟 규칙,

  • 모바일 앱의 맞춤 타겟, 타겟 규칙,

  • 페이지 참여 맞춤 타겟,

  • 잠재 고객용 광고의 참여 타겟,

  • 캔버스를 위한 참여 타겟 및

  • 오프라인 전환으로부터의 맞춤 타겟.

다이내믹 광고

• 제품 카탈로그 액세스 - 카탈로그 항목에 액세스하려면 올바른 카탈로그 업종을 지정해야 합니다. 요청이 카탈로그의 올바른 업종과 일치하지 않으면 오류가 발생합니다. 예를 들어 전자상거래 카탈로그는 해당하는 /products 엔드포인트(예: GET {catalog_id}/products, GET {product_feed_id}/products 또는 GET {product_set_id}/products)로 액세스해야 합니다. 이 카탈로그에 다른 업종의 엔드포인트(예: GET {catalog_id}/autos, GET {product_feed_id}/hotels 또는 GET {product_set_id}/flights)를 사용해 액세스할 수는 없습니다.

• 템플릿 태그의 빈 문자열 - 이제 다이내믹 광고, 템플릿 태그 옵션에 빈 문자열을 매개변수로 허용하지 않습니다. 예를 들어 빈 문자열을 {{trip.checkin_date date_format:}}에 전달하면 오류가 발생합니다. 배경 정보는 다이내믹 광고, 광고 관리를 참조하세요.

광고 인사이트 및 측정

• 인사이트 시간 초과 - 인사이트 API 요청이 완료되기 전에 시간이 초과될 것으로 예상되면 오류 코드 100과 하위 코드 1504033으로 오류를 반환합니다. 이것은 요청의 크기, 그리고 시간 초과 제한에 상대적으로 계산한 처리 진행 속도를 근거로 추정합니다. 이 오류가 발생하는 경우, 이 데이터에 대하여 비동기식 인사이트 API를 요청해야 합니다. 인사이트 API 비동기 작업을 참조하세요.

• 이벤트 데이터의 음수 값 - 이벤트 데이터를 {data_set_id}/events에 음수 값으로 게시하면 실패합니다. 이는 POST /{data_set_id-id}/events의 data 필드에 영향을 미칩니다.

• 캠페인 예산 최적화에 대한 인사이트 - 광고 캠페인이 캠페인 예산 최적화를 사용하면 adset_budget_value가 using campaign budget을 반환하게 됩니다. 다음에 영향을 미칩니다.

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• 픽셀의 기본 정렬 - 비즈니스 계정이든 광고 계정이든 GET {account_id}/adspixel 에지를 호출하면 결과를 반환할 때 마지막 픽셀 실행 시간 대신 기본적으로 픽셀 이름을 기준으로 정렬합니다.

• 픽셀 통계 필드 이름 변경 - 픽셀 통계 에지의 timestamp 필드 이름을 start_time으로 변경했습니다. 이것은 픽셀 실행에 대하여 시간당 데이터를 집계하기 시작한 시작 시간을 나타냅니다. 이제부터 이것을 ISO 8601 형식으로 반환하며, 여기에 시간대 오프셋을 포함합니다. 이렇게 하여 잘못된 Unix 타임스탬프를 반환하던 문제를 해결하였습니다. 영향을 받는 엔드포인트는 GET {ads-pixel-id}/stats입니다.

사용 중단 사항

비즈니스 관리자

POST {pixel-id}/shared_agencies 엔드포인트의 사용이 중단되었습니다. 광고 픽셀을 에이전시와 공유하려면 비즈니스 관리자 UI를 사용하세요.

광고 관리

• /{ad_campaign_id}와 /ad_account_ID/campaigns에서 kpi_custom_conversion_id, kpi_type, kpi_results가 사용 중단되었습니다.

• API를 간소화하기 위해 다음과 같은 엔드포인트에서 'redownload' 플래그의 사용을 중단하였습니다.

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  'fields' 매개변수를 사용하면 이 정보를 여전히 읽을 수 있습니다.

• POST act_{ad-account-id}/adimages에서 zipbytes 필드의 사용을 중단하였으며 해당 에지에서 ZIP 파일을 업로드하는 기능을 제거하였습니다. 확장자가 jpg, jpeg, gif, bmp, png, tiff 또는 tif인 이미지를 사용하세요.

• 컬렉션 광고를 생성하는 데 쓰는 현행 메서드 사용을 중단합니다. 이 경우 모든 필수 자산을 매개변수로 포함한 API 호출 하나를 사용했습니다. 이제부터는 우선 캔버스부터 생성하고, 그 캔버스 링크를 사용해 컬렉션 광고를 생성해야 합니다. 이렇게 하면 기본 캔버스 개체에 액세스할 수 있게 되므로 타겟을 리타게팅할 수도 있게 됩니다. 컬렉션 광고를 참조하세요.

• 페이지 게시물 참여 목표를 포함한 광고에서 슬라이드 광고 형식 사용을 중단했습니다. 이 조합은 더 이상 유효하지 않습니다. 검증, 목표 및 크리에이티브를 참조하세요.

광고 구매 및 입찰

• POST {ad-account-id}/adsets와 POST {adset-id} 엔드포인트에서 is_autobid 및 is_average_price_pacing 필드의 사용이 중단되었습니다. 광고 세트에 특정한 입찰 전략을 지정하려면 대신 새 bid_strategy 필드를 사용하면 됩니다. 자세한 내용은 입찰 및 최적화를 참조하세요.

• 광고 및 광고 계정에 대해 delivery_estimate의 필드 사용이 중단되었습니다. 결과가 광고주 요구 사항에 부합하지 않았기 때문입니다. 또한 대다수 광고주의 비즈니스 목표가 Facebook의 추천 입찰가 금액으로 최선의 결과를 내기 어려울 가능성이 있었습니다. 사용 중단된 필드와 매개변수에는 다음이 포함됩니다.

  • bid_estimate 필드,

  • currency 매개변수,

  • daily_budget 매개변수,

  • optimize_for 매개변수

  Facebook 광고에서 얻는 실제의 본질적인 비즈니스 가치를 사용하여 이를 근거로 입찰하는 것이 좋습니다. 이 가치를 아직 모르는 경우, 자동 입찰 사용을 추천합니다. 배경 정보는 광고주 지원 센터, 광고 경매와 광고 구매 및 최적화를 참조하세요.

• GET /{rf-prediction-id}의 curve_budget_reach 필드에서 반환된 결과의 사용이 중단되었습니다. 이제부터는 맵을 반환하며, JSON 직렬화 문자열 반환 값은 사용하지 않습니다. 이 변경 사항은 GET /{rf-prediction-id}에 영향을 미칩니다.

• GET /{ad-account-id}/ratecard 에지의 사용이 중단되었습니다.

• /ad_accounts에서 청구와 관련된 몇몇 필드의 사용을 중단하였습니다. 여기에는 다음과 같은 항목이 포함됩니다.

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• GET /customaudience의 pixel_id와 external_event_source 필드 사용이 중단되었습니다.

광고 인사이트 및 측정

• OFFLINE_EVENT_SET_ID에서 GET /{data-set-id}와 GET /{data-set-upload-id}가 반환하는 matched_unique_users의 사용이 중단되었습니다. 오프라인 전환 API를 참조하세요.

• GET /{data_set_id} API에서 attributed_events 에지와 attribute_stats 필드의 사용이 중단되었습니다. 기여 이벤트 통계를 가져오려면 GET /{data_set_id}/stats API를 사용하세요.

• OFFLINE_EVENT_SET_ID에서 GET /{data-set-id}와 GET /{data-set-upload-id}가 반환하는 matched_unique_users 필드의 사용이 중단되었습니다.

• GET {data_set_upload_id}에서 기본 반환 값의 사용이 중단되었습니다. 이제 first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats 및 matched_unique_users 필드를 기본적으로 반환하지 않습니다.

• GET {data_set_id}/stats에서 기본 반환 값의 사용이 중단되었습니다. 이것은 이제 기본적으로 개수 통계만 반환합니다. 반환할 통계를 지정하려면 fields 매개변수를 사용하거나, 누적 통계(예: average_upload_delay)의 경우 summary 매개변수를 사용하세요.

• GET {data_set_id}에 대한 기본 반환 값의 사용이 중단되었습니다. 이제 attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries 필드를 기본적으로 반환하지 않습니다.

• GET {data-set-upload-id}/stats 에지의 사용이 중단되었습니다. 대신 GET {data-set-upload-id}의 valid_entries 또는 matched_entries 필드를 사용하세요.

• 인사이트 API에서 canvas_component_avg_pct_view의 사용이 중단되었습니다.