どのようにお手伝いできますか?

[旧仕様]OneLink Smart Script V1の設定

  • 更新

概要:OneLink Smart Scriptをセットアップして、あらゆるソースからのモバイルウェブサイト訪問者をモバイルアプリユーザーに変え、属性を付けます。 注:必須ではありませんが、OneLink Smart Script V2 への移行をご検討ください。 

7901_Smart_Script_flow_1920x1080_2__1_.png

設定方法

OneLink Smart Scriptには2つのバージョンがあります。

OneLink Smart Script V2(推奨):OneLink Smart Scriptを初めてセットアップする場合は、このバージョンを使用することをおすすめします。開発者の作業部分がより簡単になり、Google Tag Manager経由で設定することもできます。 注:必須ではありませんが、V2への移行をご検討ください。

OneLink Smart Script V1(旧仕様):すでにOnelink Smart Scriptを設定している場合は、このバージョンのドキュメントを使用して、このスクリプトを保守および編集してください。

作業担当者

作業担当者

  • マーケター: 
    • URL (outgoing) に含めるべき内容を決めます。これにはリンク上に追加する計測データやディープリンクに必要なデータなどが含まれます。Incoming URLを元にデータを引き継ぐか、特定の値を強制的に挿入します。

    • モバイルウェブサイトへ誘導するための全てのキャンペーンに、スクリプトが動作するパラメーターを含むURLが設定されていることを確認します。 
  • ウェブ開発者:
    • スクリプトを初期化するためのデータを設定します。 
    • マーケターから提供された受信URLパラメータに基づいて、送信するOneLink URLを生成するために必要なセッターを入力します。これには、必須およびオプションのパラメータが含まれます。  
    • Webサイトまたは特定ページに、スクリプトを埋め込みます。 

前提条件

Webページにスクリプトを実装する方法:

  1. 自動生成されるOneLink URLに含めるべきパラメーター/値を決めます。使用できるパラメーターの一覧をご参照ください。 
    • URLを持つすべてのキャンペーンがスクリプトが動作するパラメーターを持っていること(と pid と c パラメーターに配置できること)を確認します。 
  2. Webディベロッパーにパラメーターリストを提供します。
  3. ディベロッパーには、Devの手順に従い、正しい送信リンクが生成されるようにスクリプトを実装するように伝えてください。

パラメーター

スマートスクリプトを実装するためにディベロッパーに提供するパラメーター/値

パラメーター/値 備考 レスポンスを記録する (開発者向け)
oneLinkURL (必須)
  • OneLinkテンプレートのドメインと、テンプレートのIDを提供してください。注:OneLinkカスタムリンクURLではありません
  • 例:yourbrand.onelink.me/A1b2
  • ブランドドメイン例:click.yourbrand.com/A1b2
 
pidKeysList (メディアソース)
  • ストアに遷移するURL上でメディアソース (pid) パラメータ―として配置される、メディアソースパラメーターを全てURLに配置します。
  • 例:['af_pid', 'utm_source']
 

pidOverrideList

  • リンク上で変更したいメディアソースに関しては、URL上でメディアソース値を、置き換えたい値と一緒に配置します。
  • 例
    'twitter': 'twitter_int',
    'snapchat': 'snapchat_int',
    'some_social_net': 'some_social_net_int'
    }

 

pidStaticValue

  • フォールバックのメディアソースとして設定したい値を明記します。
  • pidKeysList にメディアソースパラメーターが見つからない場合は、URL内で pidStaticValue がメディアソース (pid) として使用されます。
  • 例: 'website' または 'landing_page'

 

campaignKeysList (キャンペーン)
  • 自動生成されるURL上でキャンペーン (c) パラメーターに置き換えられるURL内のキャンペーンパラメーターを全て配置します。
  • 例:['af_campaign', 'utm_campaign']

 

campaignStaticValue
  • フォールバックのキャンペーンとして設定したい値を明記します。
  • campaignKeysList にキャンペーンパラメーターが見つからない場合は、URL内では campaignStaticValue がキャンペーン (c) として使用されます。
  • 例: 'website' または 'landing_page'

 

