跳到內容

通過連接獲取數據內容

使用銅焊連接的內容,您可以從Voucherify API獲取數據,並將消息發送到特定的釺段。引用的這篇文章將向您展示如何設置連接內容腳本發布Voucherify優惠券,邀請新的反向鏈接,獲取忠誠卡的平衡,等等。

的基本模式腳本看起來如下:


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11

             
{%連接內容“voucherify-API-ENDPOINT-url”:方法帖子:頭{“X-App-Id”:“Voucherify-API-key”,“X-App-Token”:“Voucherify-Secret-key”,}:content_typeapplication / json:重試:保存{{result_variable}}}

參觀VoucherifyGitHub庫看到連接內容腳本的例子。

安全設置

沒有以下設置設置每次連接內容消息被觸發,它將調用Voucherify API至少兩次。這些設置減少API調用的數量發票釺和削減的風險達到hard-blocking API可能打破消息傳遞的限製。

速度限製器

確保你限製消息的數量每分鍾發送的釺。這保證釺和Voucherify api對觸及太多交通從你的活動。當目標用戶在活動設置,限製發送速率每分鍾500條消息。

緩存後調用

連接內容通過HTTP POST調用不緩存默認情況下,將兩個API請求每個發布的代碼。這種行為可以應變你的API的限製。緩存機製將允許您限製出版,每券一個API調用。

添加緩存POST調用:

  1. 添加一個:cache_max_age屬性。默認情況下,緩存時間是5分鍾。您可以自定義使用秒持續時間。它可以設置5分鍾到4小時之間。例子::cache_max_age 3600將緩存1小時。
  2. 提供一個緩存鍵cache_id = {{cache_id}}在目標端點查詢參數釺可以識別一個獨特的出版。首先,定義變量,然後將獨特的查詢字符串附加到您的端點。這將區分每個出版的source_id。

注意後果:釺基於URL緩存API調用。獨特的字符串作為查詢參數由Voucherify忽略,但這對釺和區分不同的API請求允許緩存單獨每一個獨特的嚐試。沒有查詢參數,每一位客戶將收到相同的優惠券代碼緩存時間。

重試屬性

連接內容並不驗證Voucherify反應,所以我們另外建議添加一個重試在連接屬性內容腳本。連接內容邏輯將嚐試重試前五次流產的消息(它會尊重速率限製器)。這種方法將有助於防止案件時發布失敗的代碼需要一段時間從Voucherify獲取數據。

如果你不使用:重試返回的響應,那麼無論從Voucherify釺將試圖發送分布,這可能會導致生成電子郵件沒有發布代碼。

每個客戶獨特的出版

的source_id參數的腳本的身體提供每個客戶隻能接受一個獨特的代碼在一個釺運動。因此,即使釺無意中繁殖的請求,每個用戶將收到相同的獨特的代碼發布到他/她的第一個消息。

您可以修改{{source_id}}及其對出版物的影響通過使用以下配置:

配置 效果
{{運動。$ {dispatch_id}}} 確保所有客戶在一個日輸氣量將使用相manbetx万博全站客户端同的出版物。
{{運動。$ {api_id}}} 確保所有客戶在一個活動將使用相同的manbetx万博全站客户端出版物。
{{$ {user_id}}}或{{$ {braze_id}}} 確保每一位客戶將使用相同的出版無論競選(您可以使用發送$ {user_id}這是一個external_id和$ {braze_id}這是一個內部id)。
{{運動。$ {dispatch_id}}}和{{運動。$ {user_id}}} 每個客戶在一個日輸氣量將使用相同的獨特的出版。

Join-once

如果你的Voucherify運動有限製manbetx万博全站客户端客戶可以隻參加一次出版、刪除源id從腳本的身體。Voucherify將確保每個釺消息公布的相同的客戶將提供相同的代碼放在第一位。

