Apple Search Ads

概述

Branch可以通过获取Apple Search Ads归因API来帮助跟踪Apple Search Ads广告系列。然后,您可以使用在Apple Search Ads仪表板中设置的参数,诸如广告系列名称之类的参数,并在安装后在您的应用中执行特殊操作,或者仅在Branch仪表板中跟踪广告系列的效果,以及其他您的其他分行统计信息,例如总安装次数,引荐和应用链接统计信息。

SDK设定

为了检查用户是否来自Apple Search Ads,必须在Branch初始化之前进行归因调用。作为警告,Apple '的Search Ads Attribution API可能要花费1秒钟以上的往返时间。这意味着您对Branch'的initSession的调用到回调块的执行可能会延迟此额外1秒钟。

📘

反应本机支持

如果您在应用中使用React Native,除了以下内容外,请确保遵循React Native集成的 Track Apple Search Ads 部分。

导入iAd和AdSupport

您必须在Xcode项目的Linked Frameworks 中添加Apple '和iAd.frameworkAdSupport.framework ,才能启用Apple Search Ads检查。

图像图像

🚧

使用椰子

如果使用Cocoapods,则会自动添加iAd框架(在构建阶段)并导入标头。如果不使用Cocoapods,则需要手动进行。

启用Apple搜索广告检查

📘

BranchiOS SDK v0.30.0

从v0.30.0版本开始,Branch iOS SDK支持新逻辑,该逻辑增加了Apple Search Ads用有效负载响应以及忽略Apple '的测试数据的等待时间。

要启用该检查,添加一个delayInitToCheckForSearchAds 拨打您的AppDelegate.m (或AppDelegate.swift )文件创建分公司后单身,但调用initSession 。您的代码最终看起来像这样:

Objective-C

Branch *branch = [Branch getInstance];

// This will usually add less than 1 second on first time startup.  Up to 3.5 seconds if Apple Search Ads fails to respond.
[branch delayInitToCheckForSearchAds];

// Increases the amount of time the SDK waits for Apple Search Ads to respond. The default wait has a better than 90% success rate, however waiting longer can improve the success rate. This will increase the usual delay to about 3 seconds on first time startup.  Up to about 15 seconds if Apple Search Ads fails to respond.
[branch useLongerWaitForAppleSearchAds];

// Branch won't callback with Apple's test data, this is still sent to the server.
[branch ignoreAppleSearchAdsTestData];

[branch initSessionWithLaunchOptions:launchOptions andRegisterDeepLinkHandler:^(NSDictionary *params, NSError *error) {
    // handle payload
    }];

Swift

let branch = Branch.getInstance()

// This will usually add less than 1 second on first time startup.  Up to 3.5 seconds if Apple Search Ads fails to respond.
branch.delayInitToCheckForSearchAds()

// Increases the amount of time the SDK waits for Apple Search Ads to respond. The default wait has a better than 90% success rate, however waiting longer can improve the success rate. This will increase the usual delay to about 3 seconds on first time startup.  Up to about 15 seconds if Apple Search Ads fails to respond.
branch.useLongerWaitForAppleSearchAds()

// Branch won't callback with Apple's test data, this is still sent to the server.
branch.ignoreAppleSearchAdsTestData()
branch.initSession(launchOptions: launchOptions, andRegisterDeepLinkHandler: { (params, error) in
    // handle payload
    })

如果您'担心额外的1秒延迟,则可以在运行时有条件地调用delayInitToCheckForSearchAds 。因此,如果您只想检查首次安装或类似安装,则只需'调用此方法即可。

🚧

测试Apple搜索广告

如果您使用非生产性应用进行测试且未使用ignoreAppleSearchAdsTestData() 方法,则iAd框架将返回假的Apple Search Ads有效负载,以模拟Apple Search Ads声称的安装。随后,您将在报告中看到这些声明。

🚧

对延迟深度链接的影响

如果您使用延迟的深度链接接,请不要使用useLongerWaitForAppleSearchAds() 方法,因为它将为延迟的深度链接接创建更长的等待时间,从而对最终用户'的体验产生负面影响。

服务器到服务器设置

如果您与Branch具有S2S集成(即您不使用Branch SDK发送Branch数据),则需要先进行Apple Search Ads检查,然后才能将返回的有效负载发送给Branch。

请参阅Apple Search Ads开发人员文档,了解如何向其API 发出请求。

实施准则

  • 在调用Apple '的Attribution API之前,请留出2秒的缓冲时间。如果您的请求在5秒钟后超时,请重试。
  • 如果响应返回为False或错误代码[0,2,3],则实施重试逻辑。 2秒后再次调用Apple。
  • 20秒后或成功响应后,使用返回的Apple Search Ads有效负载调用Branch。