gclIdParam
  • GCLID を持つパラメーターの名前を明記します。
    注意!AppsFlyerのローデータに表示するためには、パラメーターは、af_sub[1-5]のいずれかを使用する必要があります。
 
skipList
  • 特定のクリックに対してスマートスクリプトを無効にするHTTPリファラー内の文字列をリストアップしてください。(例:TwitterやFacebookなど)リストアップした文字列が見つかった場合、スマートスクリプトが実行されなくなります。これは、X広告やメタ広告のように、クリック数がすでに報告されているSRNに有効である。
  • SRN媒体であっても、常にスマートスクリプトを実行させたい場合には、空のskiplistを渡すように開発者へ伝えてください。
 
その他のクエリパラメーター
  • 計測、またはディープリンクのために、OneLink URLに含めるその他のパラメーターを配置します。
  • ディープリンク用に deep_link_value を追加します。
    • パラメーターの追加に加えて、マーケティング担当者とディベロッパーは、ディープリンクのロジックをアプリに実装する必要があります。詳細はこちらを参照してください。
  • URLからのパラメーターを使用するか、静的な値を強制的に設定します。
 

使用事例

次のセクションでは、一般的なキャンペーン/メディアソースのシナリオについて、スマートスクリプトの使用事例ご紹介します。

Meta広告:クロスプラットフォームアトリビューション

Facebookは外部の計測リンクを使用しないSRNです。

AppsFlyerは、アプリの初回起動時に、ユーザーが以前(過去28日間)に広告に接触したことがあるかどうかをFacebookに問い合わせます。ユーザーがFacebook広告に接触していた場合、Facebookが自己へアトリビューションを行います。Meta広告はクロスプラットフォームにも対応しています。つまり、ユーザーは、あらゆるプラットフォーム上で、モバイルかどうかに関わらず、あらゆるタイプのキャンペーンと関連付け、Meta広告へアトリビューションできます。

アクション:skipListメソッドを使用して、Meta 広告用のスマートスクリプト(またはその他の任意の文字列)を無効にするように開発者に伝えてください。Meta 広告またはスキップリスト内のいずれかの文字列がクリックのHTTPリファラーに表示されると、スマートスクリプトが返されます。null

 注:注意:2021年にiOS 14ユーザーで想定されているように、ユーザーがデバイスIDの共有をオプトアウトした場合、Facebookのクロスプロモーション計測に影響がある可能性があります。

Google Ads—GCLIDとUTMパラメーター

Google Adsキャンペーン (GCLIDパラメーターを含む) のインストール計測の通常のプロセスでは、クリックがアプリストアのページURLにリダイレクトする必要があります。

このケースでは、Google AdsからのリードをWeb/ランディングページにリダイレクトしているため、スクリプトはGoogle AdsインストールキャンペーンのURLからGCLIDパラメータを取得し、選択した送信パラメータ af_sub[1-5] に付与します。 注意これはインストールキャンペーンにも適用されます。ACIではない検索キャンペーンの場合、つまりリエンゲージメントキャンペーンの場合には、スマートスクリプトによるURLの発行に関係なく、Googleがメディアソースとして成果を紐付けられる場合があります。  

前提条件: Googleダッシュボードで、自動タグ付けを有効にします。
自動タグ付けを有効にし、 URLにGCLIDパラメーターを含めます。

Google Adsのスクリプトを設定するには :

  1. 受信リンクにある、メディアソースとキャンペーンパラメーター名のリストを作成します。
    例:utm_source と utm_campaign
  2. GCLIDを含める送信URLでのパラメーターを選択します。
    ベストプラクティス:af_sub[1-5]を選択すると、AppsFlyerのローデータレポートにデータが表示されます。
  3. パラメーターリストをWebディベロッパーに提供します。

結果:

  • Incomingリンク上のメディアソースとキャンペーンパラメータの値(utm_source と utm_campaign)は、Outgoingリンクのpid と c パラメーターの値を入力するために使用されます。 
  • Outgoing URL上では、GCLID は af_sub[1-5] パラメーターの値です。

