離線轉換- 行銷API
文章推薦指數： 80 %
4.企業管理平台系統用戶和權杖. 有了系統用戶存取權，應用程式便可透過API 向Facebook 傳送資料。
若要建立系統用戶：. 前往企業管理平台> 企業設定。
選擇系統用戶。
行銷API總覽開始使用GuidesAdCreativeBidding廣告規則引擎Audiences分析報告FBIQRSSAccess參考資料離線轉換API使用離線轉換API傳送離線轉換事件，瞭解多少顧客在轉換前曾檢視或點擊Facebook廣告。
準備工作若要使用此API，您需要：1.Facebook企業管理平台如果您還沒有，請先建立一個。
2.Facebook應用程式編號用於存取行銷API。
若要建立app：前往企業管理平台>企業設定。
選擇應用程式。
點擊新增應用程式，然後按照指示操作。
3.應用程式審查和權限有關應用程式審查和權限的規則，會視您如何實作我們的API而定：實作類型應用程式審查和權限悄悄傳實作在此案例中，您是想直接使用離線轉換的廣告商。
在此案例中：應用程式不需進行應用程式審查。
您無需要求任何權限。
實作為平台的合作夥伴在此案例中，您是為使用服務的廣告商提供離線轉換功能的第三方合作夥伴。
在此案例中：應用程式必須進行應用程式審查。
應用程式審查期間，您必須要求ads_management權限。
4.企業管理平台系統用戶和權杖有了系統用戶存取權，應用程式便可透過API向Facebook傳送資料。
若要建立系統用戶：前往企業管理平台>企業設定。
選擇系統用戶。
點擊新增系統用戶。
選擇管理員系統用戶為該系統用戶的角色。
存取權杖可提供對Facebook資料的存取權。
若要建立系統用戶存取權杖：前往企業管理平台>企業設定。
選擇系統用戶。
選擇系統用戶，然後點擊產生新權杖。
選擇您的應用程式>在範圍部分，選擇ads_management。
5.廣告帳號您必須擁有廣告帳號，才能在Facebook上刊登廣告行銷活動。
若要建立廣告帳號，請參閱行銷API或廣告主使用說明：在企業管理平台中設定工作人員、粉絲專頁和廣告帳號。
6.將系統用戶存取權授予廣告帳號將您的系統用戶存取權授予廣告帳號。
前往企業管理平台>企業設定。
選擇系統用戶。
選擇系統用戶，然後點擊指派資產。
選擇廣告帳號。
7.離線事件組合這些是包含離線轉換資料的上傳檔案。
建立廣告時，請將tracking_spec設為離線事件組合編號，以利正確歸因事件。
然後便可建立事件組合、檢視匯入項目的統計資料，以及在企業管理平台刪除與修改這項資料。
對於舊有建置，若要與其他物件和實體共用事件組合，您可在企業管理平台層級對離線事件組合執行CRUD作業。
上傳事件資料您需要特定存取權才可建立離線事件組合、上傳或檢視事件組合的資料。
您也需要此存取權將這些權限指派給廣告帳號。
您必須是以下任一人員：企業管理平台管理員建立該離線事件組合的管理員系統用戶連結至該離線事件組合之ad_account的管理員請參閱參考資料：離線轉換事件組合。
1.建立離線事件組合cURLcurl
-F'access_token=
範例：Instorepurchases、Leadregistrationsdescription類型：字串事件組合說明。
範例：InstorepurchasesfortheSuperbowlcampaign2.指派廣告帳號權限若要將追蹤和讀取權限指派給廣告帳號：HTTPcURL圖形API測試工具POST/
account_id類型：整數啟用離線追蹤的廣告帳號編號。
3.設定廣告追蹤當您更新tracking_spec時，我們會予以覆寫。
請務必先執行GET，然後將離線事件組合的相關聯String附加至既有的tracking_spec。
請參閱廣告管理，或使用廣告管理員。
例如，提供適當的追蹤規格：curl\
-F'tracking_spec=[{action.type:"offline_conversion",dataset:["123"]}]'\
-F'access_token=
範例：offline_conversiondataset類型：整數離線事件組合的編號。
範例：111111111114.上傳離線事件您應該在轉換發生的62天內上傳交易。
上傳轉換資料：curl\
-F'access_token=SYSTEM_USER_ACCESS_TOKEN'\
-F'upload_tag=store_data'\
-F'data=[\
{
match_keys:{"phone":["HASH1","HASH2"],"email":["HASH3","HASH4"]},
currency:"USD",
value:16,
event_name:"Purchase",
event_time:1456870902,
contents:[
{id:"A",quantity:1},
{id:"B",quantity:2},
{id:"C",quantity:1}
]
custom_data:{
event_source:"in_store"
},
},
{
match_keys:{"lead_id":"12345"},
event_name:"Lead",
event_time:1446336000,
contents:[
{id:"A",quantity:1},
{id:"B",quantity:2},
{id:"C",quantity:1}
]
custom_data:{
event_source:"email",
action_type:"sent_open_click",
email_type:"email_type_code",
email_provider:"gmail_yahoo_hotmail",
}
},
]'
https://graph.facebook.com/VERSION/OFFLINE_EVENT_SET_ID/events若要傳送轉換，請發出HTTPPOST：HTTPcURL圖形API測試工具POST/
追蹤事件上傳。
範例：monthly,in-storeuploadsdata類型：jsonarray必要項目。
包括上傳的事件數量。
每次API呼叫可上傳的轉換事件為每人最多2,000個事件。
範例：請參閱上述範例namespace_id類型：整數選用。
用於解析extern_id或tpid的範圍。
可為其他資料集或資料合作夥伴編號。
範例：12345同一批次的所有事件上傳API呼叫請使用相同的upload_tag，以利進行歸類。
這有助於偵錯事件上傳，對於發出不只一個API呼叫的所有事件上傳，您都應該使用這種方式。
data內的參數包括：
參數
說明
match_keys類型：JSON字典必要項目。
我們用來比對Facebook用戶的識別資訊。
範例：{"phone":["{HASH}","{HASH}"],"email":["{HASH}","{HASH}"],"fn":"{HASH}",}.event_time類型：整數必要項目。
轉換事件的UNIX時間戳記。
範例：1456870055event_name類型：字串必要項目。
事件類型。
範例：ViewContent、Search、AddToCart、AddToWishlist、InitiateCheckout、AddPaymentInfo、Purchase、Lead、Othercurrency類型：字串必要項目。
此轉換事件的3位字母ISO幣別代碼。
這是Purchase事件的必要欄位。
範例：USDvalue類型：雙精度浮點數必要項目。
轉換事件的值。
這是Purchase事件的必要欄位。
範例：16.00content_type類型：字串選用。
任何有效的動態廣告content-type。
範例：productcontents類型：JSON陣列選用。
若您要將廣告與商品目錄整合則需要。
範例：必要：id、quantity建議使用：price、brandcategory必要：[{id:"A",quantity:1},{id:"B",quantity:2},{id:"C",quantity:1}]建議使用：[{id:"A",quantity:1,brand:"Brand_A",category:"",price:10.0}]custom_data類型：JSON字典選用。
此轉換事件的相關資訊。
範例：{category:'ICECREAM'}order_id類型：字串選用。
不重複的識別資料，代表離線事件組合中的每一筆交易或訂單。
例如，對零售商來說，此識別資料可以是收據編號。
範例：ATN10001、123456item_number類型：字串選用。
不重複的識別資料，用於區分同一筆訂單或交易中的事件。
範例：1、a例如，您可以使用data欄位上傳資訊：{
match_keys:MATCH_KEYS,
event_time:EVENT_TIME,
event_name:"Purchase",
value:400,
currency:"USD",
contents:[
{
id:"A",
quantity:1,
brand:"brand_of_A",
category:"Apparel&Accessories|Clothing",
price:100,
},
{
id:"B",
quantity:2,
brand:"brand_of_B",
category:"Apparel&Accessories|Shoes",
price:50,
},
{
id:"C",
quantity:1,
brand:"brand_of_C",
category:"Apparel&Accessories|Jewelry|Watches",
price:200,
}
],
}同一批次的所有事件上傳API呼叫請使用相同的upload_tag，以利進行歸類。
這有助於偵錯事件上傳，對於發出不只一個API呼叫的所有事件上傳，您都應該使用這種方式。
配對金鑰match_keys是一組識別資料，用於比對用戶以利歸因。
如需將資料正規化和進行雜湊處理，請參閱CRM資料的自訂廣告受眾。
僅支援SHA256，且不接受未進行雜湊處理的資料。
金鑰類型，單一和多重
金鑰名稱
必須進行雜湊處理
電子郵件地址email是手機號碼phone是性別gen是出生日期，格式為YYYYdoby是出生日期，格式為MMdobm是出生日期，格式為DDdobd是姓氏ln是名字fn是名字縮寫fi是縣／市ct是美國州份st是郵遞區號zip是國家／地區country是Apple廣告識別碼madid是Android廣告編號madid是第三方用戶編號extern_id請勿進行雜湊處理名單型廣告的潛在顧客編號lead_id請勿進行雜湊處理回應：
名稱
類型
說明
num_processed_entries整數處理的項目數量發生錯誤時，您會看到內含無效項目和原因的例外狀況。
請修正錯誤或略過有錯誤的資料列，然後重試API呼叫。
檢視上傳統計資料企業管理平台管理員或建立該離線事件組合的系統用戶，皆可擷取上傳統計資料。
若是連結至該離線事件組合之ad_account的管理員，也可讀取此項資料。
若要檢視離線事件組合相關統計資料（例如有效項目和相符項目）：HTTPcURL圖形API測試工具GET/
如需更精準的資料解析，請發出以下呼叫：HTTPcURL圖形API測試工具GET/
UNIX時間戳記。
從此時間開始查詢事件。
範例：1456870055end類型：整數選用。
UNIX時間戳記。
排除此次之前發生的事件。
範例：1456870056fields類型：string[]選用。
字串清單。
在第3.0版之前，此端點會提供所有欄位，而在之後的版本則預設提供count、event和time。
其他欄位包括：matched_count、attributed_count、usd_amount、matched_usd_amount、attributed_usd_amount或duplicate_count。
summary類型：布林值選用。
彙總時間設為upload_time，且此欄位設為true時，會傳回平均上傳延遲時間（以秒為單位）。
aggr_time類型：字串選用。
根據此組合時間彙總結果。
選項包括upload_time和event_time。
預設值為event_time。
建立離線自訂轉換離線自訂轉換目前不會回填。
我們不會歸因您建立自訂轉換之前的事件上傳資料。
您無法使用離線自訂轉換資料進行廣告投遞最佳化。
請參閱參考資料：自訂轉換。
若要使用離線事件建立自訂轉換，請發出POST：HTTPcURL圖形API測試工具POST/act_
範例：Offlinepurchasesover100dollarsevent_source_id類型：整數要追蹤的離線事件組合編號。
範例：11111111111custom_event_type類型：字串Facebook像素九種標準事件之一。
範例："ViewContent"、"Search"、"AddToCart"、"AddToWishlist"、"InitiateCheckout"、"AddPaymentInfo"、"Purchase"、"Lead"、"CompleteRegistration"、"Other"rule類型：JSON編碼字串轉換規則的運算子和資料。
請參閱參考資料：自訂轉換。
例如，購買超過$100美元。
範例：{"and":[{"event_name":{"eq":"Purchase"}},{"value":{"gt":100}}]}成功時，回應如下：{
"id":
這類似於離線自訂廣告受眾。
每個廣告帳號的自訂轉換數量上限為40。
例如，使用custom_data將產品類別納入上傳資料中：data=[
{
match_keys:{"phone":["
大部分這些步驟的API呼叫就如同管理自己的離線事件組合與行銷活動管理一樣。
合作夥伴-建立離線事件組合合作夥伴-與客戶的企業管理平台共用事件組合客戶-將離線追蹤權限指派給廣告帳號客戶-在廣告設定離線追蹤合作夥伴-上傳離線事件、檢視統計資料合作夥伴-顯示客戶的廣告洞察報告以上步驟會視客戶廣告帳號設定的合作夥伴或代理商權限而有所不同：您可能擁有客戶的所有廣告帳號、事件組合或其他任何廣告素材。
您可能具備對客戶的廣告素材執行特定動作的權限。
若要設定這些權限，請參閱企業管理平台廣告素材。
合作夥伴-共用事件組合與客戶的企業管理平台共用事件組合。
然後，客戶就能夠使用該事件組合進行廣告追蹤。
HTTPcURL圖形API測試工具GET/
您必須是企業管理平台管理員，或是建立該離線事件組合的管理員系統用戶，才能對廣告帳號啟用廣告追蹤。
如果您身為連結至該離線事件組合之廣告帳號的管理員，也可執行這項作業。
若要發出此API呼叫，呼叫中的企業必須能夠存取該離線事件組合。
您可透過以下呼叫，將離線事件追蹤和檢視權限指派給廣告帳號：HTTPcURL圖形API測試工具POST/
account_id類型：整數啟用離線追蹤的廣告帳號編號提供外部編號有時候您可能會自己提供代表顧客的外部編號，然後與Facebook用戶進行配對。
若要如此進行，請按照下列準則使用extern_id。
經過比對程序的資料合作夥伴可使用合作夥伴編號作為命名空間編號，也能使用extern_id作為tpid。
只提供match_keys我們會使用match_keys嘗試判斷您分享的轉換資料是否可與Facebook用戶配對。
如果您提供match_keys，則無法同時提供namespace_id參數。
同時提供match_keys和extern_id我們會使用match_keys嘗試尋找Facebook用戶，再將對應項目從{dataset_id,extern_id}轉送至{facebook_user_id}。
如果您提供match_keys和extern_id，則無法同時提供namespace_id。
只提供extern_id如果您傳送的資料已經包含match_keys和extern_id，Facebook會使用{dataset_id,extern_id}擷取{facebook_user_id}。
提供namespace_idnamespace_id參數適用於整個API呼叫。
您可使用該參數來參照其他離線事件組合，而該離線事件組合是由某企業或合作夥伴個人檔案編號所擁有或可存取。
如果您傳送的資料已經包含match_keys和extern_id，Facebook會使用{namespace_id,extern_id}擷取{facebook_user_id}。
您只能針對每一列資料提供一個extern_id。
洞察報告和歸因條件查看歸因於用戶瀏覽或點擊過廣告的離線事件。
我們會在超過1天之後歸因離線轉換。
這表示您必須將歸因期間設為28d_view或action_attribution_windows=['28d_view']'，否則報告不會出現任何轉換資料。
請參閱洞察報告API和洞察報告指南。
HTTPcURL圖形API測試工具GET/act_
按動作類型分組：離線、上線等。
範例：["action_type","placement","age","gender","country","region"]fields類型：字串陣列基本廣告衡量指標。
範例：["impressions","clicks","actions",]level類型：字串彙總或不重複此分析報告結果層級的資料。
範例：ad或adset或campaigndate_preset類型：字串查詢衡量指標的相對時間範圍。
範例：last_n_days（n=7、14、28）或yesterday或today或last_month或lifetime結果會如下所示：{
"data":[
{
"date_start":"2015-12-01",
"date_stop":"2015-12-01",
"actions":[
{
"action_type":"offline_conversion.purchase",
"value":1
},
{
"action_type":"offsite_conversion.lead",
"value":3
},
],
...
}
]
}例如，若要瀏覽歸因：curl-G\
-d'access_token=
若要明確不啟用「限制資料使用（LDU）」模式，請為每個事件指定空陣列：{
"data":[
{
"event_name":"Purchase",
"event_time":
在此情況中，請將「資料處理選項」、「資料處理國家／地區」和「資料處理州／省」新增為檔案內的欄位。
有關此方面的詳細資訊，請參閱上傳用戶介面。
離線轉換自動上傳程式請參閱「離線轉換自動上傳程式」的「處理選項」。
深入瞭解資料處理選項。
延伸文章資訊
- 1fb轉換api設定教學 - MTMG網路行銷公司
- 2廣告主須知：Facebook轉換API是什麼？用途與設定一次掌握
安裝PixelYourSite 之後，可以在事件管理工具點選＂立即開始＂來勾選數據欄位與產生存取權杖（須為企業管理平台管理員），獲取API 權杖後請務必自行 ...
- 3使用Facebook 轉換API - 1shop 一頁購物
1.前往「Facebook事件管理工具> 資料來源」。 · 2.點擊要使用的「資料來源」，選擇「設定」。 · 3.移動至「轉換API」，按下「建立存取權杖」，然後跳到第9 ...
- 4臉書FB 廣告為了iOS14 改版，ROAS大跌把數位廣告行銷人員 ...
實作之後發現，CAPI 要做差不多的事(送轉換事件的資訊)，卻相當搞剛，個人帳號的像素裡的「建立存取權杖(Create Access Token)」按鈕是灰色的不能 ...
- 5串接Facebook 轉換API (Conversions API) - 歡迎使用 ...
串接Facebook 轉換API (Conversions API) · 1. 往Facebook事件管理工具> 資料來源 > 設定> 按下「建立存取權杖」。 · 2. 產生存取權杖」點擊「下一...