你的連接內容腳本應該如下:


            

             
              

               
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

               
{%分配braze_campaign_id={{運動$ {。api_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配cache_id=braze_campaign_id|附加:customer_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%connected_contenthttps:/ / api.voucherify.io / v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:身體運動={{voucherify_campaign_id}}及客戶={{customer_id}}通道=釺:content_typeapplication / json:cache_max_age:重試:保存出版%}

例子

記住下麵所有的例子使用Voucherify出版源id和釺緩存和重試參數限製API調用調用釺活動。你必須知道以下後果:

  • 它不可能發布和發送不同的編碼相同的客戶在一個釺運動。
  • 如果你Voucherify活動使用隻加入一次特性,你需要刪除source_id從身體連接的內容如上join-once選項卡中描述。

參觀VoucherifyGitHub庫看到連接內容腳本的例子。

發布和獨特發送優惠券代碼

在這個例子中,連接內容腳本調用Voucherify API發布一個獨特和釺消息發送優惠券代碼。每個釺用戶收到隻有一個惟一的代碼。


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

             
{%分配braze_campaign_id={{運動$ {。api_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%分配cache_id=source_id%}{%connected_content你的API端點/ v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:身體運動={{voucherify_campaign_id}}及客戶={{customer_id}}通道=Braze&source_id={{source_id}}:content_typeapplication / json:cache_max_age:重試:保存出版%}

邀請新反向鏈接

如果你想讓客戶加入推薦計劃,您需要指定一個推薦代碼來那個人。連接的內容仍然與前麵的示例相同。這個連接內容腳本可以發布和獨特的推薦碼發送給用戶選擇釺。每個用戶隻收到一張轉診代碼與其他用戶分享和獲得新的推薦。


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

             
{%分配braze_campaign_id={{運動$ {。api_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%分配cache_id=source_id%}{%connected_content你的API端點/ v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:身體運動={{voucherify_campaign_id}}及客戶={{customer_id}}通道=Braze&source_id={{source_id}}:content_typeapplication / json:cache_max_age:重試:保存出版%}

獲取忠誠卡餘額

連接內容腳本的一個例子,把當前的忠誠平衡基於忠誠卡的代碼被事先釺作為自定義屬性。注意,您需要存儲忠誠卡代碼作為一個自定義屬性使用這個腳本在釺用戶的資料。


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

             
{%分配braze_campaign_id={{運動$ {。api_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%分配cache_id=source_id%}{%connected_content你的API端點/ v1 /忠誠/會員/ {{custom_attribute。$ {loyalty.card}}} ? cache_id={{cache_id}}:方法得到:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:content_typeapplication / json:cache_max_age:重試:保存成員%}

創建自定義代碼

連接的內容是一個功能強大的工具允許創造性的引入場景。您可以創建一個定製的優惠券代碼基於客戶的個人信息。

這是一個例子的代碼片段會考慮客戶的電話號碼生成一個惟一的代碼。在這個例子中,連接內容腳本調用Voucherify API發布一個定製的優惠券代碼。

  1. 首先,定義所有變量。然後,創建一個優惠券代碼從前綴“夏季——”和其餘的代碼將客戶的電話號碼。你可以在自定義屬性決定你想讓您的優惠碼基於。

    
            
    
             
              
    
               
    1 2 3 4 5 6 7
    		
               
    {%分配braze_campaign_id={{運動$ {。dispatch_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配phoneNumber={{{美元phone_number}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配cache_id=source_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%分配前綴=“夏天- - - - - -”%}

  2. 接下來,請求Voucherify在競選活動中生成一個代碼。我們提供優惠碼的名稱創建URL中:

    
            
    
             
              
    
               
    1 2 3 4 5 6 7 8 9 10 11 12
    		
               
    {%connected_contentYOUR-API-ENDPOINT / v1 /運動/ {{voucherify_campaign_id}} /憑證/{{前綴}}{{phoneNumber}} ? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:content_typeapplication / json:cache_max_age:保存voucher_created:重試%}

  3. 最後,發布您剛剛創建的代碼。看起來幾乎相同的代碼片段,你用於生成一個隨機的抵用券的活動。然而,這一次我們是在針對特定的優惠券代碼。

    
            
    
             
              
    
               
    1 2 3 4 5 6 7 8 9 10 11 12 13
    		
               
    {%connected_contentYOUR-API-ENDPOINT / v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:身體憑證={{前綴}}{{phoneNumber}}及客戶={{customer_id}}通道=Braze&source_id={{source_id}}:content_typeapplication / json:cache_max_age:保存出版:重試%}

因此,客戶收到以下郵件:

這是本例中使用完整的片段:


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34

             
{%分配braze_campaign_id={{運動$ {。dispatch_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配phoneNumber={{{美元phone_number}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配cache_id=source_id%}{%分配voucherify_campaign_id=“VOUCHERIFY-CAMPAIGN_ID”%}{%分配前綴=“你的前綴”%}{%connected_contentYOUR-API-ENDPOINT / v1 /運動/ {{voucherify_campaign_id}} /憑證/{{前綴}}{{phoneNumber}} ? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:content_typeapplication / json:cache_max_age:保存voucher_created:重試%}{%connected_contentYOUR-API-ENDPOINT / v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“VOUCHERIFY-APP-ID”,“X-App-Token”:“VOUCHERIFY-APP-TOKEN”}:身體憑證={{前綴}}{{phoneNumber}}及客戶={{customer_id}}通道=Braze&source_id={{source_id}}:content_typeapplication / json:cache_max_age:保存出版:重試%}

在釺消息顯示獲取數據

我們假設您已經有一個釺運動或畫布,您想要使用連接內容腳本。

步驟1:連接內容腳本添加到消息模板

  1. 在複製和粘貼連接內容腳本<身體>標簽信息的HTML模板。取代CAMPAIGN_ID與Voucherifycampaign_id複製URL地址的Voucherify競選儀表板。

    
            
    
             
              
    
               
    1
    		
               
    分配voucherify_campaign_id = " camp_Y7h1meBSyybsNs7UpSVVZZce "

  2. 提供你的Voucherify API端點。如果你不知道你的API端點是什麼,你可以檢查它項目設置>一般>API端點。

    
            
    
             
              
    
               
    1
    		
               
    你的API端點/ v1 /出版物? cache_id = {{cache_id}}
    共享的集群 端點為釺連接的內容
    歐洲(默認) https://api.voucherify.io/v1/publications
    美國 https://us1.api.voucherify.io/v1/publications
    亞洲(新加坡) https://as1.api.voucherify.io/v1/publications

  3. 添加您的API密鑰進行身份驗證。你可以找到Voucherify-App-Id和Voucherify-App-Token在你的項目設置>一般>應用程序鍵。

    
            
    
             
              
    
               
    1 2
    		
               
    :“X-App-Id VOUCHERIFY-APP-ID”、“X-App-Token”:“VOUCHERIFY-APP-TOKEN”

現在你的連接內容腳本準備好了。


          

           
            

             
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

             
{%分配braze_campaign_id={{運動$ {。api_id}}}%}{%分配customer_id={{{美元user_id}}}%}{%分配source_id=braze_campaign_id|附加:customer_id%}{%分配voucherify_campaign_id=“camp_Y7h1meBSyybsNs7UpSVVZZce”%}{%分配cache_id=source_id%}{%connected_contenthttps:/ / api.voucherify.io / v1 /出版物? cache_id={{cache_id}}:方法帖子:頭{“X-App-Id”:“490 a3fb6-a”,“X-App-Token”:“328099 d5-a”}:身體運動={{voucherify_campaign_id}}及客戶={{customer_id}}通道=Braze&source_id={{source_id}}:content_typeapplication / json:cache_max_age:重試:保存出版%}

步驟2:創建一個片段來顯示獲取數據

響應從Voucherify API存儲連接內容的價值:保存參數。例如:


          

           
            

             
1

             
:保存成員

這使您能夠檢索和顯示數據從釺Voucherify響應消息。

顯示發布的代碼,您可以創建片段優惠卡平衡,過期日期,和其他參數包含在JSON格式反應Voucherify API。

例如,顯示在消息發布的代碼模板,您必須創建一個片段獲取一個獨特的代碼從憑證對象。

連接內容腳本:

連接內容腳本顯示保存Voucherify反應結束的時候電話聯係內容

在釺消息模板片段:


          

           
            

             
1

             
{{出版。憑證。代碼}}

因此,每一個客戶都有一條消息,該消息帶有一個獨特的代碼自動分配給他們的個人資料。每次用戶收到代碼,它是在Voucherify發布到他/她的形象。

顯示一個優惠卡平衡從Voucherify API,您需要創建以下片段:


          

           
            

             
1

             
{{成員。loyalty_card。平衡}}

的成員是價值在哪裏:保存參數在連接內容腳本。


          

           
            

             
1

             
:保存成員

我們強烈建議你不要完全依賴於“預覽模式”,並發送一些測試消息確認一切正常。

步驟3:設置速度限製器

當設置一個活動目標,使用高級設置限製每分鍾發送的消息數量。

閱讀更多關於釺速率限製器和頻率限製文檔。

編輯這個頁麵在GitHub上
這個頁麵是有用嗎?
新東西!
Baidu
map