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。

费用数据

Branch为此广告合作伙伴提供以下费用指标:

分析标签 描述 用于
Cost 这些维度(分析代码,用户数据,时间范围)的总费用(支出),与费用模型无关 了解总支出
eCPI 成本/安装 标准化每次安装的支出,以了解整个网络或一段时间内安装的平均价格
eCPC 费用/点击 标准化每次点击支出,以了解整个网络或一段时间内的平均点击价格
eCPM 费用/(展示次数/ 1000) 标准化每千次展示的支出,以了解整个网络或一段时间内1000次展示的平均价格
eCPA 每次购买费用[包括网络和应用购买] 标准化每次购买的支出,以了解跨网络或一段时间内购买的平均价格
Return On Investment (ROI) (收入成本/成本)* 100 得出投资回报率,了解广告支出产生的百分比"利润"
Return On Ad Spend (ROAS) (收入/费用)* 100 通过了解给定支出单位的收入倍数百分比得出投资回报率

成本数据转换

所有成本数据都以当地货币提取,然后使用数据存储当天该货币的汇率在仪表板上转换为USD。实际上,这意味着仪表板会在其运行时显示广告系列费用转换为美元的金额。

费用数据支持

"Next" 按钮不可点击

请确保您'都选择了正确的文件并按下蓝色的上载箭头以完成您的上载。

费用,点击和展示数据未显示

适用于SAN的按维度比较

自我归属网络(SAN)并不总是支持Branch分析中所有可用的维度。使用按尺寸比较时,请参考下表。

Facebook Google Apple Search Ads Snap
Feature 支持的 支持的 Supported 支持的
Channel 不支援 不支援 Unsupported 不支援
Campaign 支持的 支持的 Supported 支持的
Tags 不支援 不支援 Unsupported 不支援
Stage 不支援 不支援 Unsupported 不支援
Ad Partner 支持的 支持的 Supported 支持的
Secondary Publisher 支持的 支持的 Unsupported 不支援
Ad Set Name 支持的 不支援 Supported 支持的
Ad Name 支持的 不支援 Unsupported 支持的
Creative Name 支持的 不支援 Unsupported 不支援
Keyword 不支援 支持的 Supported 不支援
Last Touch Type 不支援 不支援 Unsupported 不支援
Link ID 不支援 不支援 Unsupported 不支援
Country 支持的 不支援 Unsupported 不支援
OS 不支援 不支援 Supported 不支援
Platform 不支援 不支援 Unsupported 不支援

确认您选择了正确的证书:

  • 您是否为正确的帐户创建了证书? 您可以在Apple Search Ads用户界面的右上角切换正在查看的帐户。
  • 您的证书是否具有相关权限? 您的证书必须具有只读权限或更高的权限才能检索Apple Search Ads数据。

还是行不通?尝试下载新证书并将其上载到Branch。

Branch费用数据与广告合作伙伴信息中心不匹配

请确保您'已经选择了相同的时区在你的广告合作伙伴'小号仪表板和你的店的仪表板。

CPI指标与广告合作伙伴和Branch之间的' t不匹配,尽管费用指标

Branch'的最终点击归因模型可能会导致Branch与自分配网络(SAN)的安装计数有所不同,进而导致CPI指标有所不同。验证您的费用和安装指标是否与广告合作伙伴'的信息中心匹配。如果存在安装差异,则这可能是合法的,并且是由于安装计数的差异,其中Branch'的编号更准确。如果差异很大,请通过常规故障排除步骤调查安装差异的原因。

费用,点击和展示数据全部丢失

通常,重新认证合作伙伴并等待24小时会重新启用费用数据。

重新认证时,请仔细检查您是否选择了正确的帐户。我们只会提取您在身份验证过程中选择的帐户的费用数据。

背景:
SAN的成本,点击和印象数据通常来自合作伙伴API(除非有意将分支印象像素或链接用于归因,例如,在Web广告系列中)。启用SAN时,您需要向提供商进行身份验证。 Branch使用此身份验证来检索点击,费用和展示数据。如果身份验证令牌过期(例如,如果您重置密码,或者合作伙伴强制重置了令牌),则可能看不到点击,印象或费用数据。在这种情况下,只需重新认证即可刷新令牌。

某些"compare by" 细分的费用数据缺失或不正确

下游事件(例如安装 )应始终具有仪表板中按选项进行比较的全部范围。但是,SAN的次点击,展示和费用数据通常是通过合作伙伴API导入的。这些API不一定会提供与Branch支持的原始安装事件所涉及的成本数据相同的细分,因此在某些情况下,Branch仪表板无法针对成本数据与安装数据按相同的维度进行比较。

将代理商标签添加到广告系列名称

在为自我归因网络(SAN)创建广告活动时,只有代表客户管理广告活动的代理商必须在活动名称前加Agency ID

需要代理商ID

如果未在广告系列名称后附加Agency ID 则会导致后续的任何转化均未正确归因于负责机构。

查找您的代理ID

您可以在Agency视图中的帐户设置里找到您的代理商ID。

创建您的代理商标签

您的代理商代码必须遵循以下格式:

`agency_{YOUR AGENCY ID HERE}_`

具有代理商标签的示例广告系列

agency_1234567890_My_SAN_Ad_Campaign

您可以将代理商标签附加到广告系列名称的开头结尾

导出时删除了代理商ID

导出/分析中显示的~campaign 值将不包含agency_id。如果您在Facebook中设置了一个名为test_campaign_agency_1234 的广告系列,并且对于来自该广告系列的所有安装,则~campaign 值为test campaign

Apple Search Ads数据已映射到Branch

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

Apple搜索广告参数 Branch映射字段
iad-campaign-name last_attributed_touch_data_tilde_campaign
iad-campaign-id last_attributed_touch_data_tilde_campaign_id
iad-adgroup-name last_attributed_touch_data_tilde_ad_set_name
iad-adgroup-id last_attributed_touch_data_tilde_ad_set_id
iad-keyword last_attributed_touch_data_tilde_keyword

在信息中心上查看归因

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

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

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

更改归因窗口

可以在全局帐户级别或每个链接的基础上指定归因窗口,以链接级别窗口为准。请参阅以下说明进行设置。

帐户级别归因窗口

您可以在“链接设置>归因窗口”下编辑归因窗口。

图像

people-Based Attribution了解有关帐户级别归因窗口的更多信息。

广告网络归因窗口

如果您的广告联盟需要,您可以在广告联盟一级修改归因窗口。当启用诸如Apple Search Ads,Facebook和Google之类的网络(可能具有不同的安装窗口)时,建议这样做。这样一来,您还可以保留帐户级别归因窗口。

图像

整合支援

与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信息中心的广告组一级启用&搜索禁用。

大约一个月前更新

Apple Search Ads


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

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