__________________________________________________________________________________________________________________
本項の目的 :
- 業種毎に広告主様がコンバージョンに設定している、一般的なメタパラメータをご紹介いたします。
※対象業種
- 小売 (Retail)
- 旅行 (Travel)
- 金融 (Finance)
- 通信 (Telecoms)
__________________________________________________________________________________________________________________
目次
- 概要
- 業種毎によく利用されるメタパラメータ
- 小売 (Retail)
- 旅行 (Travel)
- 金融 (Finance)
- 通信 (Telecoms)
概要
Partnerizeではより柔軟なレポート機能を広告主様にご利用いただけるよう、標準パラメータの他に、広告主様側にて自由に追加設定が可能なメタパラメータ機能を提供しております。
※標準コンバージョンパラメータ
パラメータ名 | 対象 (コンバージョンレベル / アイテムレベル) | 内容 |
conversionref | コンバージョン レベル |
広告主様側の購入/申込IDを設定してください。 通常この値を成果承認/非承認作業に使用します。 もし購入/申込IDの設定ができない場合は、値を空で送信してください。その場合Partnerzeが自動で発行するIDを設定します。 ただし、広告主様側の購入/申込IDを設定できない場合、商品作業や問題が起きた際の調査等が非常に困難となりますのでご注意ください。 |
clickref | コンバージョン レベル |
購入/申込に使用された最新のclickrefの値を設定してください。 ❗注: 可能な限り最新のcickrefを広告主様システムのデータベースに購入/申込情報と紐づけて保存することを推奨しています。何らかの問題が発生した際に修正が容易になる可能性があります。 |
currency | コンバージョン レベル |
購入に使用された通貨コードを設定してください。 通貨コードはISO 4217の3文字の通貨コードに準拠する必要があります。(例: JPY、USD) 購入ではない申込等の金額に関わらない成果計測を行われる場合は設定する必要はありません。 |
country | コンバージョン レベル |
成果が発生したサイト / サービスの国コードを設定してください。国コードはISO 3166の2文字の国コードに準拠する必要があります。(例:JP、US). |
customertype |
コンバージョン レベル |
ユーザーの種別(新規or既存)を判定したい場合に設定してください。「new」または「existing」で設定する必要があります。 |
voucher | コンバージョン レベル |
購入等のアクションで利用されたクーポンコードを設定してください。 ❗重要: クーポンによる割引等がある場合、valueに設定する金額については広告主様側で計算し設定する必要があります。 |
custref | コンバージョン レベル |
購入/申込IDとは別に広告主側でユーザー特定の際に利用されるID等がある場合に設定してください。この項目は管理画面のレポートでピボット項目として使用できます。 |
category | アイテム レベル |
商品/申込のカテゴリーを設定してください。 この項目は管理画面のレポートでピボット項目として使用できます。 |
sku | アイテム レベル | 商品SKUを設定してください。 |
value | アイテム |
商品単価金額を設定してください。 消費税や配送料は除外した金額を設定します。 |
quantity | アイテム |
商品数量を設定してください。 正の整数で設定する必要があります。0やマイナス数値の設定はできません。 |
標準パラメータを利用したコンバージョンURL例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF/clickref:CLICKREF/currency:CURRENCY/country:COUNTRY/customertype:CUSTOMERTYPE/voucher:VOUCHER/custref:CUSTREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY]" height="1" width="2" />
※使用可能文字について
/
,#
,+
,\
,"
の記号はURLエンコードをしていない場合、予期せぬ変換が起こる可能性があります。- スラッシュ ( / ) , コロン ( : ) , 角括弧 ( [ ] ) はPartnerizeシステムにおいて予約後となっており、値として使用しないようにしてください。
- 半角数字とアルファベット以外の文字/記号を使用する場合はURLエンコードを使用するようにしてください。
- 例) 半角スペースはURLエンコードを行うと
%20
となります。conversionref:test 001
をURLエンコードした値はconversionref:test%20001
となります。
- 例) 半角スペースはURLエンコードを行うと
- 金額を設定する
value
パラメータの値は、通過記号と桁区切りのカンマを除外し設定してください。- 例) "$1,980.99" の場合、 "1980.99" と設定してください。
上記の標準パラメータに加えて、広告主様が独自で追加できるメタパラメータを、コンバージョン、及びコンバージョンアイテムレベルで追加することが可能です。メタパラメータを利用することにより、広告主様の販売や申込を最適化するための分析に役立てることが可能です。
以下に4つの業種で主に利用されているメタパラメータ例を記載します。
__________________________________________________________________________________________________________________
❗注:
- 業種別パラメータは1例であり、広告主様にとって必要かつ最適なパラメータを実装してください。
__________________________________________________________________________________________________________________
業種毎によく利用されるメタパラメータ
ここでは以下の代表的な4つの業種でよく使われるメタパラメータを紹介しています。
- 小売 (Retail)
- 旅行 (Travel)
- 金融 (Finance)
- 通信 (Telecoms)
__________________________________________________________________________________________________________________
❗注:
- 以下にはピクセルタグでのURL例を記載していますが、サーバー間通信方式(S2S)をご利用でPOST送信を利用されている場合でも同様にメタパラメータをご利用いただけます。
__________________________________________________________________________________________________________________
小売 (Retail)
メタパラメータ名 |
概要 |
例 |
product_name |
商品名の設定として使用されます。 |
product_name:Nike Air Max 270 |
product_brand |
商品ブランドの設定として使用されます。 |
product_brand:Nike |
product_type |
商品タイプの設定として使用されます。 |
product_type:Trainers |
product_size |
商品サイズの設定として使用されます。 |
product_size:10 |
product_colour |
商品の色の設定として使用されます。 |
product_colour:Black |
product_gender |
商品の対象の性別の設定として使用されます。 |
product_gender:Men |
コンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF/clickref:CLICKREF/currency:CURRENCY/country:COUNTRY/customertype:CUSTOMERTYPE/voucher:VOUCHER/custref:CUSTREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY/product_name:PRODUCT_NAME/product_brand:PRODUCT_BRAND/product_type:PRODUCT_TYPE/product_size:PRODUCT_SIZE/product_colour:PRODUCT_COLOUR/product_gender:PRODUCT_GENDER]" height="1" width="2" />
実際に値が入力された際のコンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:12345/conversionref:D66483/clickref:122eloi888/currency:GBP/country:GB/customertype:new/voucher:10%OFF/custref:C7688949/[category:Shoes/sku:NK9987/value:100.00/quantity:1/product_name:Nike Air Max 270/product_brand:Nike/product_type:Trainers/product_size:10/product_colour:Black/product_gender:Men]" height="1" width="2" />
__________________________________________________________________________________________________________________
旅行 (Travel)
メタパラメータ名 |
概要 |
例 |
check_in_date |
チェックイン日の設定として使用されます。 |
check_in_date:2019-09-17 |
check_out_date |
チェックアウト日の設定として使用されます。 |
check_out_date:2019-09-20 |
hotel_id |
ホテルの識別IDの設定として使用されます。 |
hotel_id:55871 |
hotel_location |
ホテルの所在地の設定として使用されます。 |
hotel_location:London |
refundable |
返金可否の設定として使用されます。 |
refundable:Yes |
number_of_guests |
宿泊人数の設定として使用されます。 |
number_of_guests:2 |
number_of_nights |
宿泊日数の設定として使用されます。 |
number_of_nights:1 |
origin |
搭乗空港の設定として使用されます。 (空港コード等) |
origin:NCL |
dest |
到着空港の設定として使用されます。 (空港コード等) |
dest:AMS |
passengers |
搭乗人数の設定として使用されます。 |
passengers:2 |
haul |
短/長距離便の設定として使用されます。 |
haul:Short+Haul |
return |
片道/往復便の設定として使用されます。 |
return:Yes |
flight_class |
搭乗クラスの設定として使用されます。 (例 エコノミー / ビジネス / ファースト) |
flight_class:Economy |
net_value |
単価金額の設定として使用されます。 注:標準項目のvalueパラメータに単価が設定されない場合や合計金額を報酬設定として使用し、単価金額の登録も行う場合等に使用されています。 |
net_value:150.00 |
コンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF/clickref:CLICKREF/currency:CURRENCY/country:COUNTRY/customertype:CUSTOMERTYPE/voucher:VOUCHER/custref:CUSTREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY/check_in_date:CHECK_IN_DATE/check_out_date:CHECK_OUT_DATE/hotel_id:HOTEL_ID/hotel_location:HOTEL_LOCATION/refundable:REFUNDABLE/number_of_guests:NUMBER_OF_GUESTS/number_of_nights:NUMBER_OF_NIGHTS/origin:ORIGIN/dest:DEST/passengers:PASSENGERS/haul:HAUL/return:RETURN/flight_class:FLIGHT_CLASS/net_value:NET_VALUE]" height="1" width="2" />
実際に値が入力された際のコンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:12345/conversionref:D66483/clickref:122eloi888/currency:GBP/country:GB/customertype:new/voucher:10%OFF/custref:C7688949/[category:Flight/sku:BA/value:700.00/quantity:1/check_in_date:2021-09-17/check_out_date:2021-09-24/hotel_id:4566/hotel_location:Benidorm/refundable:Yes/number_of_guests:4/number_of_nights:7/origin:Newcastle/dest:Alicante/passengers:4/haul:Short Haul/return:Yes/flight_class:Economy/net_value:500.00]" height="1" width="2" />
__________________________________________________________________________________________________________________
金融 (Finance)
メタパラメータ名 |
概要 |
例 |
cover_type |
保険の適用範囲の設定として使用されます。 |
cover_type:Buildings+ Contents |
policy_start_date |
保険適用開始日の設定として使用されます。 |
policy_start_date:2019-09-17 |
policy_end_date |
保険適用終了日の設定として使用されます。 |
policy_end_date:2020-09-17 |
monthly_payment |
月額支払金額の設定として使用されます。 |
monthly_payment:21.57 |
application_status |
申請状況の設定として使用されます。 |
application_status:Approved |
product_name |
保険商品名の設定として使用されます。 |
product_name:Balance Transfer |
credit_limit |
与信限度額の設定として使用されます。 |
credit_limit:5000 |
loan_amount |
ローン金額の設定として使用されます。 |
loan_amount:10000 |
loan_term |
ローン期間の設定として使用されます。 |
loan_term:15 |
コンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF/clickref:CLICKREF/currency:CURRENCY/country:COUNTRY/customertype:CUSTOMERTYPE/voucher:VOUCHER/custref:CUSTREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY/cover_type:COVER_TYPE/policy_start_date:POLICY_START_DATE/policy_end_date:POLICY_END_DATE/monthly_payment:MONTHLY_PAYMENT/application_status:APPLICATION_STATUS/product_name:PRODUCT_NAME/credit_limit:CREDIT_LIMIT/loan_amount:LOAN_AMOUNT/loan_term:LOAN_TERM/]" height="1" width="2" />
実際に値が入力された際のコンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:12345/conversionref:D66483/clickref:122eloi888/currency:GBP/country:GB/customertype:new/voucher:10%OFF/custref:C7688949/[category:Home%20Insurance/sku:/value:298.98/quantity:1/cover_type:Buildings%20&%20Contents/policy_start_date:2021-09-17/policy_end_date:2022-09-16/monthly_payment:32.98/application_status:Approved/product_name:Insurance Gold/credit_limit:/loan_amount:/loan_term:/]" height="1" width="2" />
__________________________________________________________________________________________________________________
通信 (Telecoms)
メタパラメータ名 |
概要 |
例 |
contract_length |
契約期間の設定として使用されます。 |
contract_length:24m |
download_limit |
ダウンロード量上限の設定として使用されます。 |
download_limit:Unlimited |
speed |
通信速度の設定として使用されます。 |
speed:100Mbps |
activation_fee |
初期設定費用等の設定として使用されます。 |
activation_fee:30.00 |
manufacturer |
製造メーカーの設定として使用されます。 |
manufacturer:Samsung |
handset |
ハンドセット購入有無の設定として使用されます。 |
handset:Yes |
minutes |
通話時間上限の設定として使用されます。 |
minutes:Unlimited |
texts |
メッセージ機能利用上限の設定として使用されます。 |
texts:Unlimited |
data |
利用可能なデータ量の設定として使用されます。 |
data:10Mb |
operating_system |
端末OSの設定として使用されます。 |
operating_system:Android |
コンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:XXXXXXX/conversionref:CONVERSIONREF/clickref:CLICKREF/currency:CURRENCY/country:COUNTRY/customertype:CUSTOMERTYPE/voucher:VOUCHER/custref:CUSTREF/[category:CATEGORY/sku:SKU/value:VALUE/quantity:QUANTITY/contract_length:CONTRACT_LENGTH/download_limit:DOWNLOAD_LIMIT/speed:SPEED/activation_fee:ACTIVATION_FEE/manufacturer:MANUFACTURER/handset:HANDSET/minutes:MINUTES/texts:TEXTS/data:DATA/operating_system:OPERATING_SYSTEM/]" height="1" width="2" />
実際に値が入力された際のコンバージョンタグの例:
<img src="https://prf.hn/conversion/campaign:12345/conversionref:D66483/clickref:122eloi888/currency:GBP/country:GB/customertype:new/voucher:10%OFF/custref:C7688949/[category:24mContract Bundle/sku:4455366262/value:300.00/quantity:1/contract_length:24m/download_limit:/speed:/activation_fee:/manufacturer:Samsung/handset:Galaxy S7/minutes:Unlimited/texts:Unlimited/data:10GB/operating_system:Android/]" height="1" width="2" />
__________________________________________________________________________________________________________________