Google Adsにこれらのインストールを通知する方法:

  1. CSV経由、またはPush API経由で、インストールごとにリアルタイムでパラメーターaf_sub[1-5]からGCLIDデータを取得します。
  2. 手動またはAdwords API経由で、GoogleにGCLIDデータをアップロードしてください。

 注意

GoogleはこのGCLIDソリューションを公式にサポート及び推奨をしていません。GoogleがGCLIDパラメーターを廃止する場合は、当社が変更をサポートするようにスクリプトを変更します。この記事のヘッダーにあるフォローボタンをクリックしてこの記事をフォローすると、記事またはスクリプトが更新されたときに通知を受け取ることができます。

SRN、オウンドメディア、その他のメディアソースリンク

スナップチャットやX広告のようなSRNは、Google広告やMeta広告のようなクロスプラットフォームとは仕組みが異なります。これらのSRNのキャンペーンでは、ユーザーはウェブページまたはランディングページに誘導され、モバイルユーザーであるかどうかに関わらず、クリック数に基づいて課金されます。 

これらのSRNでは、スクリプトの設定は、オウンドメディアまたは他のメディアソースからのリンクと同じです。 

スクリプトの設定方法:

  1. 受信リンクにある、メディアソースとキャンペーンパラメーター名のリストを作成します。
  2. パラメーターリストをWebディベロッパーに提供します。
    SRNまたはメディアソースタイプは、受信URLのメディアソースの値であり、スクリプトはそれを見つけて、ウェブページまたはランディングページのダウンロードボタンの後ろにある、送信OneLink URLのmedia_sourceの値として使用します。OneLink上のpidを変更したい場合は、pid上書きリストに流入メディアソースの値と置き換えるpid値を提供します。 

結果:結果 :これらの SRN/メディアソースの場合、リンク上のメディアソースおよびキャンペーンパラメーターの値を使用して、OneLink上の pid および c パラメーターの値を設定します。 

 例

流入URL: https://hotel.me/af_pid=twitter&af_c=big_social

OneLink URL: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social

AppsFlyer計測リンク

AppsFlyer計測リンクは、メディアソースがクリックアドネットワークの場合に使用されます。AppsFlyerでリンクを設定する場合、Webキャンペーンからアプリの計測のために、リダイレクトURLパス(af_r)パラメーターを希望のモバイルサイトへのURLパスと一緒に追加するオプションがあります。

結果:結果:af_r と af_redirect=true パラメーターが流入リンクに存在する場合、ランディングページのスクリプトは変化しません。Web/ランディングページ上のアプリストアへの直接リンクはそのまま維持されます。

 例

流入URL: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_redirect=true&af_r=hotel.me

送信URL:同じ

デスクトップ

この記事のほとんどの使用事例は、モバイルデバイスから来るユーザーのものです。そのため、モバイルサイトからアプリストアに誘導されると、すぐにアプリをダウンロードすることができます。

ただし、デスクトップユーザーの場合、デバイス(デスクトップやパソコン)はモバイルアプリのダウンロードに対応していないため、すぐにアプリストアへ誘導されるべきではありません。 

デスクトップユーザー向けのスクリプトの設定方法:

  • OneLinkテンプレートにて、デスクトップでクリックされた場合のリンク先URLを設定します。このURLは、専用ウェブページまたはランディングページにリダイレクトする必要があります。ランディングページには、アプリのダウンロードリンクをSMSやメールで受信するためのフォームを追加することができます。必要に応じて、ウェブフォームを作成し、そのフォームのURLをスクリプトで提供することもできます。 

結果:スクリプトは、ユーザーが使用しているデバイスまたはプラットフォームを検出します。デスクトップの場合は、スクリプトは送信OneLink URLを生成し、ユーザーを専用のウェブページまたはランディングページにリダイレクトします。

詳細はデスクトップからアプリへのコンバージョンをご参照ください。

制限事項

制限事項 備考
タグマネージャー

スマートスクリプトは、タグマネージャーでは実装することができません。Webからアプリへの代替アトリビューションソリューションとして、OneLinkスマートスクリプトV2またはスマートバナーをご覧ください。