Keitaro 集成指南

要为 Blockchain-Ads 网络使用 Keitaro 设置服务器到服务器 (S2S) 转化跟踪，您将配置 Blockchain-Ads 生成回传 URL（Keitaro 将在此处发送转化数据），然后将其作为自定义流量来源集成到 Keitaro 中。这确保 Keitaro 从入站流量中捕获 {clickid}，并将带有匹配的点击 ID、收入和其他详细信息的回传发送回 Blockchain-Ads。

步骤 1：在 Blockchain-Ads 中创建 S2S 转化事件

1. 登录到您的 Blockchain-Ads HUB 仪表板。
2. 导航至 Advertising > Tracking > Create Conversion > Server to Server。
3. 按照屏幕上的说明设置事件：
   
   • 命名转化事件（例如“Lead”或“Sale”）。
   • 指定事件类型（例如 lead、purchase）以及适用的任何收入字段。
   • 这将为您的事件生成唯一的跟踪器 ID 和以下格式的回传 URL：

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}：唯一点击 ID 的占位符（Blockchain-Ads 将将其与原始点击匹配）。
• trackerid：您的固定事件 ID（不要更改）。
• {transaction_value}：收入/支付金额的可选占位符（如果不跟踪收入，则省略）。

复制此完整的回传 URL——您在 Keitaro 中需要它。

4. 保存事件。注意：在 Blockchain-Ads 中创建广告系列时，将您的目标 URL 设置为您的 Keitaro 广告系列 URL（例如 https://your-keitaro-domain.com/campaign123?clickid={clickid}）。Blockchain-Ads 将自动附加实际的点击 ID 值。

步骤 2：在 Keitaro 中将 Blockchain-Ads 添加为自定义流量来源

1. 登录到您的 Keitaro 仪表板。
2. 转到 Traffic Sources > Create。
3. 在“From template”字段中搜索“Blockchain-Ads”——如果没有模板，请选择 Custom 或留空以手动构建。
4. 填写基本详细信息：
   
   • Name：“Blockchain-Ads”。
   • Click ID 参数：将其设置为 clickid（这告诉 Keitaro 捕获来自 Blockchain-Ads 流量的入站 ?clickid=xxx 值，并将其作为回传的外部 ID 存储在内部）。
5. 在参数模板部分（如果出现提示）：
   
   • 为点击 ID 添加一行：
     
     • 列 1 (Alias)：留空或设置为“External ID”以用于报告。
     • 列 2 (Parameter name)：clickid。
     • 列 3 (Macro)：留空（因为 Blockchain-Ads 直接附加实际值）。
   • 根据需要添加其他参数（例如，从 Blockchain-Ads 宏中获取的广告系列 ID 或 subID）。
6. 在 S2S Postback 字段中：
   
   • 粘贴步骤 1 中的回传 URL。
   • 将 Blockchain-Ads 占位符替换为 Keitaro 等效值：
     
     • {clickid} → {external_id}（传递捕获的点击 ID）。
   • 转换后的 URL 示例：

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

如果您只想发送特定的转化状态（例如已批准的潜在客户），请使用“Send only statuses”下拉菜单选择它们（例如“Lead”、“Sale”）。

7. 点击 Create 保存流量来源。
8. （可选）如果您有多个广告系列，请勾选 Update in campaigns 以将此应用于现有广告系列。

步骤 3：在 Keitaro 中设置广告系列并测试

1. 转到 Campaigns > Create（或编辑现有广告系列）。
2. 选择 Blockchain-Ads 作为 Traffic Source。
3. 构建您的流程：添加流、着陆页和优惠。对于转化：
   
   • 如果使用联盟优惠，请设置从联盟网络到 Keitaro 的回传（在 Affiliate Networks 下）。
   • 定义转化规则（例如，来自优惠的 S2S 回传、像素触发或自定义事件）。
4. 生成并复制您的 Keitaro 广告系列 URL（它看起来像 https://your-domain.com/abc?clickid={external_id}——将其作为目标粘贴到您的 Blockchain-Ads 广告系列中）。
5. 测试：
   
   • 在 Blockchain-Ads 中启动指向 Keitaro URL 的测试广告系列。
   • 模拟点击和转化（例如，通过测试优惠）。
   • 检查 Keitaro 报告 (Reports > Conversions) 以获取捕获的点击/转化。
   • 在 Blockchain-Ads 跟踪中验证回传是否到达（匹配的点击 ID 和收入）。
   • 如果需要，请使用 Postman 等工具手动触发测试回传。

提示和故障排除

• Keitaro 中的占位符：对 clickid 使用 {external_id}，对金额使用 {revenue}，对事件类型使用 {status}（例如，将“lead”映射到状态）。对于未编码的值，请使用前缀 _（例如 {_external_id}）。
• 收入/货币：如果转化有不同的货币，请使用 {revenue:USD} 进行转换。
• 错误：确保对回传使用 HTTPS。如果没有数据流动，请检查 URL 编码、防火墙阻止或不匹配的跟踪器 ID。Keitaro 在 Logs > Postbacks 中记录回传尝试。
• 高级：对于多个事件，在 Blockchain-Ads 中创建单独的转化事件，并在 Keitaro 中添加多个回传 URL（每个状态一个）。

此设置允许在没有 Cookie 的情况下进行准确归因。有关 Keitaro 的更多详细信息，请参阅其文档 docs.keitaro.io