费用数据设置

  1. 导航到 Apple Search Ads UI >设置> API 使用右上角的帐户选择器,确认您选择了正确的帐户。
  1. 创建一个API证书
  1. 将API证书下载到您的计算机。您将'解压缩该文件夹,并得到一个.key 和一个.pem 文件。
  1. 导航到“Branch”仪表板中的 Apple Search Ads合作伙伴经理
  2. 将证书上传到此处,选择每个文件,然后点击蓝色的上传箭头以上传文件。点击下一页继续。
  1. 选择您要为其提取数据的组织,然后点击保存以启用带有费用数据的Apple Search Ads。

📘

费用数据支持

📘

Agency-Managed Campaigns

Apple Search Ads数据已映射到Branch

Branch从Apple Search Ads归因API接收并映射以下参数:

Apple搜索广告参数Branch映射字段
iad-campaign-namelast_attributed_touch_data_tilde_campaign
iad-campaign-idlast_attributed_touch_data_tilde_campaign_id
iad-adgroup-namelast_attributed_touch_data_tilde_ad_set_name
iad-adgroup-idlast_attributed_touch_data_tilde_ad_set_id
iad-keywordlast_attributed_touch_data_tilde_keyword

在信息中心上查看归因

所有属性都可以在“ 分支”仪表板摘要页面上看到。从该频道注册的所有安装和打开将自动标记为channelApple App StoreAd PartnerApple Search Adscampaign将设置为您在Apple Search Ads仪表板中配置的广告系列名称。

  • 安装可能不准确,但安装+打开事件应与Apple Search Ads报告的内容相匹配。
  • 由于API的限制,设备可能需要30天才能完全归属。

请注意,这些统计信息是仅限于页面顶部的日期范围 。如果您愿意,可以扩大范围' 。

📘

归因窗口

Attribution windows can be specified at the global account level or on a per link basis with the link level window taking priority.

Please see our guide on Attribution Windows.

整合支援

与Apple Search Ads仪表盘相比安装差异

Apple Search Ads差异可能有几种原因。由于Apple Search Ads '归因设置的可定制性较低,因此即使性能可能可靠并且报告可能会按预期运行,Apple Search Ads上的差异通常也比其他平台更高。尝试与ASA安装和Branch进行对帐的最佳方法是查看'新下载'计数,但减去通过在报告中对LAT进行分组来发现的用户的LAT百分比。这将估算关闭LAT时的新下载量,而Branch报表会首先从这些下载中打开。

  • 时区。 确保您的Apple Search Ads时区(在“设置>概述>帐户信息”中)与您的“Branch仪表板”时区(在“帐户设置”下可见)匹配。
  • 限制广告跟踪(LAT)。 如果用户启用了“限制广告跟踪”,则Apple Search Ads不会向第三方报告' t安装情况。但是,无论限制广告跟踪状态如何,Apple Search Ads仪表板默认情况下都会显示所有安装。您可以通过在Apple搜索广告报告仪表板中添加这些列来查看“限制广告跟踪打开”和“限制广告跟踪关闭”安装的大致数量。这些安装将不会出现在Branch '的仪表板上。
  • 归因窗口。 Apple Search Ads会将所有安装归因于Apple Search Ads点击其自身30天内。 Branch '的默认单击安装归因窗口为7天。您可以修改Branch '的单击以安装窗口。您可以在“分支”中修改Apple Search Ads归因窗口。
  • 最终点击归因。 Apple Search Ads会将所有安装归因于Apple Search Ads点击其自身30天内。Branch将归因于其归因窗口中的最终点击,而归因窗口通常可能是与Apple Search Ads不同的来源。
  • 重新安装。 Apple Search Ads '仪表板在其默认视图中将重新安装显示为转换,但Branch称这些安装为" REINSTALLS。 "在Apple仪表板中,在列选择器中选择“新建下载”或“重新下载”以对齐数据。
  • 归因API超时或延迟。 Apple Search Ads Attribution API响应速度可能很慢。尽管客户可以编辑超时,但是上面代码中的默认Branch超时仅超过1秒。如果Apple Search Ads在此超时后做出响应,则Branch不会将安装归因于Apple Search Ads。
  • 打开与安装。 Branch认为第一个打开是安装。 Apple Search Ads认为用户下载应用程序的时间为安装时间。这可能会导致计数和安装日期不一致。

向Apple搜索广告添加深度链接接

由于这种整合没有按' Ť的连线利用分公司链接,深度链接接选择是有限的。我们'会传回您使用的值campaign 在苹果搜索广告仪表板。由于此值由您控制,因此您可以在此处放置任何内容,但它将反映在Apple Search Ads仪表板上。我们将定期跟踪安装。

安装或转换事件在Branch仪表板中显示时没有关键字

Apple搜索广告有KeywordSearch Match 匹配来源。搜索匹配功能会自动将您的广告与App Store上的相关用户搜索进行匹配,而不是预先分配的关键词。归因于“搜索匹配”的安装没有与之关联的关键字。可以在Apple Search Ads信息中心的广告组一级启用&搜索禁用。

27 天前更新


Apple Search Ads


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。